@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

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

@@ -0,0 +1,740 @@
+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`,ol:`ol`,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/Persisted Records`}),`
+`,(0,c.jsxs)(t.h1,{id:`сохранённые-записи-через-ryuzaki13react-foundation-apipersisted`,children:[`Сохранённые записи через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/persisted`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`persisted`}),` — специализированный слой поверх TanStack Query для данных, которые пользователь сохраняет и позднее восстанавливает: presets, variants, view configs и другие versioned records.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Слово `,(0,c.jsx)(t.code,{children:`persisted`}),` здесь означает backend-сущности «сохранённая запись». Это не то же самое, что persistence TanStack Query cache в IndexedDB.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Persisted record
+  пользователь нажал «Сохранить» → backend хранит вариант/конфигурацию
+
+Persisted Query cache
+  infrastructure сохраняет временный server snapshot между reload
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Backend record остаётся source of truth. Query persistence, если настроена проектом, лишь ускоряет восстановление snapshot.`}),`
+`,(0,c.jsx)(t.h2,{id:`ментальная-модель`,children:`Ментальная модель`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`PersistedResourceDescriptor
+  ├─ identity: namespace + resource + normalized scope
+  ├─ read capability: list | latest | history
+  ├─ write capability: save | create | delete
+  ├─ transport operation: REST | OData | server-fn | custom
+  └─ cache strategy после успешной mutation
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Capability optional: resource не обязан поддерживать все шесть операций. TypeScript разрешит соответствующий hook только когда operation присутствует в descriptor; runtime также выдаёт понятную ошибку при неправильном объекте.`}),`
+`,(0,c.jsx)(t.h3,{id:`термины-для-начинающих`,children:`Термины для начинающих`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`record`}),` — сохранённая запись на backend;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`payload`}),` — полезная конфигурация внутри record, часто JSON string;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`scope`}),` — кому или чему принадлежат records: user, app, table, entity;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`latest`}),` — последний актуальный snapshot;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`history`}),` — версии/события с аргументами paging;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`capability`}),` — реально поддерживаемая operation;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`transport adapter`}),` — как capability выполняет REST/OData/serverFn request;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`descriptor`}),` — единая карта resource, keys, scope policy и capabilities.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-это-не-crud`,children:`Почему это не CRUD`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`save`}),` и `,(0,c.jsx)(t.code,{children:`create`}),` могут иметь разную бизнес-семантику, `,(0,c.jsx)(t.code,{children:`latest`}),` не равен generic `,(0,c.jsx)(t.code,{children:`read(id)`}),`, а `,(0,c.jsx)(t.code,{children:`history`}),` требует paging/filter args. Фиксированные имена отражают распространённую модель versioned user records, но не пытаются описать любую entity.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`persisted-или-resource`,children:[(0,c.jsx)(t.code,{children:`persisted`}),` или `,(0,c.jsx)(t.code,{children:`resource`})]}),`
+`,(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:`Фиксированные сохранённые records: list/latest/history/save/create/delete`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`/persisted`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Произвольные названия и semantics операций`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.a,{href:`../resource/README.mdx`,children:(0,c.jsx)(t.code,{children:`/resource`})})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`persisted`}),` построен на тех же принципах keys/cache, но намеренно не является универсальным CRUD.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте `,(0,c.jsx)(t.code,{children:`/persisted`}),` для обычного server list, который пользователь никогда не сохраняет и не восстанавливает. Для него достаточно entity query или `,(0,c.jsx)(t.code,{children:`/resource`}),`.`]}),`
+`,(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:[`Hooks требуют `,(0,c.jsx)(t.code,{children:`QueryClientProvider`}),`. Descriptor и operations создавайте на module level, чтобы ссылки были стабильными.`]}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	applyPersistedCacheStrategy,
+	composePersistedCacheStrategies,
+	createInvalidatePersistedScopeCacheStrategy,
+	createPersistedJsonCodec,
+	createPersistedODataMutationOperation,
+	createPersistedODataQueryOperation,
+	createPersistedODataReadOperation,
+	createPersistedRecordKeys,
+	createPersistedResourceDescriptor,
+	createPersistedRestMutationOperation,
+	createPersistedRestQueryOperation,
+	createSetPersistedQueryDataCacheStrategy,
+	getPersistedHistoryData,
+	getPersistedLatestData,
+	getPersistedListData,
+	parsePersistedJson,
+	stringifyPersistedJson,
+	usePersistedCreateMutation,
+	usePersistedDeleteMutation,
+	usePersistedHistoryQuery,
+	usePersistedLatestQuery,
+	usePersistedListQuery,
+	usePersistedSaveMutation
+} from "@ryuzaki13/react-foundation-api/persisted";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`пошаговый-rest-пример`,children:`Пошаговый REST пример`}),`
+`,(0,c.jsx)(t.h3,{id:`1-контракты`,children:`1. Контракты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ViewScope = {
+	userId: string;
+	viewId: string;
+};
+
+type ViewConfig = {
+	columns: string[];
+	compact: boolean;
+};
+
+type SavedViewRecord = {
+	id: string;
+	createdUtc: string;
+	payload: string;
+};
+
+type SaveViewInput = {
+	payload: ViewConfig;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Внешний record и распарсенный config — разные типы. TypeScript не проверяет network payload автоматически.`}),`
+`,(0,c.jsx)(t.h3,{id:`2-runtime-parsers`,children:`2. Runtime parsers`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function parseRecord(value: unknown): SavedViewRecord {
+	if (!isSavedViewRecord(value)) {
+		throw new Error("Некорректный SavedViewRecord payload");
+	}
+
+	return value;
+}
+
+function parseRecordList(value: unknown): SavedViewRecord[] {
+	if (!Array.isArray(value)) throw new Error("Ожидался массив records");
+	return value.map(parseRecord);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`3-operations`,children:`3. Operations`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const listOperation = createPersistedRestQueryOperation<
+	ViewScope,
+	void,
+	SavedViewRecord[]
+>({
+	buildUrl: (scope) =>
+		\`/api/users/\${encodeURIComponent(scope.userId)}/views/\${encodeURIComponent(scope.viewId)}\`,
+	parseResponse: parseRecordList,
+	staleTime: 60_000
+});
+
+const latestOperation = createPersistedRestQueryOperation<
+	ViewScope,
+	void,
+	SavedViewRecord,
+	ViewConfig | null
+>({
+	buildUrl: (scope) =>
+		\`/api/users/\${encodeURIComponent(scope.userId)}/views/\${encodeURIComponent(scope.viewId)}/latest\`,
+	parseResponse: parseRecord,
+	transform: (record) => parsePersistedJson<ViewConfig>(record.payload)
+});
+
+const saveOperation = createPersistedRestMutationOperation<
+	ViewScope,
+	SaveViewInput,
+	SavedViewRecord
+>({
+	buildUrl: (scope) =>
+		\`/api/users/\${encodeURIComponent(scope.userId)}/views/\${encodeURIComponent(scope.viewId)}\`,
+	method: "PUT",
+	bodyMapper: (_scope, input) => ({
+		payload: stringifyPersistedJson(input.payload)
+	}),
+	parseResponse: parseRecord,
+	cacheStrategy: createInvalidatePersistedScopeCacheStrategy()
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`4-descriptor`,children:`4. Descriptor`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const viewResource = createPersistedResourceDescriptor({
+	namespace: "view-config",
+	resource: "view",
+	normalizeScope: (scope: ViewScope | null | undefined) => ({
+		userId: scope?.userId.trim() ?? "",
+		viewId: scope?.viewId.trim() ?? ""
+	}),
+	isEnabled: (scope) => Boolean(scope?.userId && scope?.viewId),
+	getScopeError: () => "Не определён пользователь или представление",
+	transport: {
+		list: listOperation,
+		latest: latestOperation,
+		save: saveOperation
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeScope`}),` изменяет только cache identity. В `,(0,c.jsx)(t.code,{children:`buildUrl`}),`/`,(0,c.jsx)(t.code,{children:`execute`}),` передаётся исходный scope.`]}),`
+`,(0,c.jsx)(t.h3,{id:`5-hooks`,children:`5. Hooks`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const scope = { userId, viewId };
+const latestQuery = usePersistedLatestQuery(viewResource, scope);
+const listQuery = usePersistedListQuery(viewResource, scope);
+const saveMutation = usePersistedSaveMutation(viewResource, scope);
+
+saveMutation.mutate({
+	payload: { columns: ["name", "status"], compact: true }
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Нельзя вызвать `,(0,c.jsx)(t.code,{children:`usePersistedHistoryQuery`}),` для этого descriptor, пока capability `,(0,c.jsx)(t.code,{children:`history`}),` не добавлена.`]}),`
+`,(0,c.jsx)(t.h2,{id:`descriptor-подробно`,children:`Descriptor подробно`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface PersistedResourceDescriptor<TScope, TTransport> {
+	namespace: string;
+	resource: string;
+	keys: PersistedRecordKeys<TScope>;
+	transport: TTransport;
+	isEnabled?: (scope: TScope | null | undefined) => boolean;
+	getScopeError?: (scope: TScope | null | undefined) => string | null;
+}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`namespace-и-resource`,children:[(0,c.jsx)(t.code,{children:`namespace`}),` и `,(0,c.jsx)(t.code,{children:`resource`})]}),`
+`,(0,c.jsx)(t.p,{children:`Это техническая стабильная identity:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`namespace: "view-config",
+resource: "table-view"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте локализованные labels, route title, случайный UUID при каждом start или URL endpoint. User id принадлежит scope, а не namespace.`}),`
+`,(0,c.jsx)(t.h3,{id:`transport`,children:(0,c.jsx)(t.code,{children:`transport`})}),`
+`,(0,c.jsx)(t.p,{children:`Это object capabilities:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`transport: {
+	list,
+	latest,
+	history,
+	save,
+	create,
+	delete: deleteOperation
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Подключайте только реально существующие operations. Empty placeholder создаёт ложный public contract.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizescope`,children:(0,c.jsx)(t.code,{children:`normalizeScope`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Normalizer используется при создании `,(0,c.jsx)(t.code,{children:`keys`}),` и меняет только cache identity:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const scope = { userId: " ivanov ", viewId: " main " };
+
+// Key может содержать trimmed values,
+// но execute/buildUrl получает literal scope с пробелами.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если transport требует canonical values, нормализуйте их на request boundary или создавайте canonical scope до вызова descriptor-а.`}),`
+`,(0,c.jsxs)(t.h3,{id:`nullable-scope-требует-isenabled`,children:[`Nullable scope требует `,(0,c.jsx)(t.code,{children:`isEnabled`})]}),`
+`,(0,c.jsx)(t.p,{children:`Критическое правило:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isEnabled: (scope) => Boolean(scope?.userId && scope?.viewId)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если callback отсутствует, default query enabled равен `,(0,c.jsx)(t.code,{children:`true`}),`, даже при `,(0,c.jsx)(t.code,{children:`scope === undefined`}),`. TanStack Query запустит queryFn, а scope assertion выбросит error.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getScopeError`}),` не отключает query. Он только формирует сообщение при actual invalid execution.`]}),`
+`,(0,c.jsx)(t.p,{children:`Standard error:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Недостаточно данных scope для persisted-record ресурса.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`descriptor-создаётся-на-module-boundary`,children:`Descriptor создаётся на module boundary`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`export const viewResource = createPersistedResourceDescriptor(...);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не создавайте descriptor внутри React render. Stable module object упрощает inference, keys, testing и reuse.`}),`
+`,(0,c.jsx)(t.h2,{id:`read-capabilities`,children:`Read capabilities`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Capability`}),(0,c.jsx)(t.th,{children:`Hook`}),(0,c.jsx)(t.th,{children:`Imperative helper`}),(0,c.jsx)(t.th,{children:`Args`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`list`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`usePersistedListQuery`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getPersistedListData`})}),(0,c.jsxs)(t.td,{children:[`нет (`,(0,c.jsx)(t.code,{children:`void`}),`)`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`latest`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`usePersistedLatestQuery`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getPersistedLatestData`})}),(0,c.jsxs)(t.td,{children:[`нет (`,(0,c.jsx)(t.code,{children:`void`}),`)`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`history`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`usePersistedHistoryQuery`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getPersistedHistoryData`})}),(0,c.jsx)(t.td,{children:`обязательный generic args`})]})]})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const page = await getPersistedHistoryData(
+	resourceWithHistory,
+	scope,
+	{ cursor: "next", limit: 20 },
+	queryClient
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Query operation получает `,(0,c.jsx)(t.code,{children:`{ scope, args, client, signal }`}),`. `,(0,c.jsx)(t.code,{children:`isEnabled`}),` operation и descriptor определяют автоматический запуск React observer; `,(0,c.jsx)(t.code,{children:`staleTime`}),`, `,(0,c.jsx)(t.code,{children:`gcTime`}),`, `,(0,c.jsx)(t.code,{children:`meta`}),` переходят в TanStack Query options.`]}),`
+`,(0,c.jsx)(t.h3,{id:`read-lifecycle`,children:`Read lifecycle`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`hook/get helper
+    │
+    ▼
+найти capability в descriptor.transport
+    │ missing
+    ├────────────────► runtime error
+    │ exists
+    ▼
+построить key + enabled + lifetime + meta
+    │
+    ▼
+TanStack Query запускает queryFn
+    │
+    ▼
+assert scope
+    │
+    ▼
+operation.execute({ scope, args, client, signal })
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Missing capability error содержит resource и operation:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Persisted-record ресурс 'view' не поддерживает операцию 'history'.
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`list-и-latest-получают-args-undefined`,children:[(0,c.jsx)(t.code,{children:`list`}),` и `,(0,c.jsx)(t.code,{children:`latest`}),` получают `,(0,c.jsx)(t.code,{children:`args: undefined`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Их operation type — `,(0,c.jsx)(t.code,{children:`PersistedQueryOperation<TScope, void, TResult>`}),`. В query key optional args не добавляется:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`descriptor.keys.list(scope);
+// [...scopeKey, "list"]
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`history-identity`,children:[(0,c.jsx)(t.code,{children:`history`}),` identity`]}),`
+`,(0,c.jsx)(t.p,{children:`Все args, меняющие page/result, должны попасть в call:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`usePersistedHistoryQuery(resource, scope, {
+	cursor: "next-42",
+	limit: 20,
+	includeDeleted: false
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Они нормализуются и добавляются в key. Не прячьте paging/filter во внешнем closure operation-а.`}),`
+`,(0,c.jsx)(t.h3,{id:`disabled-query-и-imperative-fetch`,children:`Disabled query и imperative fetch`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`enabled: false`}),` управляет automatic observer start. При `,(0,c.jsx)(t.code,{children:`queryClient.fetchQuery`}),` query function всё равно защищает scope. Передавайте валидный scope imperative helpers.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`query-meta`,children:[`Query `,(0,c.jsx)(t.code,{children:`meta`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Operation может передать `,(0,c.jsx)(t.code,{children:`QueryMeta`}),`, например marker persistence/diagnostics. Generic layer не интерпретирует meta, только переносит в TanStack options.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Imperative helpers используют `,(0,c.jsx)(t.code,{children:`queryClient.fetchQuery`}),`. Передавайте валидный scope; disabled policy в первую очередь управляет observer, а фактическая query function всё равно проверяет scope.`]}),`
+`,(0,c.jsx)(t.h2,{id:`write-capabilities`,children:`Write capabilities`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Capability`}),(0,c.jsx)(t.th,{children:`Hook`}),(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:`save`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`usePersistedSaveMutation`})}),(0,c.jsx)(t.td,{children:`Сохранить/обновить snapshot`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`create`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`usePersistedCreateMutation`})}),(0,c.jsx)(t.td,{children:`Создать новую именованную запись`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`delete`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`usePersistedDeleteMutation`})}),(0,c.jsx)(t.td,{children:`Удалить запись`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Mutation operation получает `,(0,c.jsx)(t.code,{children:`{ scope, input, client }`}),`. Generic persisted contract не передаёт `,(0,c.jsx)(t.code,{children:`AbortSignal`}),` для mutation.`]}),`
+`,(0,c.jsx)(t.h3,{id:`write-lifecycle`,children:`Write lifecycle`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`usePersistedSave/Create/DeleteMutation
+    │
+    ▼
+assert capability существует
+    │
+    ▼
+mutate(input)
+    │
+    ▼
+assert scope
+    │
+    ▼
+operation.execute({ scope, input, client })
+    │ success
+    ▼
+cache strategy
+    │ await
+    ▼
+hook onSuccess(result, input)
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Mutation key включает operation/scope, но не input. Две save mutations одного scope могут иметь разные inputs, оставаясь одним operation family.`}),`
+`,(0,c.jsxs)(t.p,{children:[`При сохранённом inferred descriptor TypeScript не даст передать resource без `,(0,c.jsx)(t.code,{children:`delete`}),` в delete hook. Runtime всё равно проверяет capability для JS, `,(0,c.jsx)(t.code,{children:`any`}),`, cast и dynamic object.`]}),`
+`,(0,c.jsx)(t.p,{children:`Scope повторно проверяется перед cache strategy. Не мутируйте captured scope object на месте во время request.`}),`
+`,(0,c.jsx)(t.p,{children:`После успешного transport:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`выбирается cache strategy;`}),`
+`,(0,c.jsx)(t.li,{children:`strategy выполняется и awaited;`}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывается optional hook `,(0,c.jsx)(t.code,{children:`onSuccess(result, input)`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`usePersistedSaveMutation(resource, scope, {
+	cacheStrategy: null, // Отключить operation strategy.
+	onSuccess(result) {
+		showSuccess(\`Сохранено \${result.id}\`);
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cacheStrategy: undefined`}),` использует strategy операции; `,(0,c.jsx)(t.code,{children:`null`}),` отключает; объект заменяет исходную strategy. Для дополнения применяйте композицию.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если cache strategy бросила error, server write уже мог завершиться. Не повторяйте write автоматически только ради исправления cache: это может создать duplicate.`}),`
+`,(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 = createPersistedRecordKeys<ViewScope>({
+	namespace: "view-config",
+	resource: "view",
+	normalizeScope: (scope) => ({
+		userId: scope?.userId ?? "",
+		viewId: scope?.viewId ?? ""
+	})
+});
+
+keys.all;
+keys.scope(scope);
+keys.list(scope);
+keys.latest(scope);
+keys.history(scope, { limit: 20 });
+keys.save(scope);
+keys.create(scope);
+keys.delete(scope);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Форма:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`[namespace, resource, normalizedScope, operation, optionalArgs]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используется нормализация `,(0,c.jsx)(t.code,{children:`/resource`}),`: strings trim, object keys сортируются, `,(0,c.jsx)(t.code,{children:`undefined`}),` становится `,(0,c.jsx)(t.code,{children:`null`}),`. Date/Map/cyclic object требуют явного нормализатора.`]}),`
+`,(0,c.jsx)(t.h3,{id:`точные-key-forms`,children:`Точные key forms`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`keys.all;
+// [namespace, resource]
+
+keys.scope(scope);
+// [namespace, resource, normalizedScope]
+
+keys.list(scope);
+// [namespace, resource, normalizedScope, "list"]
+
+keys.latest(scope);
+// [namespace, resource, normalizedScope, "latest"]
+
+keys.history(scope, args);
+// [namespace, resource, normalizedScope, "history", normalizedArgs]
+
+keys.save(scope);
+// [namespace, resource, normalizedScope, "save"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`history(scope, undefined)`}),` не добавляет последний item, а `,(0,c.jsx)(t.code,{children:`history(scope, null)`}),` добавляет `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`prefix-invalidation`,children:`Prefix invalidation`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await queryClient.invalidateQueries({
+	queryKey: descriptor.keys.scope(scope)
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Затрагивает list/latest/history этого scope. Точечный вариант:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await queryClient.invalidateQueries({
+	queryKey: descriptor.keys.latest(scope)
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`специальные-значения-scope`,children:`Специальные значения scope`}),`
+`,(0,c.jsx)(t.p,{children:`Default normalizer не умеет Date/Map/Set. Используйте ISO string:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeScope: (scope) => ({
+	userId: scope?.userId ?? "",
+	periodStart: scope?.periodStart.toISOString() ?? null
+})
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Query keys нельзя использовать для secrets, SAML/CSRF tokens или полного payload config.`}),`
+`,(0,c.jsx)(t.h2,{id:`json-payload-codec`,children:`JSON payload codec`}),`
+`,(0,c.jsx)(t.h3,{id:`parse`,children:`Parse`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parsePersistedJson<ViewConfig>(null); // null.
+parsePersistedJson<ViewConfig>(""); // null.
+parsePersistedJson<ViewConfig>("broken"); // null.
+parsePersistedJson<ViewConfig>('{"compact":true,"columns":[]}');
+// Object, но без runtime validation.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`parsePersistedJson<T>`}),` только вызывает `,(0,c.jsx)(t.code,{children:`JSON.parse`}),` и делает TypeScript cast. Он не проверяет schema. После parse примените domain validator/normalizer на явной restore boundary.`]}),`
+`,(0,c.jsx)(t.h3,{id:`stringify`,children:`Stringify`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const payload = stringifyPersistedJson({ compact: false, columns: [] });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ошибки `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),` пробрасываются. Передавайте только JSON-compatible данные. В частности:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`cyclic object и `,(0,c.jsx)(t.code,{children:`BigInt`}),` приводят к ошибке;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Date`}),` превращается в ISO string;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),` в object-поле удаляется;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`вызов с корневым `,(0,c.jsx)(t.code,{children:`undefined`}),` фактически может вернуть `,(0,c.jsx)(t.code,{children:`undefined`}),`, несмотря на заявленный string contract — не передавайте его.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createPersistedJsonCodec<T>()`}),` возвращает `,(0,c.jsx)(t.code,{children:`{ parse, stringify }`}),` для передачи единым контрактом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`restore-boundary`,children:`Restore boundary`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`backend payload string
+    │ parsePersistedJson
+    ▼
+JS value с compile-time T
+    │ runtime validation
+    ▼
+valid saved model
+    │ explicit normalize/migrate restore boundary
+    ▼
+application state
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не нормализуйте пользовательский draft при каждом keystroke. Serialization/normalization должны происходить на явно названной save/restore boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`повреждённый-json-и-отсутствие-payload-неразличимы`,children:`Повреждённый JSON и отсутствие payload неразличимы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parsePersistedJson(null);       // null
+parsePersistedJson("");         // null
+parsePersistedJson("broken");  // null
+parsePersistedJson("null");    // null
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если product должен различать «не сохранено» и «данные повреждены», используйте strict custom codec/parser с discriminated result или typed error.`}),`
+`,(0,c.jsx)(t.h3,{id:`codec-не-делает-migration`,children:`Codec не делает migration`}),`
+`,(0,c.jsx)(t.p,{children:`Generic type не добавляет version/schema check. Для versioned payload храните version в data и обрабатывайте старые versions в domain restore mapper.`}),`
+`,(0,c.jsx)(t.h2,{id:`rest-adapters`,children:`REST adapters`}),`
+`,(0,c.jsx)(t.h3,{id:`query`,children:`Query`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createPersistedRestQueryOperation`}),` принимает:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`buildUrl(scope, args)`}),` — относительный или абсолютный URL;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`optional `,(0,c.jsx)(t.code,{children:`baseUrl`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`optional `,(0,c.jsx)(t.code,{children:`buildInit(scope, args)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`parseResponse(unknown)`}),` или custom `,(0,c.jsx)(t.code,{children:`executor`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`optional `,(0,c.jsx)(t.code,{children:`transform`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`staleTime`}),`, `,(0,c.jsx)(t.code,{children:`gcTime`}),`, `,(0,c.jsx)(t.code,{children:`isEnabled`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нет ни `,(0,c.jsx)(t.code,{children:`executor`}),`, ни `,(0,c.jsx)(t.code,{children:`parseResponse`}),`, operation бросит `,(0,c.jsx)(t.code,{children:`REST persisted operation requires executor or parseResponse.`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Read signal всегда записывается поверх `,(0,c.jsx)(t.code,{children:`buildInit.signal`}),`, чтобы текущая TanStack Query отменяла именно свой запрос.`]}),`
+`,(0,c.jsx)(t.h3,{id:`rest-read-точная-сборка-request`,children:`REST read: точная сборка request`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	url: buildUrl(scope, args),
+	baseUrl,
+	init: {
+		...buildInit?.(scope, args),
+		signal
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Query signal перезаписывает signal, который мог вернуть `,(0,c.jsx)(t.code,{children:`buildInit`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если custom `,(0,c.jsx)(t.code,{children:`executor`}),` задан, он получает весь request `,(0,c.jsx)(t.code,{children:`{ url, baseUrl, init }`}),`, а `,(0,c.jsx)(t.code,{children:`parseResponse`}),` не вызывается. Executor обязан вернуть `,(0,c.jsx)(t.code,{children:`TResponse`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Без executor используется `,(0,c.jsx)(t.code,{children:`/http`}),` → `,(0,c.jsx)(t.code,{children:`httpFetchPayload`}),` → обязательный `,(0,c.jsx)(t.code,{children:`parseResponse(unknown)`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`rest-read-transform`,children:`REST read transform`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`transform: (record, { scope, args }) => ({
+	id: record.id,
+	config: parseAndValidateConfig(record.payload),
+	owner: scope.userId
+})
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ошибка parser/transform становится query error. Не заменяйте invalid payload пустым config без product decision.`}),`
+`,(0,c.jsx)(t.h3,{id:`mutation`,children:`Mutation`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createPersistedRestMutationOperation`}),` поддерживает method `,(0,c.jsx)(t.code,{children:`POST`}),`, `,(0,c.jsx)(t.code,{children:`PUT`}),`, `,(0,c.jsx)(t.code,{children:`DELETE`}),`.`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`bodyMapper(scope, input)`}),` создаёт JSON body;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`если mapper отсутствует/вернул `,(0,c.jsx)(t.code,{children:`undefined`}),`, body и default Content-Type не задаются;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`иначе body сериализуется и default header равен `,(0,c.jsx)(t.code,{children:`application/json`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`buildInit`}),` применяется после default headers и может полностью заменить headers;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`response обязательно проходит `,(0,c.jsx)(t.code,{children:`parseResponse`}),` или custom executor;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`optional `,(0,c.jsx)(t.code,{children:`transform`}),` строит domain result;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`optional `,(0,c.jsx)(t.code,{children:`cacheStrategy`}),` прикрепляется к operation.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`REST adapter использует нейтральный `,(0,c.jsx)(t.code,{children:`/http`}),`: SAP SSO/X-CSRF policy здесь нет.`]}),`
+`,(0,c.jsx)(t.h3,{id:`rest-mutation-точная-сборка-init`,children:`REST mutation: точная сборка init`}),`
+`,(0,c.jsxs)(t.p,{children:[`Default fields строятся до `,(0,c.jsx)(t.code,{children:`buildInit`}),`, а body — после:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	method,
+	headers: payload === undefined
+		? undefined
+		: { "Content-Type": "application/json" },
+	...buildInit(scope, input),
+	body: payload === undefined
+		? undefined
+		: JSON.stringify(payload)
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Следствия:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`custom `,(0,c.jsx)(t.code,{children:`buildInit.headers`}),` полностью заменяет default Headers object;`]}),`
+`,(0,c.jsx)(t.li,{children:`если нужны custom headers вместе с JSON, добавьте Content-Type сами;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`buildInit`}),` по type не может менять `,(0,c.jsx)(t.code,{children:`method`}),`/`,(0,c.jsx)(t.code,{children:`body`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`bodyMapper`}),` может вернуть `,(0,c.jsx)(t.code,{children:`null`}),`: body станет string `,(0,c.jsx)(t.code,{children:`"null"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`только `,(0,c.jsx)(t.code,{children:`undefined`}),` означает отсутствие body;`]}),`
+`,(0,c.jsx)(t.li,{children:`mutation AbortSignal generic contract не передаёт.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildInit: () => ({
+	headers: {
+		"Content-Type": "application/json",
+		"If-Match": "*"
+	}
+})
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для DELETE body появится только при `,(0,c.jsx)(t.code,{children:`bodyMapper`}),`. Проверьте contract endpoint-а; многие DELETE используют только URL.`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-rest-executor`,children:`Custom REST executor`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const executor = vi.fn(async (request) => {
+	expect(request.url).toBe("/api/views/latest");
+	return savedRecordFixture;
+});
+
+const operation = createPersistedRestQueryOperation({
+	buildUrl: () => "/api/views/latest",
+	executor,
+	transform: (record) => record.payload
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Custom executor полезен для tests/tracing, но не должен содержать business mapping конкретной config.`}),`
+`,(0,c.jsx)(t.h2,{id:`odata-adapters`,children:`OData adapters`}),`
+`,(0,c.jsxs)(t.p,{children:[`OData operations используют metadata-aware transport из `,(0,c.jsx)(t.a,{href:`../odata/README.mdx`,children:(0,c.jsx)(t.code,{children:`/odata`})}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-collection`,children:`Query collection`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const list = createPersistedODataQueryOperation<
+	ViewScope,
+	void,
+	SavedViewRecord[]
+>({
+	odata: { service: "Z_VIEW_CONFIG_SRV", target: "ViewSet" },
+	buildOptions: (scope) => ({
+		expression: createFilterEqual("UserId", scope.userId)
+	}),
+	transform: (rows) => rows
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Доступные options factory: `,(0,c.jsx)(t.code,{children:`odata`}),`, optional `,(0,c.jsx)(t.code,{children:`baseUrl`}),`, `,(0,c.jsx)(t.code,{children:`buildParams`}),`, `,(0,c.jsx)(t.code,{children:`buildOptions`}),`, `,(0,c.jsx)(t.code,{children:`buildInit`}),`, `,(0,c.jsx)(t.code,{children:`transform`}),`, `,(0,c.jsx)(t.code,{children:`executor`}),`, `,(0,c.jsx)(t.code,{children:`staleTime`}),`, `,(0,c.jsx)(t.code,{children:`gcTime`}),`, `,(0,c.jsx)(t.code,{children:`meta`}),`, `,(0,c.jsx)(t.code,{children:`isEnabled`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createPersistedODataQueryOperation`}),` использует semantic method `,(0,c.jsx)(t.code,{children:`query`}),` и возвращает collection response data. `,(0,c.jsx)(t.code,{children:`createPersistedODataReadOperation`}),` использует `,(0,c.jsx)(t.code,{children:`read`}),` для одной entity по key parameters:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const latest = createPersistedODataReadOperation({
+	odata: { service: "Z_VIEW_CONFIG_SRV", target: "ViewSet" },
+	buildParams: (scope: ViewScope) => wrapODataParams({
+		UserId: scope.userId,
+		ViewId: scope.viewId
+	}),
+	transform: (record: SavedViewRecord) =>
+		parsePersistedJson<ViewConfig>(record.payload)
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildParams`}),` должен возвращать wrapped OData parameters из `,(0,c.jsx)(t.code,{children:`foundation-lib/odata-service`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`query-или-read`,children:[(0,c.jsx)(t.code,{children:`query`}),` или `,(0,c.jsx)(t.code,{children:`read`})]}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Factory`}),(0,c.jsx)(t.th,{children:`Semantic operation`}),(0,c.jsx)(t.th,{children:`Target`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createPersistedODataQueryOperation`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`query`})}),(0,c.jsx)(t.td,{children:`collection/plain или parameterized Entity`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createPersistedODataReadOperation`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`read`})}),(0,c.jsx)(t.td,{children:`одна Entity по keys`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Выбор определяется metadata target. Если query возвращает array и transform берёт первый элемент, semantic operation всё равно `,(0,c.jsx)(t.code,{children:`query`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для keyed read `,(0,c.jsx)(t.code,{children:`buildParams`}),` фактически обязателен, даже если structural options допускают отсутствие. Metadata-aware OData layer проверит keys/path.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odata-query-request-assembly`,children:`OData query request assembly`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	odata,
+	params: buildParams?.(scope, args),
+	options: {
+		baseUrl,
+		...buildOptions?.(scope, args)
+	},
+	init: buildInit?.(scope, args)
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildOptions.baseUrl`}),`, если возвращён, перезапишет adapter `,(0,c.jsx)(t.code,{children:`baseUrl`}),`, потому что spread идёт позже. Для ясности задавайте base URL одним способом.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildInit`}),` не может задавать signal/method/body по type. Query signal приходит из generic operation context.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`autoparse-не-включён-adapter-ом`,children:[(0,c.jsx)(t.code,{children:`autoParse`}),` не включён adapter-ом`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Persisted OData factories не имеют option `,(0,c.jsx)(t.code,{children:`autoParse`}),` и не добавляют его во request. Response values остаются transport values.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужны Date/number/boolean domain values, выполните явный transform/validator. Type с `,(0,c.jsx)(t.code,{children:`Date`}),` сам Date не создаёт.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mutation-1`,children:`Mutation`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const save = createPersistedODataMutationOperation({
+	odata: { service: "Z_VIEW_CONFIG_SRV", target: "ViewSet" },
+	method: "update",
+	buildParams: (scope: ViewScope) => wrapODataParams({
+		UserId: scope.userId,
+		ViewId: scope.viewId
+	}),
+	bodyMapper: (_scope, input: SaveViewInput) => ({
+		Payload: stringifyPersistedJson(input.payload)
+	}),
+	cacheStrategy: createInvalidatePersistedScopeCacheStrategy()
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Semantic methods:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Method`}),(0,c.jsx)(t.th,{children:`Params`}),(0,c.jsx)(t.th,{children:`Body`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`create`})}),(0,c.jsx)(t.td,{children:`запрещены`}),(0,c.jsxs)(t.td,{children:[`обязательный `,(0,c.jsx)(t.code,{children:`bodyMapper`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`update`})}),(0,c.jsxs)(t.td,{children:[`обязательный `,(0,c.jsx)(t.code,{children:`buildParams`})]}),(0,c.jsxs)(t.td,{children:[`обязательный `,(0,c.jsx)(t.code,{children:`bodyMapper`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`delete`})}),(0,c.jsxs)(t.td,{children:[`обязательный `,(0,c.jsx)(t.code,{children:`buildParams`})]}),(0,c.jsx)(t.td,{children:`запрещён`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это OData operation names, а не raw HTTP strings. Не передавайте `,(0,c.jsx)(t.code,{children:`"PUT"`}),`/`,(0,c.jsx)(t.code,{children:`"POST"`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`OData adapter наследует metadata validation, SAP cookies, SSO recovery и X-CSRF lifecycle. Query/read получают AbortSignal; mutations — нет в generic contract.`}),`
+`,(0,c.jsx)(t.h3,{id:`odata-mutation-assembly`,children:`OData mutation assembly`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`create`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`body = bodyMapper(scope, input)
+params отсутствуют
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`update`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`params = buildParams(scope, input)
+body = bodyMapper(scope, input)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`delete`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`params = buildParams(scope, input)
+body отсутствует
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildOptions`}),` и `,(0,c.jsx)(t.code,{children:`buildInit`}),` доступны всем трём. Cache strategy получает уже transformed result.`]}),`
+`,(0,c.jsx)(t.h3,{id:`functionimport`,children:`FunctionImport`}),`
+`,(0,c.jsxs)(t.p,{children:[`Persisted OData mutation factory поддерживает только `,(0,c.jsx)(t.code,{children:`create`}),`, `,(0,c.jsx)(t.code,{children:`update`}),`, `,(0,c.jsx)(t.code,{children:`delete`}),`. FunctionImport capability собирайте custom persisted operation/совместимым adapter-ом. Не выдавайте FI за create из-за business verb.`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-odata-executor`,children:`Custom OData executor`}),`
+`,(0,c.jsxs)(t.p,{children:[`Executor получает semantic method, metadata-aware request и `,(0,c.jsx)(t.code,{children:`{ client, signal? }`}),`. Query/read context содержит signal, mutation context — только client.`]}),`
+`,(0,c.jsx)(t.h2,{id:`custom-и-server-function-operations`,children:`Custom и server-function operations`}),`
+`,(0,c.jsxs)(t.p,{children:[`Descriptor принимает любой object, соответствующий `,(0,c.jsx)(t.code,{children:`PersistedQueryOperation`}),`/`,(0,c.jsx)(t.code,{children:`PersistedMutationOperation`}),`. Server-function factories из `,(0,c.jsx)(t.a,{href:`../server-fn/README.mdx`,children:(0,c.jsx)(t.code,{children:`/server-fn`})}),` возвращают совместимые resource operations и могут быть использованы как capabilities, если их generic contract совпадает.`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример custom operation:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const latest: PersistedQueryOperation<ViewScope, void, ViewConfig | null> = {
+	staleTime: 60_000,
+	async execute({ scope, client, signal }) {
+		const record = await customTransport(scope, { client, signal });
+		return restoreViewConfig(record.payload);
+	}
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Business mapper остаётся у владельца ViewConfig, generic package содержит infrastructure contract.`}),`
+`,(0,c.jsx)(t.h2,{id:`cache-strategies`,children:`Cache strategies`}),`
+`,(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 invalidate = createInvalidatePersistedScopeCacheStrategy();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Инвалидирует prefix `,(0,c.jsx)(t.code,{children:`descriptor.keys.scope(scope)`}),`, поэтому затрагивает list/latest/history данного scope.`]}),`
+`,(0,c.jsx)(t.h3,{id:`точечное-обновление`,children:`Точечное обновление`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const setLatest = createSetPersistedQueryDataCacheStrategy({
+	getQueryKey: ({ descriptor, scope }) => descriptor.keys.latest(scope),
+	update: (_current, { result }) => result
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`композиция`,children:`Композиция`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const combined = composePersistedCacheStrategies(setLatest, invalidate);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Порядок последовательный. Если strategy бросила ошибку, следующие steps и hook `,(0,c.jsx)(t.code,{children:`onSuccess`}),` не выполняются, хотя backend mutation уже могла завершиться.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`applyPersistedCacheStrategy`}),` — низкоуровневый helper для ручного вызова optional strategy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`cache-strategy-context`,children:`Cache strategy context`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	client,
+	descriptor,
+	scope,
+	input,
+	result
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точечный update latest:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const updateLatest = createSetPersistedQueryDataCacheStrategy<
+	ViewScope,
+	SaveViewInput,
+	ViewConfig,
+	ViewConfig | null
+>({
+	getQueryKey: ({ descriptor, scope }) => descriptor.keys.latest(scope),
+	update: (_current, { result }) => result
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`почему-invalidation--безопасный-default`,children:`Почему invalidation — безопасный default`}),`
+`,(0,c.jsx)(t.p,{children:`Save может изменить latest, list labels/timestamps, history и server-computed revision. Если result не содержит authoritative формы всех projections, инвалидируйте scope.`}),`
+`,(0,c.jsx)(t.h3,{id:`strategy-order`,children:`Strategy order`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`composePersistedCacheStrategies(updateLatest, invalidateHistory)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`выполняется слева направо и await-ит каждую strategy. `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` entries пропускаются.`]}),`
+`,(0,c.jsx)(t.p,{children:`Updater не должен мутировать current snapshot. Возвращайте новое значение.`}),`
+`,(0,c.jsx)(t.h3,{id:`cache-error-после-write`,children:`Cache error после write`}),`
+`,(0,c.jsx)(t.p,{children:`Server уже мог сохранить record. Cache failure — не доказательство write failure. Восстановите cache/refetch отдельно вместо слепого повторения create/save.`}),`
+`,(0,c.jsx)(t.h2,{id:`полный-end-to-end-сценарий-restoreeditsave`,children:`Полный end-to-end сценарий restore/edit/save`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`1. usePersistedLatestQuery(scope)
+2. transport получает backend record
+3. transform разбирает и валидирует payload
+4. component создаёт независимый draft clone
+5. пользователь меняет literal draft
+6. save mutation сериализует snapshot на save boundary
+7. backend сохраняет record
+8. cache strategy invalidates/updates snapshots
+9. draft отдельно принимает product-specific saved state
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не записывайте normalized saved snapshot обратно в draft автоматически, если продукт должен сохранять literal ввод до explicit save.`}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`keys-и-scope`,children:`Keys и scope`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("строит одинаковый key для эквивалентного scope", () => {
+	const first = viewResource.keys.latest({
+		userId: " ivanov ",
+		viewId: "main"
+	});
+	const second = viewResource.keys.latest({
+		viewId: "main",
+		userId: "ivanov"
+	});
+
+	expect(first).toEqual(second);
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`codec`,children:`Codec`}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверяйте valid object, `,(0,c.jsx)(t.code,{children:`null`}),`, empty string, malformed JSON, version migration и non-serializable value.`]}),`
+`,(0,c.jsx)(t.h3,{id:`rest-request`,children:`REST request`}),`
+`,(0,c.jsx)(t.p,{children:`С custom executor проверяйте URL/base URL, read signal, method, body serialization, headers replacement, parser bypass и transform context.`}),`
+`,(0,c.jsx)(t.h3,{id:`odata-request`,children:`OData request`}),`
+`,(0,c.jsx)(t.p,{children:`С custom executor проверяйте semantic method, wrapped params, body presence/absence, options/baseUrl и context client/signal.`}),`
+`,(0,c.jsx)(t.h3,{id:`descriptor-lifecycle`,children:`Descriptor lifecycle`}),`
+`,(0,c.jsx)(t.p,{children:`Покройте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`отсутствующую capability;`}),`
+`,(0,c.jsxs)(t.li,{children:[`nullable scope с `,(0,c.jsx)(t.code,{children:`isEnabled`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`imperative invalid scope error;`}),`
+`,(0,c.jsx)(t.li,{children:`list/latest keys без args;`}),`
+`,(0,c.jsx)(t.li,{children:`history keys с args;`}),`
+`,(0,c.jsxs)(t.li,{children:[`mutation cache override `,(0,c.jsx)(t.code,{children:`undefined`}),`/`,(0,c.jsx)(t.code,{children:`null`}),`/object;`]}),`
+`,(0,c.jsx)(t.li,{children:`порядок strategy → hook onSuccess;`}),`
+`,(0,c.jsx)(t.li,{children:`strategy error не запускает следующие callbacks;`}),`
+`,(0,c.jsx)(t.li,{children:`transport error не применяет strategy.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`путать-persisted-record-и-persisted-query-cache`,children:`Путать persisted record и persisted Query cache`}),`
+`,(0,c.jsx)(t.p,{children:`Это разные lifecycle и sources of truth.`}),`
+`,(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 будет автоматически запущен и упадёт на scope assertion.`}),`
+`,(0,c.jsx)(t.h3,{id:`использовать-json-codec-как-validator`,children:`Использовать JSON codec как validator`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`JSON.parse`}),` проверяет syntax, но не domain schema.`]}),`
+`,(0,c.jsx)(t.h3,{id:`нормализовать-key-и-ожидать-нормализованный-request-scope`,children:`Нормализовать key и ожидать нормализованный request scope`}),`
+`,(0,c.jsx)(t.p,{children:`Key normalizer не переписывает execute input.`}),`
+`,(0,c.jsx)(t.h3,{id:`скрыть-history-args-во-внешнем-closure`,children:`Скрыть history args во внешнем closure`}),`
+`,(0,c.jsx)(t.p,{children:`Args должны входить в hook/helper call и query key.`}),`
+`,(0,c.jsxs)(t.h3,{id:`потерять-content-type-в-rest-buildinitheaders`,children:[`Потерять Content-Type в REST `,(0,c.jsx)(t.code,{children:`buildInit.headers`})]}),`
+`,(0,c.jsx)(t.p,{children:`Custom headers заменяют default object — добавьте JSON header явно.`}),`
+`,(0,c.jsx)(t.h3,{id:`передать-http-method-в-odata-adapter`,children:`Передать HTTP method в OData adapter`}),`
+`,(0,c.jsxs)(t.p,{children:[`Нужны semantic `,(0,c.jsx)(t.code,{children:`create`}),`/`,(0,c.jsx)(t.code,{children:`update`}),`/`,(0,c.jsx)(t.code,{children:`delete`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидать-autoparse-odata-values`,children:[`Ожидать `,(0,c.jsx)(t.code,{children:`autoParse`}),` OData values`]}),`
+`,(0,c.jsx)(t.p,{children:`Persisted adapter его не включает. Парсите/валидируйте в transform.`}),`
+`,(0,c.jsx)(t.h3,{id:`retry-create-после-cache-error`,children:`Retry create после cache error`}),`
+`,(0,c.jsx)(t.p,{children:`Backend мог уже создать record. Используйте idempotency и отдельное cache recovery.`}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-безопасность`,children:`Ошибки и безопасность`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Scope `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` или rejected `,(0,c.jsx)(t.code,{children:`isEnabled`}),` блокирует query и вызывает ошибку при фактическом execution.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Network payload валидируйте в `,(0,c.jsx)(t.code,{children:`parseResponse`}),`/`,(0,c.jsx)(t.code,{children:`transform`}),`; TypeScript generic не является validator-ом.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не храните secrets в payload/query keys/client persistence.`}),`
+`,(0,c.jsx)(t.li,{children:`Save/create должны быть идемпотентны настолько, насколько это возможно для retry policy.`}),`
+`,(0,c.jsx)(t.li,{children:`Cache update — локальная проекция, backend остаётся source of truth.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`parsePersistedJson`}),` подавляет syntax error и возвращает `,(0,c.jsx)(t.code,{children:`null`}),`; различайте «нет payload» и «повреждён payload» на уровне продукта, если это важно.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`faq`,children:`FAQ`}),`
+`,(0,c.jsx)(t.h3,{id:`обязан-ли-resource-поддерживать-все-capabilities`,children:`Обязан ли resource поддерживать все capabilities?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Подключайте только существующие backend operations.`}),`
+`,(0,c.jsxs)(t.h3,{id:`чем-save-отличается-от-create`,children:[`Чем `,(0,c.jsx)(t.code,{children:`save`}),` отличается от `,(0,c.jsx)(t.code,{children:`create`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Generic layer не навязывает точную semantics. Обычно save обновляет текущий snapshot, create создаёт новую named/versioned запись; contract определяет owner resource.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-другой-payload-format`,children:`Можно ли использовать другой payload format?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Да. `,(0,c.jsx)(t.code,{children:`PersistedPayloadCodec`}),` — interface; JSON helpers лишь convenience.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-получить-data-вне-react-component`,children:`Как получить data вне React component?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Через `,(0,c.jsx)(t.code,{children:`getPersistedListData`}),`, `,(0,c.jsx)(t.code,{children:`getPersistedLatestData`}),`, `,(0,c.jsx)(t.code,{children:`getPersistedHistoryData`}),` с общим QueryClient.`]}),`
+`,(0,c.jsx)(t.h3,{id:`есть-ли-imperative-mutation-helper`,children:`Есть ли imperative mutation helper?`}),`
+`,(0,c.jsx)(t.p,{children:`Public convenience API mutation сейчас hook-oriented. Custom orchestration должна работать через корректную operation/resource boundary и не обходить cache strategy случайно.`}),`
+`,(0,c.jsx)(t.h3,{id:`кто-мигрирует-старую-version-payload`,children:`Кто мигрирует старую version payload?`}),`
+`,(0,c.jsx)(t.p,{children:`Domain restore mapper владельца конфигурации.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-хранить-draft-прямо-в-query-cache`,children:`Можно ли хранить draft прямо в Query cache?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Query cache хранит backend snapshot; editable draft должен быть независимым.`}),`
+`,(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/keys`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createPersistedResourceDescriptor`}),`, `,(0,c.jsx)(t.code,{children:`createPersistedRecordKeys`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`React reads`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`usePersistedListQuery`}),`, `,(0,c.jsx)(t.code,{children:`usePersistedLatestQuery`}),`, `,(0,c.jsx)(t.code,{children:`usePersistedHistoryQuery`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Imperative reads`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`getPersistedListData`}),`, `,(0,c.jsx)(t.code,{children:`getPersistedLatestData`}),`, `,(0,c.jsx)(t.code,{children:`getPersistedHistoryData`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Mutations`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`usePersistedSaveMutation`}),`, `,(0,c.jsx)(t.code,{children:`usePersistedCreateMutation`}),`, `,(0,c.jsx)(t.code,{children:`usePersistedDeleteMutation`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Payload`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`parsePersistedJson`}),`, `,(0,c.jsx)(t.code,{children:`stringifyPersistedJson`}),`, `,(0,c.jsx)(t.code,{children:`createPersistedJsonCodec`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`REST adapters`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createPersistedRestQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`createPersistedRestMutationOperation`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`OData adapters`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createPersistedODataQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`createPersistedODataReadOperation`}),`, `,(0,c.jsx)(t.code,{children:`createPersistedODataMutationOperation`})]})]}),(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:`applyPersistedCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`createInvalidatePersistedScopeCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`createSetPersistedQueryDataCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`composePersistedCacheStrategies`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Names/types`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`PersistedReadOperationName`}),`, `,(0,c.jsx)(t.code,{children:`PersistedWriteOperationName`}),`, `,(0,c.jsx)(t.code,{children:`PersistedOperationName`}),`, `,(0,c.jsx)(t.code,{children:`PersistedPayloadCodec`}),`, `,(0,c.jsx)(t.code,{children:`PersistedRecordKeys`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Operation contracts`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`PersistedQueryOperationContext`}),`, `,(0,c.jsx)(t.code,{children:`PersistedMutationOperationContext`}),`, `,(0,c.jsx)(t.code,{children:`PersistedQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`PersistedMutationOperation`}),`, `,(0,c.jsx)(t.code,{children:`PersistedOperationCapabilities`}),`, `,(0,c.jsx)(t.code,{children:`PersistedTransportAdapter`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Descriptor/cache contracts`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`PersistedResourceDescriptor`}),`, `,(0,c.jsx)(t.code,{children:`CreatePersistedResourceDescriptorOptions`}),`, `,(0,c.jsx)(t.code,{children:`PersistedCacheStrategyContext`}),`, `,(0,c.jsx)(t.code,{children:`PersistedCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`PersistedSetQueryDataStrategyOptions`})]})]})]})]})]})}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};