@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

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

@@ -0,0 +1,3591 @@
+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`,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/OData/OData V2 and SAP Gateway`}),`
+`,(0,c.jsx)(t.h1,{id:`odata-v2-и-sap-gateway`,children:`OData V2 и SAP Gateway`}),`
+`,(0,c.jsxs)(t.p,{children:[`Entrypoint `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),` — основной API-модуль для browser-приложений, работающих с SAP Gateway и OData V2.`]}),`
+`,(0,c.jsx)(t.p,{children:`Он объединяет:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`HTTP transport с SAP headers, cookies, SSO recovery и X-CSRF token;`}),`
+`,(0,c.jsx)(t.li,{children:`разбор стандартного OData V2 JSON envelope;`}),`
+`,(0,c.jsx)(t.li,{children:`metadata-aware операции чтения и записи;`}),`
+`,(0,c.jsx)(t.li,{children:`интеграцию с TanStack Query;`}),`
+`,(0,c.jsxs)(t.li,{children:[`кеширование и обновление `,(0,c.jsx)(t.code,{children:`$metadata`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`загрузку code/text справочников;`}),`
+`,(0,c.jsx)(t.li,{children:`модели зависимых справочников;`}),`
+`,(0,c.jsx)(t.li,{children:`построение и обогащение колонок TanStack Table по metadata.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Документ рассчитан на разработчика, который не видит исходники пакета и только начинает работать с JavaScript, TypeScript, React, TanStack Query и OData.`}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D1%82%D0%BE-%D0%B4%D0%B5%D0%BB%D0%B0%D0%B5%D1%82-%D0%B8-%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B5-%D0%B4%D0%B5%D0%BB%D0%B0%D0%B5%D1%82-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8C`,children:`Что делает и чего не делает модуль`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B7%D0%B0%D0%B2%D0%B8%D1%81%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D0%B8-%D0%B8-%D1%81%D1%80%D0%B5%D0%B4%D0%B0-%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F`,children:`Зависимости и среда выполнения`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#odata-v2-%D0%BF%D1%80%D0%BE%D1%81%D1%82%D1%8B%D0%BC%D0%B8-%D1%81%D0%BB%D0%BE%D0%B2%D0%B0%D0%BC%D0%B8`,children:`OData V2 простыми словами`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C-%D1%83%D1%80%D0%BE%D0%B2%D0%B5%D0%BD%D1%8C-api`,children:`Как выбрать уровень API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B1%D1%89%D0%B8%D0%B9-%D0%BC%D0%B0%D1%80%D1%88%D1%80%D1%83%D1%82-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0`,children:`Общий маршрут запроса`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B8%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-project-adapter`,children:`Инициализация project adapter`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#base-url-%D0%B8-url-helpers`,children:`Base URL и URL helpers`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B8%D0%B7%D0%BA%D0%BE%D1%83%D1%80%D0%BE%D0%B2%D0%BD%D0%B5%D0%B2%D1%8B%D0%B9-sap-transport`,children:`Низкоуровневый SAP transport`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#odata-v2-json-envelope`,children:`OData V2 JSON envelope`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BD%D0%B8%D0%B7%D0%BA%D0%BE%D1%83%D1%80%D0%BE%D0%B2%D0%BD%D0%B5%D0%B2%D1%8B%D0%B9-odatafetch`,children:[`Низкоуровневый `,(0,c.jsx)(t.code,{children:`odataFetch`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#metadata-aware-operation-helpers`,children:`Metadata-aware operation helpers`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#odataqueryfn-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B8-%D0%B8-parameterized-query`,children:[(0,c.jsx)(t.code,{children:`odataQueryFn`}),`: списки и parameterized query`]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#odatareadfn-%D0%BE%D0%B4%D0%BD%D0%B0-entity`,children:[(0,c.jsx)(t.code,{children:`odataReadFn`}),`: одна entity`]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#odatacreatefn-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5`,children:[(0,c.jsx)(t.code,{children:`odataCreateFn`}),`: создание`]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#odataupdatefn-%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5`,children:[(0,c.jsx)(t.code,{children:`odataUpdateFn`}),`: обновление`]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#odatadeletefn-%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5`,children:[(0,c.jsx)(t.code,{children:`odataDeleteFn`}),`: удаление`]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#odatafunctionimportfn-functionimport`,children:[(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),`: FunctionImport`]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#autoparse-%D0%B8-transform`,children:[(0,c.jsx)(t.code,{children:`autoParse`}),` и `,(0,c.jsx)(t.code,{children:`transform`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#tanstack-query-%D1%87%D1%82%D0%B5%D0%BD%D0%B8%D0%B5`,children:`TanStack Query: чтение`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#tanstack-query-mutations-%D0%B8-cache`,children:`TanStack Query: mutations и cache`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#dev-dry-run-helpers`,children:`DEV dry-run helpers`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#metadata-api`,children:`Metadata API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#entity-metadata-helpers`,children:`Entity metadata helpers`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#odata-collections`,children:`OData collections`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#collection-version-check-%D0%B8-service-worker-cache`,children:`Collection version-check и Service Worker cache`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#collection-model-%D0%B4%D0%BB%D1%8F-ui`,children:`Collection model для UI`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B7%D0%B0%D0%B2%D0%B8%D1%81%D0%B8%D0%BC%D1%8B%D0%B5-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA%D0%B8-%D0%B8-segments`,children:`Зависимые справочники и segments`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#odata-metadata-%D0%B8-tanstack-table`,children:`OData metadata и TanStack Table`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#sso-lifecycle`,children:`SSO lifecycle`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#x-csrf-lifecycle`,children:`X-CSRF lifecycle`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D0%B5%D1%82%D1%8B%D1%80%D0%B5-%D1%80%D0%B0%D0%B7%D0%BD%D1%8B%D1%85-%D0%BA%D0%B5%D1%88%D0%B0`,children:`Четыре разных кеша`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D0%B8-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F`,children:`Безопасность и ограничения`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#browser-ssr-%D0%B8-workers`,children:`Browser, SSR и workers`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-consumer-%D0%BA%D0%BE%D0%B4%D0%B0`,children:`Тестирование consumer-кода`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#deprecated-api`,children:`Deprecated API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D0%B0%D1%8F-%D0%BA%D0%B0%D1%80%D1%82%D0%B0-%D0%BF%D1%83%D0%B1%D0%BB%D0%B8%D1%87%D0%BD%D0%BE%D0%B3%D0%BE-api`,children:`Полная карта публичного API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B`,children:`Частые вопросы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D0%B2%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D1%8B%D0%B5-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D0%B8`,children:`Связанные модули`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`что-делает-и-чего-не-делает-модуль`,children:`Что делает и чего не делает модуль`}),`
+`,(0,c.jsx)(t.h3,{id:`делает`,children:`Делает`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Выполняет запросы к SAP Gateway и OData V2 endpoint.`}),`
+`,(0,c.jsx)(t.li,{children:`Добавляет общие SAP headers.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Отправляет cookies через `,(0,c.jsx)(t.code,{children:`credentials: "include"`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Определяет SAP client.`}),`
+`,(0,c.jsx)(t.li,{children:`Получает, кеширует и обновляет X-CSRF token для write-запросов.`}),`
+`,(0,c.jsx)(t.li,{children:`Распознаёт SSO redirect и SAML form.`}),`
+`,(0,c.jsx)(t.li,{children:`Пытается восстановить SSO session в скрытом iframe.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Разбирает OData V2 envelope `,(0,c.jsx)(t.code,{children:`{ d: ... }`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Извлекает `,(0,c.jsx)(t.code,{children:`__count`}),` как `,(0,c.jsx)(t.code,{children:`totalCount`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Загружает и кеширует `,(0,c.jsx)(t.code,{children:`$metadata`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Проверяет, является target Entity или FunctionImport.`}),`
+`,(0,c.jsx)(t.li,{children:`Строит path операции по metadata.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Может преобразовать OData values по metadata через `,(0,c.jsx)(t.code,{children:`autoParse`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Передаёт `,(0,c.jsx)(t.code,{children:`AbortSignal`}),` из TanStack Query в read-запрос.`]}),`
+`,(0,c.jsx)(t.li,{children:`Даёт hooks для metadata, справочников и table columns.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`не-делает`,children:`Не делает`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Не определяет бизнес-правила приложения.`}),`
+`,(0,c.jsx)(t.li,{children:`Не знает, что такое «заказ», «вариант», «отчёт» или другой domain object.`}),`
+`,(0,c.jsx)(t.li,{children:`Не проверяет authorization вместо SAP backend.`}),`
+`,(0,c.jsx)(t.li,{children:`Не превращает TypeScript generic в runtime validation.`}),`
+`,(0,c.jsx)(t.li,{children:`Не строит query key конкретной entity автоматически.`}),`
+`,(0,c.jsx)(t.li,{children:`Не выбирает cache strategy после mutation автоматически.`}),`
+`,(0,c.jsx)(t.li,{children:`Не хранит backend state в Zustand или React state.`}),`
+`,(0,c.jsx)(t.li,{children:`Не заменяет TanStack Query.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Не делает Service Worker cache только из-за наличия `,(0,c.jsx)(t.code,{children:`swCache`}),`: header должен понимать Service Worker host-приложения.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не гарантирует SSR-совместимость SSO recovery.`}),`
+`,(0,c.jsx)(t.li,{children:`Не экспортирует внутренние файлы как отдельные package subpath.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Граница ответственности выглядит так:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`React component / route loader
+             │
+             ▼
+entity или feature API приложения
+             │
+             ▼
+TanStack Query + stable query key
+             │
+             ▼
+@ryuzaki13/react-foundation-api/odata
+             │
+             ├── metadata
+             ├── URL и OData envelope
+             ├── SSO и X-CSRF
+             └── browser fetch
+             │
+             ▼
+SAP Gateway
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`DTO-to-domain mapping конкретной entity остаётся в приложении. Pure builders для metadata, parameters, `,(0,c.jsx)(t.code,{children:`$filter`}),` и `,(0,c.jsx)(t.code,{children:`$orderby`}),` находятся в `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(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:[`Для `,(0,c.jsx)(t.code,{children:`useODataTableColumns`}),` также нужен совместимый `,(0,c.jsx)(t.code,{children:`@tanstack/react-table`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Пакет не имеет корневого entrypoint. Правильный импорт:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	odataQueryFn,
+	odataReadFn,
+	useODataMetadataQuery
+} from "@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неправильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Корневой entrypoint не опубликован.
+import { odataQueryFn } from "@ryuzaki13/react-foundation-api";
+
+// Внутренний файл не является public contract.
+import { odataFetchFn } from "@ryuzaki13/react-foundation-api/dist/odata/odataFetchFn";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Pure OData builders импортируются отдельно из `,(0,c.jsx)(t.code,{children:`foundation-lib`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	createFilterEqual,
+	createFilterBetween,
+	wrapODataParams
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`import-type`,children:(0,c.jsx)(t.code,{children:`import type`})}),`
+`,(0,c.jsxs)(t.p,{children:[`TypeScript-типы лучше импортировать через `,(0,c.jsx)(t.code,{children:`import type`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type {
+	ODataCollectionConfig,
+	ODataFetchFnRequest,
+	ODataFetchOptions,
+	ODataProjectAdapter
+} from "@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`import type`}),` удаляется из JavaScript bundle и показывает читателю, что значение не вызывается в runtime.`]}),`
+`,(0,c.jsx)(t.h2,{id:`зависимости-и-среда-выполнения`,children:`Зависимости и среда выполнения`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Возможность`}),(0,c.jsx)(t.th,{children:`Что требуется`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`odataFetch`}),`, `,(0,c.jsx)(t.code,{children:`fetchBase`}),`, `,(0,c.jsx)(t.code,{children:`fetchODataJson`})]}),(0,c.jsxs)(t.td,{children:[`Web Fetch API: `,(0,c.jsx)(t.code,{children:`fetch`}),`, `,(0,c.jsx)(t.code,{children:`Request`}),`, `,(0,c.jsx)(t.code,{children:`Response`}),`, `,(0,c.jsx)(t.code,{children:`Headers`}),`, `,(0,c.jsx)(t.code,{children:`URLSearchParams`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Metadata-aware operations`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@tanstack/react-query`}),` и `,(0,c.jsx)(t.code,{children:`QueryClient`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`React hooks`}),(0,c.jsxs)(t.td,{children:[`React и `,(0,c.jsx)(t.code,{children:`QueryClientProvider`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`SSO recovery`}),(0,c.jsxs)(t.td,{children:[`Browser `,(0,c.jsx)(t.code,{children:`window`}),`, `,(0,c.jsx)(t.code,{children:`document`}),`, iframe и form submission`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Metadata XML parsing`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`DOMParser`}),` через `,(0,c.jsx)(t.code,{children:`foundation-lib/odata-service`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Table adapter`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@tanstack/react-table`}),` и `,(0,c.jsx)(t.code,{children:`foundation-lib/table`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Основная среда модуля — браузерное SPA-приложение.`}),`
+`,(0,c.jsxs)(t.p,{children:[`В современном Node.js есть `,(0,c.jsx)(t.code,{children:`fetch`}),`, но это не делает весь entrypoint server-safe: automatic SSO recovery использует DOM, а relative SAP paths, cookies и compile-time project constants обычно рассчитаны на browser/proxy окружение.`]}),`
+`,(0,c.jsx)(t.h2,{id:`odata-v2-простыми-словами`,children:`OData V2 простыми словами`}),`
+`,(0,c.jsx)(t.h3,{id:`service`,children:`Service`}),`
+`,(0,c.jsx)(t.p,{children:`OData service — набор endpoint, metadata и операций, опубликованных backend-ом.`}),`
+`,(0,c.jsx)(t.p,{children:`Пример имени service:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Z_SALES_ORDER_SRV
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обычный SAP Gateway base path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap/opu/odata/sap/Z_SALES_ORDER_SRV
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В конфигурации operation имя service передаётся без base path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const odata = {
+	service: "Z_SALES_ORDER_SRV",
+	target: "SalesOrderSet"
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`metadata`,children:`Metadata`}),`
+`,(0,c.jsx)(t.p,{children:`Metadata — XML-документ, описывающий service:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_SALES_ORDER_SRV/$metadata
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Из metadata библиотека узнаёт:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`какие Entity и FunctionImport существуют;`}),`
+`,(0,c.jsx)(t.li,{children:`какие параметры обязательны;`}),`
+`,(0,c.jsx)(t.li,{children:`какие OData types имеют поля;`}),`
+`,(0,c.jsx)(t.li,{children:`какой suffix результата использует parameterized entity;`}),`
+`,(0,c.jsx)(t.li,{children:`какой HTTP method объявлен у FunctionImport;`}),`
+`,(0,c.jsx)(t.li,{children:`какие code/text связи заданы SAP annotations.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata не содержит фактические rows и не доказывает, что каждый response корректен.`}),`
+`,(0,c.jsx)(t.h3,{id:`entity-и-entityset`,children:`Entity и EntitySet`}),`
+`,(0,c.jsx)(t.p,{children:`Entity — описание одной записи. EntitySet — endpoint коллекции записей.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`GET /Z_SALES_ORDER_SRV/SalesOrderSet
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ответ может содержать несколько заказов.`}),`
+`,(0,c.jsx)(t.p,{children:`Чтение одной entity по key:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`GET /Z_SALES_ORDER_SRV/SalesOrderSet(OrderId='42')
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В API пакета collection/query читает `,(0,c.jsx)(t.code,{children:`odataQueryFn`}),`, одну entity — `,(0,c.jsx)(t.code,{children:`odataReadFn`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`parameterized-query-entity`,children:`Parameterized query entity`}),`
+`,(0,c.jsx)(t.p,{children:`Некоторые SAP services публикуют query entity с parameters и отдельным result suffix:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`GET /Z_REPORT_SRV/SalesReport(
+  CompanyId='1000',
+  DateFrom=datetime'2026-01-01T00:00:00'
+)/Results
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Metadata entity содержит поле `,(0,c.jsx)(t.code,{children:`result`}),`, например `,(0,c.jsx)(t.code,{children:`Results`}),` или `,(0,c.jsx)(t.code,{children:`Set`}),`. Для такого target нужен `,(0,c.jsx)(t.code,{children:`odataQueryFn`}),`, а не `,(0,c.jsx)(t.code,{children:`odataReadFn`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`functionimport`,children:`FunctionImport`}),`
+`,(0,c.jsx)(t.p,{children:`FunctionImport — отдельная операция, описанная в metadata:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`POST /Z_SALES_ORDER_SRV/CloseOrder?OrderId='42'
+`})}),`
+`,(0,c.jsx)(t.p,{children:`HTTP method берётся из metadata. FunctionImport может быть read-like или write-like по бизнес-смыслу, поэтому helper выбирают по типу metadata target, а не только по глаголу feature.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для FunctionImport используется `,(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`target`,children:`Target`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`target`}),` — точное имя Entity/EntitySet-like target или FunctionImport внутри service metadata:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	service: "Z_SALES_ORDER_SRV",
+	target: "SalesOrderSet"
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Target не является URL. Metadata-aware helper сам строит path.`}),`
+`,(0,c.jsx)(t.h3,{id:`target-params-и-query-options--разные-вещи`,children:`Target params и query options — разные вещи`}),`
+`,(0,c.jsx)(t.p,{children:`Это один из самых важных разделов.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`params`}),` адресуют target или FunctionImport:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`SalesOrderSet(OrderId='42')
+SalesReport(CompanyId='1000')/Results
+CloseOrder?OrderId='42'
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`options`}),` управляют выборкой:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`$filter
+$orderby
+$select
+$expand
+$top
+$skip
+$inlinecount
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сравнение:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Значение`}),(0,c.jsx)(t.th,{children:`Куда попадает`}),(0,c.jsx)(t.th,{children:`Чем строить`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Key entity`}),(0,c.jsxs)(t.td,{children:[`В `,(0,c.jsx)(t.code,{children:`(Key=...)`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`params`}),` + `,(0,c.jsx)(t.code,{children:`wrapODataParams`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Parameterized entity parameter`}),(0,c.jsxs)(t.td,{children:[`В `,(0,c.jsx)(t.code,{children:`(Param=...)`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`params`}),` + `,(0,c.jsx)(t.code,{children:`wrapODataParams`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`FunctionImport parameter`}),(0,c.jsx)(t.td,{children:`В query string самой функции`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`params`}),` + `,(0,c.jsx)(t.code,{children:`wrapODataParams`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Filter rows`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`$filter`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`options.expression`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Sorting`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`$orderby`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`options.sorts`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Paging`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`$top`}),`, `,(0,c.jsx)(t.code,{children:`$skip`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`options.top`}),`, `,(0,c.jsx)(t.code,{children:`options.skip`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Projection`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`$select`}),`, `,(0,c.jsx)(t.code,{children:`$expand`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`options.select`}),`, `,(0,c.jsx)(t.code,{children:`options.expand`})]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нельзя переносить key в `,(0,c.jsx)(t.code,{children:`$filter`}),`, если backend contract ожидает key path. Нельзя передавать `,(0,c.jsx)(t.code,{children:`$top`}),` как target parameter.`]}),`
+`,(0,c.jsx)(t.h3,{id:`body`,children:`Body`}),`
+`,(0,c.jsx)(t.p,{children:`Body используется только для entity create/update:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	body: {
+		OrderId: "42",
+		Title: "Новый заказ"
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper сериализует body через `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odata-v2-envelope`,children:`OData V2 envelope`}),`
+`,(0,c.jsx)(t.p,{children:`SAP Gateway часто возвращает JSON не как обычный array, а в envelope:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{
+	"d": {
+		"results": [
+			{ "OrderId": "42", "Title": "Заказ" }
+		],
+		"__count": "1"
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchODataJson`}),` превращает его в:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	data: [{ OrderId: "42", Title: "Заказ" }],
+	totalCount: 1
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Metadata-aware runner возвращает тот же внешний result shape:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataRunnerResult<T> = {
+	data: T;
+	totalCount?: number;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не забывайте `,(0,c.jsx)(t.code,{children:`.data`}),` при использовании результата.`]}),`
+`,(0,c.jsx)(t.h3,{id:`queryclient`,children:`QueryClient`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`QueryClient`}),` — объект TanStack Query, который хранит query cache и передаёт runtime context запросам.`]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata-aware helper возвращает не Promise результата, а runner:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataQueryFn<unknown>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	}
+});
+
+const result = await runner({ client: queryClient });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Почему два вызова:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`odataQueryFn(options)`}),` создаёт настроенную функцию.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Эта функция получает текущий `,(0,c.jsx)(t.code,{children:`QueryClient`}),` и optional `,(0,c.jsx)(t.code,{children:`AbortSignal`}),` в момент выполнения.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`useQuery`}),` второй вызов делает TanStack Query автоматически.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-уровень-api`,children:`Как выбрать уровень API`}),`
+`,(0,c.jsx)(t.p,{children:`Entrypoint содержит несколько уровней. Начинайте с самого высокого подходящего уровня.`}),`
+`,(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:`API`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Обычный list/query Entity`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataQueryFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Одна Entity по key`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataReadFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Создание Entity`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataCreateFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Обновление Entity`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataUpdateFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Удаление Entity`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataDeleteFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`FunctionImport`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFunctionImportFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Metadata service/entity`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useODataMetadataQuery`}),`, `,(0,c.jsx)(t.code,{children:`useODataMetadata`}),`, `,(0,c.jsx)(t.code,{children:`getODataMetadataData`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Code/text справочник`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useODataCollectionQuery`}),`, `,(0,c.jsx)(t.code,{children:`useODataCollection`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Table columns по metadata`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataTableColumns`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Уже известный raw OData path без metadata orchestration`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFetch`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Нужен raw `,(0,c.jsx)(t.code,{children:`Response`}),` и SAP policy`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchBase`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Правило:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`specialized helper подходит? ── да ──► используйте его
+             │
+             нет
+             ▼
+нужен готовый OData path? ───── да ──► odataFetch
+             │
+             нет
+             ▼
+нужен raw Response? ─────────── да ──► fetchBase / fetchQueryFn
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchBase`}),` и `,(0,c.jsx)(t.code,{children:`odataFetch`}),` — infrastructure primitives. Они требуют от consumer больше знаний и дают меньше metadata guarantees.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.h3,{id:`1-создать-singleton-queryclient`,children:`1. Создать singleton QueryClient`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { QueryClientProvider } from "@tanstack/react-query";
+import { createQueryClient } from "@ryuzaki13/react-foundation-lib/query-client";
+
+const queryClient = createQueryClient();
+
+export function App() {
+	return (
+		<QueryClientProvider client={queryClient}>
+			<AppRoutes />
+		</QueryClientProvider>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не создавайте `,(0,c.jsx)(t.code,{children:`QueryClient`}),` внутри component render:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function App() {
+	// Неверно: новый client и новый cache на каждый render.
+	const queryClient = new QueryClient();
+	return <QueryClientProvider client={queryClient}>...</QueryClientProvider>;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`2-описать-dto-и-domain-model`,children:`2. Описать DTO и domain model`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SalesOrderDto = {
+	CompanyId: string;
+	OrderId: string;
+	Title: string;
+	Amount: number;
+	CreatedAt: Date;
+};
+
+type SalesOrder = {
+	id: string;
+	title: string;
+	amount: number;
+	createdAt: Date;
+};
+
+function mapSalesOrder(dto: SalesOrderDto): SalesOrder {
+	return {
+		id: dto.OrderId,
+		title: dto.Title,
+		amount: dto.Amount,
+		createdAt: dto.CreatedAt
+	};
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`DTO повторяет внешний SAP contract. Domain model использует имена приложения.`}),`
+`,(0,c.jsx)(t.h3,{id:`3-создать-stable-query-options`,children:`3. Создать stable query options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { queryOptions } from "@tanstack/react-query";
+
+import { odataQueryFn } from "@ryuzaki13/react-foundation-api/odata";
+import { createFilterEqual } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+type SalesOrderListParams = {
+	companyId: string;
+	limit: number;
+};
+
+const salesOrderKeys = {
+	all: ["sales-orders"] as const,
+	list: (params: SalesOrderListParams) =>
+		[...salesOrderKeys.all, "list", params] as const
+};
+
+export function salesOrderListQueryOptions(params: SalesOrderListParams) {
+	const normalized = {
+		companyId: params.companyId.trim(),
+		limit: params.limit
+	};
+
+	return queryOptions({
+		queryKey: salesOrderKeys.list(normalized),
+		queryFn: odataQueryFn<SalesOrderDto, SalesOrder>({
+			odata: {
+				service: "Z_SALES_ORDER_SRV",
+				target: "SalesOrderSet"
+			},
+			options: {
+				expression: createFilterEqual<SalesOrderDto, string>(
+					"CompanyId",
+					normalized.companyId
+				),
+				top: normalized.limit,
+				inlinecount: "allpages"
+			},
+			autoParse: true,
+			transform: (rows) => rows.map(mapSalesOrder)
+		})
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Filter key полностью типизирован:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilterEqual<SalesOrderDto, string>("CompanyId", normalized.companyId);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`4-использовать-query-в-component`,children:`4. Использовать query в component`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useQuery } from "@tanstack/react-query";
+
+export function SalesOrderList({ companyId }: { companyId: string }) {
+	const query = useQuery(
+		salesOrderListQueryOptions({
+			companyId,
+			limit: 50
+		})
+	);
+
+	if (query.isPending) {
+		return <p>Загрузка заказов…</p>;
+	}
+
+	if (query.isError) {
+		return <p>Не удалось загрузить заказы</p>;
+	}
+
+	return (
+		<ul>
+			{query.data.data.map((order) => (
+				<li key={order.id}>{order.title}</li>
+			))}
+		</ul>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обратите внимание:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`query.data`}),` — result runner-а;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`query.data.data`}),` — массив domain objects;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`query.data.totalCount`}),` — optional полное количество rows;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`backend state не копируется в `,(0,c.jsx)(t.code,{children:`useState`}),` или Zustand.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`общий-маршрут-запроса`,children:`Общий маршрут запроса`}),`
+`,(0,c.jsx)(t.p,{children:`Metadata-aware read проходит этапы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`1. Consumer создаёт operation options
+                    │
+                    ▼
+2. TanStack Query вызывает runner({ client, signal })
+                    │
+                    ▼
+3. getODataMetadataData загружает/читает metadata
+                    │
+                    ▼
+4. Находится target Entity или FunctionImport
+                    │
+                    ▼
+5. Проверяется совместимость operation
+                    │
+                    ▼
+6. Строится target path и query options
+                    │
+                    ▼
+7. fetchBase добавляет SAP/SSO/X-CSRF policy
+                    │
+                    ▼
+8. fetchODataJson снимает OData envelope
+                    │
+                    ▼
+9. autoParse преобразует известные metadata fields
+                    │
+                    ▼
+10. transform строит result consumer-а
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Write проходит те же этапы, но дополнительно получает X-CSRF token и использует HTTP method операции.`}),`
+`,(0,c.jsx)(t.h2,{id:`инициализация-project-adapter`,children:`Инициализация project adapter`}),`
+`,(0,c.jsx)(t.p,{children:`Project adapter задаёт настройки, которые нельзя надёжно определить внутри универсального пакета.`}),`
+`,(0,c.jsx)(t.p,{children:`Настройте его один раз до первого OData запроса:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { configureODataProjectAdapter } from "@ryuzaki13/react-foundation-api/odata";
+
+configureODataProjectAdapter({
+	devDp0Service: "Z_SPECIAL_REPORT_SRV",
+	resolveSapClient: () => appConfig.sapClient,
+	metadataVersion: {
+		service: "Z_TECHNICAL_SRV",
+		target: "MetadataVersionSet"
+	},
+	collectionUpdates: {
+		service: "Z_TECHNICAL_SRV",
+		target: "CollectionUpdatesSet"
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Типы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataProjectTechnicalEndpoint = {
+	service: string;
+	target: string;
+	baseUrl?: BaseURLType;
+};
+
+type ODataProjectAdapter = {
+	devDp0Service?: string;
+	resolveSapClient?: () => string | null | undefined;
+	metadataVersion?: ODataProjectTechnicalEndpoint;
+	collectionUpdates?: ODataProjectTechnicalEndpoint;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`devdp0service`,children:(0,c.jsx)(t.code,{children:`devDp0Service`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В dev/preview только указанный service автоматически получает base URL `,(0,c.jsx)(t.code,{children:`odataDp0`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveODataBaseUrl("Z_SPECIAL_REPORT_SRV");
+// dev/preview: "odataDp0".
+// production: "odata".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сравнение выполняется после `,(0,c.jsx)(t.code,{children:`normalizeODataServiceName`}),`, поэтому suffix после `,(0,c.jsx)(t.code,{children:`;`}),` не влияет:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeODataServiceName("Z_SPECIAL_REPORT_SRV;v=2");
+// "Z_SPECIAL_REPORT_SRV".
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`resolvesapclient`,children:(0,c.jsx)(t.code,{children:`resolveSapClient`})}),`
+`,(0,c.jsx)(t.p,{children:`Callback возвращает SAP client в runtime:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveSapClient: () => "300"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если callback отсутствует или вернул `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),`, production transport не добавляет `,(0,c.jsx)(t.code,{children:`sap-client`}),` из adapter-а.`]}),`
+`,(0,c.jsx)(t.p,{children:`В dev/preview часть client policy задаётся compile-time project constants и выбранным proxy.`}),`
+`,(0,c.jsx)(t.h3,{id:`metadataversion`,children:(0,c.jsx)(t.code,{children:`metadataVersion`})}),`
+`,(0,c.jsx)(t.p,{children:`Optional technical endpoint сообщает, когда service metadata были сгенерированы последний раз. Он позволяет хранить metadata долго и обновлять только после реального изменения.`}),`
+`,(0,c.jsx)(t.p,{children:`Если endpoint не настроен, metadata всё равно загружаются и работают; automatic version-check просто отключён.`}),`
+`,(0,c.jsx)(t.h3,{id:`collectionupdates`,children:(0,c.jsx)(t.code,{children:`collectionUpdates`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Optional technical endpoint сообщает, какие справочники изменились за последнее окно. Он нужен для безопасного `,(0,c.jsx)(t.code,{children:`ttl=forever`}),` справочников.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если endpoint отсутствует, query обновлений возвращает пустой успешный result без network request.`}),`
+`,(0,c.jsx)(t.h3,{id:`глобальное-состояние-adapter-а`,children:`Глобальное состояние adapter-а`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const adapter = getODataProjectAdapter();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`configureODataProjectAdapter(next)`}),` полностью заменяет текущий object, а не merge-ит его:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureODataProjectAdapter({ resolveSapClient });
+configureODataProjectAdapter({ metadataVersion });
+
+// resolveSapClient уже потерян.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правильнее собрать единый object и вызвать конфигурацию один раз.`}),`
+`,(0,c.jsx)(t.p,{children:`Для test cleanup можно вернуть пустой adapter:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`afterEach(() => {
+	configureODataProjectAdapter({});
+});
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`base-url-и-url-helpers`,children:`Base URL и URL helpers`}),`
+`,(0,c.jsx)(t.h3,{id:`baseurltype`,children:(0,c.jsx)(t.code,{children:`BaseURLType`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type BaseURLType = "odata" | "odataDp0" | "odataUi2" | "config" | "";
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Type`}),(0,c.jsx)(t.th,{children:`Назначение`}),(0,c.jsx)(t.th,{children:`Base path`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odata`})}),(0,c.jsx)(t.td,{children:`Основные SAP OData services`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`/sap/opu/odata/sap`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataDp0`})}),(0,c.jsx)(t.td,{children:`Выбранный dev/preview DP0 proxy`}),(0,c.jsxs)(t.td,{children:[`dev/preview `,(0,c.jsx)(t.code,{children:`/sap-dp0/opu/odata/sap`}),`, production обычный OData path`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataUi2`})}),(0,c.jsx)(t.td,{children:`SAP UI2 services`}),(0,c.jsxs)(t.td,{children:[`dev/preview proxy или `,(0,c.jsx)(t.code,{children:`/sap/opu/odata/UI2`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`config`})}),(0,c.jsx)(t.td,{children:`Project configuration endpoint`}),(0,c.jsxs)(t.td,{children:[`compile-time `,(0,c.jsx)(t.code,{children:`__BASE_APP_CONFIG_URL__`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`""`})}),(0,c.jsx)(t.td,{children:`Не добавлять base path`}),(0,c.jsx)(t.td,{children:`пустая строка`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Экспортированные constants:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`BaseODataURL;
+BaseODataDp0URL;
+BaseODataUI2URL;
+BaseAppConfigURL;
+BaseUrlMap;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`BaseUrlMap`}),` readonly:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`BaseUrlMap.odata;
+// "/sap/opu/odata/sap".
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не изменяйте его в consumer-коде.`}),`
+`,(0,c.jsx)(t.h3,{id:`resolveodatabaseurl`,children:(0,c.jsx)(t.code,{children:`resolveODataBaseUrl`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveODataBaseUrl(service, explicitBaseUrl?);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Порядок:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`В dev/preview проверяется `,(0,c.jsx)(t.code,{children:`devDp0Service`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если service совпал, возвращается `,(0,c.jsx)(t.code,{children:`odataDp0`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Иначе используется explicit `,(0,c.jsx)(t.code,{children:`baseUrl`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если explicit value нет, используется `,(0,c.jsx)(t.code,{children:`odata`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Следствие: dev DP0 routing имеет приоритет над explicit base URL для совпавшего service.`}),`
+`,(0,c.jsx)(t.h3,{id:`resolveodatasapclient`,children:(0,c.jsx)(t.code,{children:`resolveODataSapClient`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sapClient = resolveODataSapClient();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает значение project adapter callback или `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`getinputurl`,children:(0,c.jsx)(t.code,{children:`getInputUrl`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getInputUrl("/sap/example");
+// "/sap/example".
+
+getInputUrl(new Request("https://example.test/sap/example"));
+// "https://example.test/sap/example".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поддерживает string, `,(0,c.jsx)(t.code,{children:`Request`}),` и остальные `,(0,c.jsx)(t.code,{children:`RequestInfo`}),` через `,(0,c.jsx)(t.code,{children:`toString()`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizerelativepath`,children:(0,c.jsx)(t.code,{children:`normalizeRelativePath`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeRelativePath("sap/example?x=1#hash");
+// "/sap/example".
+
+normalizeRelativePath("");
+// "/".
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`удаляет query string;`}),`
+`,(0,c.jsx)(t.li,{children:`удаляет hash;`}),`
+`,(0,c.jsxs)(t.li,{children:[`добавляет начальный `,(0,c.jsx)(t.code,{children:`/`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не нормализует повторные slash;`}),`
+`,(0,c.jsx)(t.li,{children:`не декодирует URL;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не удаляет SAP suffix `,(0,c.jsx)(t.code,{children:`;o=...`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`низкоуровневый-sap-transport`,children:`Низкоуровневый SAP transport`}),`
+`,(0,c.jsx)(t.h3,{id:`fetchbase`,children:(0,c.jsx)(t.code,{children:`fetchBase`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function fetchBase(
+	input: RequestInfo,
+	init: RequestInitType = {},
+	baseUrlType: BaseURLType = "odata"
+): Promise<Response>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример raw XML:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = await fetchBase(
+	"/Z_SALES_ORDER_SRV/$metadata",
+	{
+		method: "GET",
+		headers: {
+			Accept: "application/xml"
+		}
+	},
+	"odata"
+);
+
+const xml = await response.text();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchBase`}),` возвращает raw `,(0,c.jsx)(t.code,{children:`Response`}),`. Body ещё не распарсен.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-определяется-sap-request`,children:`Как определяется SAP request`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`baseUrlType`}),` не пустой, request считается SAP request.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При `,(0,c.jsx)(t.code,{children:`baseUrlType: ""`}),` request считается SAP только когда normalized path начинается с:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap/
+/sap-dp0/
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это влияет на:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`sap-contextid-accept`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`sap-client`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`X-CSRF;`}),`
+`,(0,c.jsx)(t.li,{children:`manual redirect;`}),`
+`,(0,c.jsx)(t.li,{children:`SSO recovery.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`headers-по-умолчанию`,children:`Headers по умолчанию`}),`
+`,(0,c.jsx)(t.p,{children:`Для всех requests:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sap-language: ru
+Accept: application/json      если consumer не передал Accept
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для SAP requests:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sap-contextid-accept: header
+sap-client: <resolved client> если client доступен
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для write с body:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Content-Type: application/json если consumer не задал Content-Type
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для SAP write:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`x-csrf-token: <token>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Consumer headers сохраняются, кроме headers, которые transport намеренно устанавливает по своей policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`cookies-и-redirects`,children:`Cookies и redirects`}),`
+`,(0,c.jsxs)(t.p,{children:[`Фактический `,(0,c.jsx)(t.code,{children:`fetch`}),` всегда получает:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	credentials: "include"
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для SAP request также используется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	redirect: "manual"
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Manual redirect нужен, чтобы browser не ушёл автоматически на ADFS/SSO page до того, как transport распознает истёкшую session.`}),`
+`,(0,c.jsx)(t.h3,{id:`get-без-body`,children:`GET без body`}),`
+`,(0,c.jsxs)(t.p,{children:[`Transport не добавляет `,(0,c.jsx)(t.code,{children:`Content-Type`}),` для GET без body:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await fetchJson("/Filters?cfo-count", {}, "config");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ожидаемые headers включают `,(0,c.jsx)(t.code,{children:`Accept`}),`, но не `,(0,c.jsx)(t.code,{children:`Content-Type`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`requestinittype`,children:(0,c.jsx)(t.code,{children:`RequestInitType`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RequestInitType = RequestInit & {
+	retried?: boolean;
+	ssoRetried?: boolean;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`retried`}),` и `,(0,c.jsx)(t.code,{children:`ssoRetried`}),` — internal lifecycle flags. Не используйте их как прикладные options: consumer может случайно отключить защитный retry.`]}),`
+`,(0,c.jsx)(t.h3,{id:`successful-response`,children:`Successful response`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`response.ok === true`}),`, `,(0,c.jsx)(t.code,{children:`fetchBase`}),` возвращает `,(0,c.jsx)(t.code,{children:`Response`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`http-error`,children:`HTTP error`}),`
+`,(0,c.jsx)(t.p,{children:`Если status неуспешный, transport пытается построить полезное сообщение.`}),`
+`,(0,c.jsx)(t.p,{children:`Для SAP JSON:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{
+	"error": {
+		"code": "SY/530",
+		"message": {
+			"value": "Необходимо указать запрос на перенос!"
+		}
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Error: SY/530 | Необходимо указать запрос на перенос!
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Рассматриваются unique значения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error`}),` как string;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error.code`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error.message.value`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error.message`}),` как string;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`top-level `,(0,c.jsx)(t.code,{children:`details`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`top-level `,(0,c.jsx)(t.code,{children:`message`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Вложенный `,(0,c.jsx)(t.code,{children:`innererror.errordetails`}),` сейчас не добавляется в message.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для text error непустой text становится message. Иначе используется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`HTTP error: <status> <statusText>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Network/CORS/abort errors глобального `,(0,c.jsx)(t.code,{children:`fetch`}),` пробрасываются без замены.`]}),`
+`,(0,c.jsx)(t.h3,{id:`fetcherrorreportcontext`,children:(0,c.jsx)(t.code,{children:`FetchErrorReportContext`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FetchErrorReportContext = {
+	input: RequestInfo;
+	init: RequestInitType;
+	baseUrlType: BaseURLType;
+	sapClient: string | null;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это public type технического контекста error reporting. Обычный consumer редко создаёт его вручную.`}),`
+`,(0,c.jsx)(t.h2,{id:`odata-v2-json-envelope`,children:`OData V2 JSON envelope`}),`
+`,(0,c.jsx)(t.h3,{id:`fetchodatajson`,children:(0,c.jsx)(t.code,{children:`fetchODataJson`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function fetchODataJson<T = unknown>(
+	input: RequestInfo,
+	init: RequestInitType = {},
+	baseUrlType: BaseURLType = "odata"
+): Promise<{
+	data: T;
+	totalCount?: number;
+}>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = await fetchODataJson<SalesOrderDto[]>(
+	"/Z_SALES_ORDER_SRV/SalesOrderSet?$inlinecount=allpages",
+	{ signal },
+	"odata"
+);
+
+console.log(response.data);
+console.log(response.totalCount);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Перед отправкой добавляются:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`DataServiceVersion: 2.0
+MaxDataServiceVersion: 2.0
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Остальные SAP headers и SSO/X-CSRF lifecycle выполняет `,(0,c.jsx)(t.code,{children:`fetchBase`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`collection-envelope`,children:`Collection envelope`}),`
+`,(0,c.jsx)(t.p,{children:`Server:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{
+	"d": {
+		"results": [
+			{
+				"__metadata": { "uri": "..." },
+				"OrderId": "42"
+			}
+		],
+		"__count": "125"
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Client result:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	data: [{ OrderId: "42" }],
+	totalCount: 125
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`d.results`}),` должен быть array;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`каждый top-level record получает shallow copy без `,(0,c.jsx)(t.code,{children:`__metadata`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`d.__count`}),` преобразуется через `,(0,c.jsx)(t.code,{children:`Number`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`отсутствие `,(0,c.jsx)(t.code,{children:`__count`}),` даёт `,(0,c.jsx)(t.code,{children:`totalCount: undefined`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`вложенные records не очищаются рекурсивно.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`__count`}),` содержит некорректную строку, результатом может быть `,(0,c.jsx)(t.code,{children:`NaN`}),`. Backend contract и consumer validation должны исключать это.`]}),`
+`,(0,c.jsx)(t.h3,{id:`single-envelope`,children:`Single envelope`}),`
+`,(0,c.jsx)(t.p,{children:`Server:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{
+	"d": {
+		"__metadata": { "uri": "..." },
+		"OrderId": "42"
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Client:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	data: { OrderId: "42" }
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`raw-json-fallback`,children:`Raw JSON fallback`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если payload не содержит `,(0,c.jsx)(t.code,{children:`d`}),`, transport возвращает JSON как есть:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{ "ok": true }
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{ data: { ok: true } }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это позволяет использовать transport с SAP endpoint, который не оборачивает ответ в стандартный OData envelope.`}),`
+`,(0,c.jsx)(t.h3,{id:`content-type`,children:`Content-Type`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`Content-Type`}),` содержит:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`application/json
+application/odata+json
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`используется `,(0,c.jsx)(t.code,{children:`response.json()`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если header другой, body сначала читается как text. Затем:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`HTML проверяется на SSO form.`}),`
+`,(0,c.jsx)(t.li,{children:`Неожиданный HTML превращается в transport error report и Error.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Остальной text пробуется через `,(0,c.jsx)(t.code,{children:`JSON.parse`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Если JSON parse невозможен, бросается ошибка unsupported content/body.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому JSON с ошибочным `,(0,c.jsx)(t.code,{children:`Content-Type: text/plain`}),` всё ещё может быть разобран.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`204-и-205`,children:[(0,c.jsx)(t.code,{children:`204`}),` и `,(0,c.jsx)(t.code,{children:`205`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для response без body transport возвращает специальный marker в `,(0,c.jsx)(t.code,{children:`data`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Проверка:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = await fetchODataJson<unknown>(url, init);
+
+if (isNoContentResponse(response.data)) {
+	return;
+}
+
+// Здесь response.data не является no-content marker.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверяйте `,(0,c.jsx)(t.code,{children:`response.data`}),`, не весь `,(0,c.jsx)(t.code,{children:`response`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверно.
+isNoContentResponse(response);
+
+// Правильно.
+isNoContentResponse(response.data);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`fetchjson`,children:(0,c.jsx)(t.code,{children:`fetchJson`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function fetchJson<T = unknown>(
+	input: RequestInfo,
+	init: RequestInitType = {},
+	baseUrlType: BaseURLType = "odata"
+): Promise<T>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это короткая форма:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = await fetchODataJson<T>(input, init, baseUrlType);
+return response.data;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const orders = await fetchJson<SalesOrderDto[]>(
+	"/Z_SALES_ORDER_SRV/SalesOrderSet"
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ограничения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`totalCount`}),` теряется;`]}),`
+`,(0,c.jsx)(t.li,{children:`no-content marker типизируется как переданный generic;`}),`
+`,(0,c.jsx)(t.li,{children:`generic не проверяет payload;`}),`
+`,(0,c.jsx)(t.li,{children:`metadata target не проверяется.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужен paging count, используйте `,(0,c.jsx)(t.code,{children:`fetchODataJson`}),`, `,(0,c.jsx)(t.code,{children:`odataFetch`}),` или metadata-aware runner.`]}),`
+`,(0,c.jsx)(t.h3,{id:`fetchqueryfn`,children:(0,c.jsx)(t.code,{children:`fetchQueryFn`})}),`
+`,(0,c.jsx)(t.p,{children:`Factory создаёт функцию для TanStack Query или ручного вызова:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const loadMetadataXml = fetchQueryFn("/Z_SALES_ORDER_SRV/$metadata", {
+	baseUrl: "odata",
+	init: {
+		headers: {
+			Accept: "application/xml"
+		}
+	},
+	transform: async (response) => response.text()
+});
+
+const xml = await loadMetadataXml({ signal });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Options:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	init?: RequestInit;
+	baseUrl?: BaseURLType;
+	swCache?: string;
+	transform: (data: Response) => Promise<R>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поведение signal:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`options.init.signal есть? ── да ──► используется он
+              │
+              нет
+              ▼
+params.signal есть? ─────── да ──► используется текущий signal
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для каждого запуска создаётся новый shallow `,(0,c.jsx)(t.code,{children:`RequestInit`}),`, поэтому отменённый signal предыдущего refetch не сохраняется в следующем запуске.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`transform`}),` отсутствует в runtime из-за unsafe cast/JavaScript, функция бросит:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`fetchQueryFn requires a transformation function!
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`swCache`}),` добавляет header `,(0,c.jsx)(t.code,{children:`x-sw-cache`}),`; сам transport не реализует Service Worker cache.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`низкоуровневый-odatafetch`,children:[`Низкоуровневый `,(0,c.jsx)(t.code,{children:`odataFetch`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function odataFetch<T, I = T>(
+	entitySetPath: string,
+	options: ODataFetchOptions<T> = {},
+	init: RequestInit = {}
+): Promise<{
+	data: I;
+	totalCount?: number;
+}>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Здесь:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`T`}),` типизирует field names в filter/sort/select/expand;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`I`}),` описывает ожидаемый result `,(0,c.jsx)(t.code,{children:`data`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`entitySetPath`}),` уже должен быть готовым OData path;`]}),`
+`,(0,c.jsx)(t.li,{children:`metadata автоматически не загружаются.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`полный-пример`,children:`Полный пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SalesOrderRow = {
+	CompanyId: string;
+	OrderId: string;
+	Title: string;
+	Amount: string;
+	CreatedAt: string;
+	Customer: CustomerDto;
+};
+
+const response = await odataFetch<SalesOrderRow, SalesOrderRow[]>(
+	"/Z_SALES_ORDER_SRV/SalesOrderSet",
+	{
+		expression: createFilterEqual<SalesOrderRow, string>(
+			"CompanyId",
+			"1000"
+		),
+		sorts: [
+			{ key: "CreatedAt", desc: true },
+			{ key: "OrderId" }
+		],
+		select: ["OrderId", "Title", "Amount", "CreatedAt"],
+		expand: ["Customer"],
+		top: 50,
+		skip: 0,
+		inlinecount: "allpages",
+		baseUrl: "odata",
+		swCache: "off"
+	},
+	{ signal }
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Условно будет построен path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_SALES_ORDER_SRV/SalesOrderSet
+  ?$filter=CompanyId eq '1000'
+  &$orderby=CreatedAt desc,OrderId asc
+  &$select=OrderId,Title,Amount,CreatedAt
+  &$expand=Customer
+  &$top=50
+  &$skip=0
+  &$inlinecount=allpages
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`URLSearchParams`}),` кодирует query string. В фактическом URL `,(0,c.jsx)(t.code,{children:`$`}),` может отображаться как `,(0,c.jsx)(t.code,{children:`%24`}),`, пробел — как `,(0,c.jsx)(t.code,{children:`+`}),` или percent encoding. Это нормально.`]}),`
+`,(0,c.jsx)(t.h3,{id:`expression`,children:(0,c.jsx)(t.code,{children:`expression`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expression?: FilterExpression<T>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте filter factories `,(0,c.jsx)(t.code,{children:`foundation-lib/odata-service`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const expression = {
+	and: true,
+	filters: [
+		createFilterEqual<SalesOrderRow, string>("CompanyId", "1000"),
+		createFilterBetween<SalesOrderRow, Date>("CreatedAt", [dateFrom, dateTo])
+	]
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не собирайте `,(0,c.jsx)(t.code,{children:`$filter`}),` ручной конкатенацией:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"// Небезопасно и легко сломать quoting/escaping.\nconst filter = `CompanyId eq '${userInput}'`;\n"})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildODataFilter`}),` вызывается внутри `,(0,c.jsx)(t.code,{children:`odataFetch`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`sorts`,children:(0,c.jsx)(t.code,{children:`sorts`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`sorts?: Sort<keyof T>[];
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`sorts: [
+	{ key: "CreatedAt", desc: true },
+	{ key: "OrderId" }
+]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`desc`}),` имеет literal type `,(0,c.jsx)(t.code,{children:`true`}),`. Ascending задаётся отсутствием поля:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{ key: "OrderId" } // asc.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не передавайте `,(0,c.jsx)(t.code,{children:`{ desc: false }`}),`, если точный TypeScript type это запрещает.`]}),`
+`,(0,c.jsx)(t.h3,{id:`select`,children:(0,c.jsx)(t.code,{children:`select`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`select?: (keyof T)[];
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`select: ["OrderId", "Title"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Values соединяются через запятую. Runtime metadata validation имён не выполняется.`}),`
+`,(0,c.jsx)(t.p,{children:`Пустой array создаст пустое значение option. Лучше вообще не передавать поле:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`select: selectedFields.length ? selectedFields : undefined
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`expand`,children:(0,c.jsx)(t.code,{children:`expand`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expand?: (keyof T)[];
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expand: ["Customer"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper только соединяет имена через запятую. Он не проверяет, является поле navigation property, и не делает deep `,(0,c.jsx)(t.code,{children:`$select`}),` syntax.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`top-и-skip`,children:[(0,c.jsx)(t.code,{children:`top`}),` и `,(0,c.jsx)(t.code,{children:`skip`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`top?: number;
+skip?: number;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`0`}),` не отбрасывается:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{ top: 50, skip: 0 }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper не запрещает отрицательные, дробные, `,(0,c.jsx)(t.code,{children:`NaN`}),` и слишком большие values. Нормализуйте paging на application boundary.`]}),`
+`,(0,c.jsx)(t.h3,{id:`inlinecount`,children:(0,c.jsx)(t.code,{children:`inlinecount`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`inlinecount?: string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип намеренно широкий. Для OData V2 paging обычно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`inlinecount: "allpages"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При корректном SAP response `,(0,c.jsx)(t.code,{children:`d.__count`}),` станет `,(0,c.jsx)(t.code,{children:`totalCount`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`format`,children:(0,c.jsx)(t.code,{children:`format`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`format?: "json";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поле существует в public type, но текущий request builder не добавляет `,(0,c.jsx)(t.code,{children:`$format`}),` в URL. Не полагайтесь на него. JSON transport определяется headers и response parser-ом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`baseurl`,children:(0,c.jsx)(t.code,{children:`baseUrl`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`baseUrl?: BaseURLType;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Передаётся в `,(0,c.jsx)(t.code,{children:`fetchODataJson`}),`. Если отсутствует, transport использует `,(0,c.jsx)(t.code,{children:`odata`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`swcache`,children:(0,c.jsx)(t.code,{children:`swCache`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`swCache?: string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если value truthy, request получает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`x-sw-cache: <value>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`init.headers`}),` уже содержит `,(0,c.jsx)(t.code,{children:`x-sw-cache`}),`, option его перезапишет.`]}),`
+`,(0,c.jsx)(t.h3,{id:`existing-query-string`,children:`Existing query string`}),`
+`,(0,c.jsx)(t.p,{children:`Можно передать path с query:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await odataFetch("/Z_DEMO_SRV/Run?mode='full'", {
+	top: 10
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper сохраняет существующие параметры и добавляет OData options через `,(0,c.jsx)(t.code,{children:`URLSearchParams`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не передавайте fragment/hash: он не является частью HTTP query OData endpoint.`}),`
+`,(0,c.jsx)(t.h3,{id:`trailing-slash`,children:`Trailing slash`}),`
+`,(0,c.jsx)(t.p,{children:`Trailing slash raw path удаляется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_DEMO_SRV/EntitySet/  -> /Z_DEMO_SRV/EntitySet
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`что-odatafetch-не-проверяет`,children:[`Что `,(0,c.jsx)(t.code,{children:`odataFetch`}),` не проверяет`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`существование service;`}),`
+`,(0,c.jsx)(t.li,{children:`существование target;`}),`
+`,(0,c.jsx)(t.li,{children:`обязательные parameters;`}),`
+`,(0,c.jsx)(t.li,{children:`OData type parameters;`}),`
+`,(0,c.jsx)(t.li,{children:`совместимость operation и target;`}),`
+`,(0,c.jsx)(t.li,{children:`корректность select/expand field names;`}),`
+`,(0,c.jsx)(t.li,{children:`runtime shape response.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для обычного application code предпочитайте metadata-aware helpers.`}),`
+`,(0,c.jsx)(t.h2,{id:`metadata-aware-operation-helpers`,children:`Metadata-aware operation helpers`}),`
+`,(0,c.jsx)(t.p,{children:`Публичные specialized helpers:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFn
+odataReadFn
+odataCreateFn
+odataUpdateFn
+odataDeleteFn
+odataFunctionImportFn
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Внутренний общий `,(0,c.jsx)(t.code,{children:`odataFetchFn`}),` не экспортируется public entrypoint. Не делайте deep import.`]}),`
+`,(0,c.jsx)(t.h3,{id:`runner-contract`,children:`Runner contract`}),`
+`,(0,c.jsx)(t.p,{children:`Каждый helper возвращает функцию такого смысла:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataRunner<TData> = (context: {
+	client: QueryClient;
+	signal?: AbortSignal;
+}) => Promise<{
+	data: TData;
+	totalCount?: number;
+}>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Прямой вызов:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataReadFn<SalesOrderDto>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	params: wrapODataParams({
+		OrderId: "42"
+	})
+});
+
+const result = await runner({
+	client: queryClient,
+	signal: abortController.signal
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`общие-options`,children:`Общие options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	odata: {
+		service: string;
+		target: string;
+	};
+	options?: ODataFetchOptions<I>;
+	init?: Omit<RequestInit, "signal" | "method" | "body">;
+	autoParse?: boolean;
+	swCache?: string;
+	transform?: (...args) => output;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Почему `,(0,c.jsx)(t.code,{children:`init`}),` не разрешает `,(0,c.jsx)(t.code,{children:`signal`}),`, `,(0,c.jsx)(t.code,{children:`method`}),`, `,(0,c.jsx)(t.code,{children:`body`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`signal принадлежит конкретному запуску Query;`}),`
+`,(0,c.jsx)(t.li,{children:`method определяется semantic operation и metadata;`}),`
+`,(0,c.jsx)(t.li,{children:`body принадлежит create/update contract.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это защищает от противоречивой конфигурации.`}),`
+`,(0,c.jsx)(t.h3,{id:`odatafetchfnrequest`,children:(0,c.jsx)(t.code,{children:`ODataFetchFnRequest`})}),`
+`,(0,c.jsx)(t.p,{children:`Public conditional type позволяет типизировать config по operation:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type UpdateRequest = ODataFetchFnRequest<
+	"update",
+	SalesOrderDto,
+	SalesOrder,
+	UpdateSalesOrderBody,
+	{ OrderId: string }
+>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обычно его не нужно писать вручную: specialized helper выводит options type.`}),`
+`,(0,c.jsx)(t.h3,{id:`generic-parameters`,children:`Generic parameters`}),`
+`,(0,c.jsx)(t.p,{children:`Упрощённо:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Helper`}),(0,c.jsx)(t.th,{children:`Generics`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataQueryFn`})}),(0,c.jsxs)(t.td,{children:[`input row `,(0,c.jsx)(t.code,{children:`I`}),`, output `,(0,c.jsx)(t.code,{children:`O`}),`, params `,(0,c.jsx)(t.code,{children:`P`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataReadFn`})}),(0,c.jsxs)(t.td,{children:[`input `,(0,c.jsx)(t.code,{children:`I`}),`, output `,(0,c.jsx)(t.code,{children:`O`}),`, params `,(0,c.jsx)(t.code,{children:`P`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataCreateFn`})}),(0,c.jsxs)(t.td,{children:[`input response `,(0,c.jsx)(t.code,{children:`I`}),`, output `,(0,c.jsx)(t.code,{children:`O`}),`, body `,(0,c.jsx)(t.code,{children:`T`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataUpdateFn`})}),(0,c.jsxs)(t.td,{children:[`input response `,(0,c.jsx)(t.code,{children:`I`}),`, output `,(0,c.jsx)(t.code,{children:`O`}),`, body `,(0,c.jsx)(t.code,{children:`T`}),`, params `,(0,c.jsx)(t.code,{children:`P`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataDeleteFn`})}),(0,c.jsxs)(t.td,{children:[`input response `,(0,c.jsx)(t.code,{children:`I`}),`, output `,(0,c.jsx)(t.code,{children:`O`}),`, params `,(0,c.jsx)(t.code,{children:`P`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFunctionImportFn`})}),(0,c.jsxs)(t.td,{children:[`input response `,(0,c.jsx)(t.code,{children:`I`}),`, output `,(0,c.jsx)(t.code,{children:`O`}),`, params `,(0,c.jsx)(t.code,{children:`P`})]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`I`}),` — не «тип backend, доказанный библиотекой». Это compile-time ожидание consumer-а. Runtime payload остаётся внешним значением.`]}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-target-lookup`,children:`Metadata target lookup`}),`
+`,(0,c.jsxs)(t.p,{children:[`Перед request helper получает service metadata и ищет `,(0,c.jsx)(t.code,{children:`odata.target`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`metadata.entities[target]
+metadata.functionImports[target]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ошибки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`OData target '<name>' не был загружен
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если одно имя одновременно найдено как Entity и FunctionImport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Найден конфликт metadata: '<name>' существует и как Entity, и как FunctionImport
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`operation-compatibility`,children:`Operation compatibility`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Metadata target`}),(0,c.jsx)(t.th,{children:`Разрешённые helpers`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Plain Entity`}),(0,c.jsx)(t.td,{children:`query/read/create/update/delete`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Parameterized Entity с `,(0,c.jsx)(t.code,{children:`result`})]}),(0,c.jsx)(t.td,{children:`query/create/update/delete; read запрещён`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`FunctionImport`}),(0,c.jsx)(t.td,{children:`только function import helper`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Create/update/delete для parameterized Entity технически не запрещены общей validation только из-за `,(0,c.jsx)(t.code,{children:`result`}),`, но использовать их следует лишь если реальный SAP contract это поддерживает. Metadata и backend остаются источником истины.`]}),`
+`,(0,c.jsx)(t.h3,{id:`result-и-no-content`,children:`Result и no-content`}),`
+`,(0,c.jsx)(t.p,{children:`Query обычно возвращает array. Single helpers возвращают single value.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для backend operation с `,(0,c.jsx)(t.code,{children:`204/205`}),` безопаснее типизировать data как `,(0,c.jsx)(t.code,{children:`unknown`}),` и проверить marker:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await odataDeleteFn<unknown>({
+	odata,
+	params
+})({ client: queryClient });
+
+if (isNoContentResponse(result.data)) {
+	// Удаление успешно, response body отсутствует.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не ожидайте updated entity от endpoint, который документирован как no-content.`}),`
+`,(0,c.jsxs)(t.h2,{id:`odataqueryfn-списки-и-parameterized-query`,children:[(0,c.jsx)(t.code,{children:`odataQueryFn`}),`: списки и parameterized query`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataQueryFn`}),` — основной helper чтения коллекций.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataQueryFn<I, O, P>({
+	odata,
+	params?,
+	options?,
+	init?,
+	autoParse?,
+	swCache?,
+	transform?
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`HTTP method всегда `,(0,c.jsx)(t.code,{children:`GET`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`plain-entity-query`,children:`Plain Entity query`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const loadOrders = odataQueryFn<SalesOrderDto>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	options: {
+		top: 50,
+		inlinecount: "allpages"
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_SALES_ORDER_SRV/SalesOrderSet?$top=50&$inlinecount=allpages
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для plain Entity `,(0,c.jsx)(t.code,{children:`params`}),` игнорируются:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFn({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	params: wrapODataParams({ OrderId: "42" })
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это не прочитает entity `,(0,c.jsx)(t.code,{children:`42`}),`; request останется collection query. В dev runtime выводится `,(0,c.jsx)(t.code,{children:`console.warn`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для одной entity используйте `,(0,c.jsx)(t.code,{children:`odataReadFn`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`parameterized-entity-query`,children:`Parameterized Entity query`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ReportParams = {
+	CompanyId: string;
+	DateFrom: Date;
+	DateTo: Date;
+};
+
+const loadReport = odataQueryFn<ReportRowDto, ReportRow, ReportParams>({
+	odata: {
+		service: "Z_REPORT_SRV",
+		target: "SalesReport"
+	},
+	params: wrapODataParams({
+		CompanyId: "1000",
+		DateFrom: new Date(2026, 0, 1),
+		DateTo: new Date(2026, 0, 31)
+	}),
+	options: {
+		top: 100,
+		inlinecount: "allpages"
+	},
+	autoParse: true,
+	transform: (rows) => rows.map(mapReportRow)
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если metadata target содержит `,(0,c.jsx)(t.code,{children:`result: "Results"`}),`, path будет похож на:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_REPORT_SRV/SalesReport(
+  CompanyId='1000',
+  DateFrom=datetime'2026-01-01T00:00:00',
+  DateTo=datetime'2026-01-31T00:00:00'
+)/Results?$top=100&$inlinecount=allpages
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Parameters форматируются по metadata, поэтому нужен `,(0,c.jsx)(t.code,{children:`wrapODataParams`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-transform-в-array`,children:`Query transform в array`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataQueryFn<SalesOrderDto, SalesOrder>({
+	odata,
+	transform: (rows, targetMetadata) => {
+		console.log(targetMetadata);
+		return rows.map(mapSalesOrder);
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Result:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`Promise<{
+	data: SalesOrder[];
+	totalCount?: number;
+}>
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`query-transform-в-одно-значение`,children:`Query transform в одно значение`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataQueryFn<SalesOrderDto, number>({
+	odata,
+	transform: (rows) => rows.reduce(
+		(sum, row) => sum + row.Amount,
+		0
+	)
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Result data — number:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await runner({ client: queryClient });
+console.log(result.data);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`totalCount`}),` при этом всё ещё описывает server collection, а не агрегированный output transform.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`query-и-204`,children:[`Query и `,(0,c.jsx)(t.code,{children:`204`})]}),`
+`,(0,c.jsx)(t.p,{children:`Collection query по нормальному OData contract должен возвращать JSON body. Если backend вернул no-content, рассматривайте это как protocol anomaly:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await runner({ client: queryClient });
+
+if (isNoContentResponse(result.data)) {
+	throw new Error("Collection query вернул ответ без body");
+}
+`})}),`
+`,(0,c.jsxs)(t.h2,{id:`odatareadfn-одна-entity`,children:[(0,c.jsx)(t.code,{children:`odataReadFn`}),`: одна Entity`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataReadFn`}),` читает одну Entity по key/parameters.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataReadFn<I, O, P>({
+	odata,
+	params,
+	options?,
+	init?,
+	autoParse?,
+	swCache?,
+	transform?
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`HTTP method — `,(0,c.jsx)(t.code,{children:`GET`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`простой-key`,children:`Простой key`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SalesOrderKey = {
+	OrderId: string;
+};
+
+const readSalesOrder = odataReadFn<
+	SalesOrderDto,
+	SalesOrder,
+	SalesOrderKey
+>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	params: wrapODataParams({
+		OrderId: "42"
+	}),
+	autoParse: true,
+	transform: (dto) => mapSalesOrder(dto)
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_SALES_ORDER_SRV/SalesOrderSet(OrderId='42')
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`составной-key`,children:`Составной key`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const readItem = odataReadFn<OrderItemDto>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderItemSet"
+	},
+	params: wrapODataParams({
+		OrderId: "42",
+		ItemNo: "10"
+	})
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_SALES_ORDER_SRV/SalesOrderItemSet(OrderId='42',ItemNo='10')
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Точный порядок, mandatory rules, quoting и OData literals определяет metadata builder из `,(0,c.jsx)(t.code,{children:`foundation-lib/odata-service`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-нельзя-передать-обычный-object`,children:`Почему нельзя передать обычный object`}),`
+`,(0,c.jsx)(t.p,{children:`Неверно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataReadFn({
+	odata,
+	params: {
+		OrderId: "42"
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`params: wrapODataParams({
+	OrderId: "42"
+})
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обёртка `,(0,c.jsx)(t.code,{children:`{ value }`}),` отделяет OData parameter contract от произвольного JS object и позволяет metadata builder обработать optional/formatter semantics.`]}),`
+`,(0,c.jsx)(t.h3,{id:`parameterized-entity-запрещена`,children:`Parameterized Entity запрещена`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если metadata Entity содержит `,(0,c.jsx)(t.code,{children:`result`}),`, `,(0,c.jsx)(t.code,{children:`odataReadFn`}),` бросит ошибку:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`OData operation 'read' несовместима с parameterized query entity ...
+Для target с result='Results' используйте method: 'query'.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`odataQueryFn`}),` с params.`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-options-у-read`,children:`Query options у read`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`options`}),` поддерживаются и для read:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataReadFn<SalesOrderDto>({
+	odata,
+	params,
+	options: {
+		select: ["OrderId", "Title"],
+		expand: ["Customer"]
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Но `,(0,c.jsx)(t.code,{children:`$top`}),`, `,(0,c.jsx)(t.code,{children:`$skip`}),`, `,(0,c.jsx)(t.code,{children:`$inlinecount`}),` обычно не имеют смысла для одной entity. Используйте только options, поддерживаемые backend contract.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`odatacreatefn-создание`,children:[(0,c.jsx)(t.code,{children:`odataCreateFn`}),`: создание`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataCreateFn`}),` создаёт Entity.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataCreateFn<I, O, T>({
+	odata,
+	body,
+	options?,
+	init?,
+	autoParse?,
+	swCache?,
+	transform?
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`HTTP method — `,(0,c.jsx)(t.code,{children:`POST`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`типы-body-и-response-отдельно`,children:`Типы body и response отдельно`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CreateSalesOrderBody = {
+	CompanyId: string;
+	Title: string;
+};
+
+type CreatedSalesOrderDto = {
+	OrderId: string;
+	CompanyId: string;
+	Title: string;
+	CreatedAt: Date;
+};
+
+const createSalesOrder = odataCreateFn<
+	CreatedSalesOrderDto,
+	SalesOrder,
+	CreateSalesOrderBody
+>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	body: {
+		CompanyId: "1000",
+		Title: "Новый заказ"
+	},
+	autoParse: true,
+	transform: mapSalesOrder
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Path/body:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`POST /Z_SALES_ORDER_SRV/SalesOrderSet
+Content-Type: application/json
+
+{"CompanyId":"1000","Title":"Новый заказ"}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`params-запрещены`,children:[(0,c.jsx)(t.code,{children:`params`}),` запрещены`]}),`
+`,(0,c.jsx)(t.p,{children:`Create path строится без entity params:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/SERVICE/ENTITY
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если backend публикует «создание» как FunctionImport, используйте `,(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),`, а не пытайтесь добавить params к create.`]}),`
+`,(0,c.jsx)(t.h3,{id:`body-должен-быть-json-compatible`,children:`Body должен быть JSON-compatible`}),`
+`,(0,c.jsxs)(t.p,{children:[`Body сериализуется `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Ошибки:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`cyclic object → исключение;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`BigInt`}),` → исключение;`]}),`
+`,(0,c.jsx)(t.li,{children:`function/symbol/undefined fields → удаляются по правилам JSON;`}),`
+`,(0,c.jsxs)(t.li,{children:[`Date → ISO string стандартного `,(0,c.jsx)(t.code,{children:`Date.toJSON`}),`, если body mapper не преобразовал её иначе.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Кроме того, текущий helper сериализует body только если value truthy. Используйте object body. Не используйте корневые `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),`, `,(0,c.jsx)(t.code,{children:`""`}),` или `,(0,c.jsx)(t.code,{children:`null`}),` как create payload.`]}),`
+`,(0,c.jsx)(t.h3,{id:`response-может-отличаться-от-body`,children:`Response может отличаться от body`}),`
+`,(0,c.jsx)(t.p,{children:`Не пишите один тип автоматически для обоих, если backend добавляет поля:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataCreateFn<CreatedDto, DomainEntity, CreateBody>(...);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это сохраняет связь:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`CreateBody -> SAP -> CreatedDto -> transform -> DomainEntity
+`})}),`
+`,(0,c.jsxs)(t.h2,{id:`odataupdatefn-обновление`,children:[(0,c.jsx)(t.code,{children:`odataUpdateFn`}),`: обновление`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataUpdateFn`}),` обновляет Entity по key/params и body.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataUpdateFn<I, O, T, P>({
+	odata,
+	params,
+	body,
+	options?,
+	init?,
+	autoParse?,
+	swCache?,
+	transform?
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`HTTP method — `,(0,c.jsx)(t.code,{children:`PUT`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type UpdateSalesOrderBody = {
+	Title: string;
+};
+
+type SalesOrderKey = {
+	OrderId: string;
+};
+
+const updateSalesOrder = odataUpdateFn<
+	SalesOrderDto,
+	SalesOrder,
+	UpdateSalesOrderBody,
+	SalesOrderKey
+>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	params: wrapODataParams({
+		OrderId: "42"
+	}),
+	body: {
+		Title: "Изменённый заказ"
+	},
+	autoParse: true,
+	transform: mapSalesOrder
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Request:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`PUT /Z_SALES_ORDER_SRV/SalesOrderSet(OrderId='42')
+
+{"Title":"Изменённый заказ"}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`PUT`}),` зафиксирован текущей реализацией. Helper не поддерживает отдельную semantic PATCH/MERGE operation. Если backend требует другой contract, используйте опубликованную FunctionImport или согласованное расширение package owner; не подменяйте method через `,(0,c.jsx)(t.code,{children:`init`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Write автоматически проходит X-CSRF lifecycle.`}),`
+`,(0,c.jsxs)(t.h2,{id:`odatadeletefn-удаление`,children:[(0,c.jsx)(t.code,{children:`odataDeleteFn`}),`: удаление`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataDeleteFn`}),` удаляет Entity по key/params.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataDeleteFn<I, O, P>({
+	odata,
+	params,
+	options?,
+	init?,
+	autoParse?,
+	swCache?,
+	transform?
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`HTTP method — `,(0,c.jsx)(t.code,{children:`DELETE`}),`. Body не поддерживается.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const deleteSalesOrder = odataDeleteFn<unknown>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "SalesOrderSet"
+	},
+	params: wrapODataParams({
+		OrderId: "42"
+	})
+});
+
+const result = await deleteSalesOrder({ client: queryClient });
+
+if (isNoContentResponse(result.data)) {
+	// Нормальный DELETE без response body.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Request:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`DELETE /Z_SALES_ORDER_SRV/SalesOrderSet(OrderId='42')
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Delete success не удаляет query cache автоматически. Consumer обязан применить `,(0,c.jsx)(t.code,{children:`setQueryData`}),` или scoped invalidation.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`odatafunctionimportfn-functionimport`,children:[(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),`: FunctionImport`]}),`
+`,(0,c.jsxs)(t.p,{children:[`FunctionImport helper используется только когда `,(0,c.jsx)(t.code,{children:`target`}),` объявлен в metadata как FunctionImport.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataFunctionImportFn<I, O, P>({
+	odata,
+	params,
+	options?,
+	init?,
+	autoParse?,
+	swCache?,
+	transform?
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`http-method-из-metadata`,children:`HTTP method из metadata`}),`
+`,(0,c.jsx)(t.p,{children:`В отличие от entity helpers, method не выбирает consumer:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-xml`,children:`<FunctionImport Name="CloseOrder" m:HttpMethod="POST" ... />
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper использует `,(0,c.jsx)(t.code,{children:`POST`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`httpMethod`}),` отсутствует:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`FunctionImport 'CloseOrder' не содержит httpMethod в metadata,
+поэтому operation 'fi' выполнить нельзя.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`post-functionimport`,children:`POST FunctionImport`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CloseOrderParams = {
+	OrderId: string;
+	Reason: string;
+};
+
+type CloseOrderDto = {
+	OrderId: string;
+	Status: string;
+};
+
+const closeOrder = odataFunctionImportFn<
+	CloseOrderDto,
+	SalesOrderStatus,
+	CloseOrderParams
+>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "CloseOrder"
+	},
+	params: wrapODataParams({
+		OrderId: "42",
+		Reason: "completed"
+	}),
+	transform: (dto) => ({
+		orderId: dto.OrderId,
+		status: dto.Status
+	})
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Условный path:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/Z_SALES_ORDER_SRV/CloseOrder?OrderId='42'&Reason='completed'
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Body не передаётся: FunctionImport parameters находятся в URL по metadata contract.`}),`
+`,(0,c.jsx)(t.h3,{id:`get-functionimport`,children:`GET FunctionImport`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const loadStatistics = odataFunctionImportFn<StatisticsDto>({
+	odata: {
+		service: "Z_SALES_ORDER_SRV",
+		target: "GetStatistics"
+	},
+	params: wrapODataParams({
+		CompanyId: "1000"
+	})
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если metadata объявляет GET, X-CSRF token не нужен.`}),`
+`,(0,c.jsx)(t.h3,{id:`functionimport-result-metadata`,children:`FunctionImport result metadata`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если FunctionImport содержит `,(0,c.jsx)(t.code,{children:`resultEntity`}),`, `,(0,c.jsx)(t.code,{children:`autoParse`}),` использует columns этой Entity.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`resultEntity`}),` отсутствует или не найден, `,(0,c.jsx)(t.code,{children:`autoParse`}),` молча оставляет payload без metadata conversion. Это не ошибка: FunctionImport может возвращать primitive/raw structure.`]}),`
+`,(0,c.jsx)(t.h3,{id:`несовместимые-helpers`,children:`Несовместимые helpers`}),`
+`,(0,c.jsx)(t.p,{children:`Entity helper для FunctionImport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`OData operation 'create' несовместима с FunctionImport 'CloseOrder'.
+Для FunctionImport используйте method: 'fi'.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`FunctionImport helper для Entity:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`OData operation 'fi' несовместима с Entity 'SalesOrderSet'.
+`})}),`
+`,(0,c.jsxs)(t.h2,{id:`autoparse-и-transform`,children:[(0,c.jsx)(t.code,{children:`autoParse`}),` и `,(0,c.jsx)(t.code,{children:`transform`})]}),`
+`,(0,c.jsx)(t.p,{children:`Это два последовательных, но разных этапа.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`raw OData JSON
+      │
+      ▼
+autoParse по metadata
+      │
+      ▼
+metadata-parsed DTO-like value
+      │
+      ▼
+transform consumer-а
+      │
+      ▼
+domain/result value
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`без-autoparse`,children:[`Без `,(0,c.jsx)(t.code,{children:`autoParse`})]}),`
+`,(0,c.jsx)(t.p,{children:`SAP может вернуть:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	FLAG: "X",
+	AMOUNT: "10.5",
+	CREATED_AT: "/Date(1773090000000)/"
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Без `,(0,c.jsx)(t.code,{children:`autoParse`}),` transform увидит strings:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFn<{
+	FLAG: string;
+	AMOUNT: string;
+	CREATED_AT: string;
+}>({
+	odata,
+	transform: (rows) => {
+		console.log(typeof rows[0]?.FLAG); // "string".
+		console.log(typeof rows[0]?.AMOUNT); // "string".
+		return rows;
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`с-autoparse`,children:[`С `,(0,c.jsx)(t.code,{children:`autoParse`})]}),`
+`,(0,c.jsx)(t.p,{children:`Если metadata columns описывают ABAP boolean-like, decimal и datetime:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFn<{
+	FLAG: boolean;
+	AMOUNT: number;
+	CREATED_AT: Date;
+}>({
+	odata,
+	autoParse: true
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ожидаемое runtime представление:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	FLAG: true,
+	AMOUNT: 10.5,
+	CREATED_AT: new Date(...)
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`что-именно-парсится`,children:`Что именно парсится`}),`
+`,(0,c.jsx)(t.p,{children:`Для каждого column metadata строится план из:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`id`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`base type;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`abapBooleanLike`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Затем преобразуются только собственные top-level поля, которые реально есть в record.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Поддерживаемые смысловые conversions определяет `,(0,c.jsx)(t.code,{children:`odataParseValueByMetadata`}),` из `,(0,c.jsx)(t.code,{children:`foundation-lib/odata-service`}),`, в том числе:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`boolean/ABAP boolean-like;`}),`
+`,(0,c.jsx)(t.li,{children:`integer/float/decimal/double;`}),`
+`,(0,c.jsx)(t.li,{children:`datetime/datetimeOffset/time;`}),`
+`,(0,c.jsx)(t.li,{children:`string-like values остаются string.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`shallow-parsing`,children:`Shallow parsing`}),`
+`,(0,c.jsx)(t.p,{children:`Не выполняется deep recursion:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	AMOUNT: "10.5",        // Может стать number.
+	Customer: {
+		LIMIT: "1000"       // Вложенное поле автоматически не парсится.
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`structural-sharing`,children:`Structural sharing`}),`
+`,(0,c.jsx)(t.p,{children:`Если conversion не изменил ни одного field, сохраняется исходный object reference.`}),`
+`,(0,c.jsx)(t.p,{children:`Для array создаётся копия только когда хотя бы один record изменился. Это помогает TanStack Query structural sharing, но consumer не должен строить бизнес-логику на identity implementation detail.`}),`
+`,(0,c.jsx)(t.h3,{id:`transform`,children:(0,c.jsx)(t.code,{children:`transform`})}),`
+`,(0,c.jsx)(t.p,{children:`Single operation transform:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`(data, targetMetadata) => output
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Query transform:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`(rows, targetMetadata) => output[] | output
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Transform вызывается после `,(0,c.jsx)(t.code,{children:`autoParse`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runner = odataQueryFn<SalesOrderDto, SalesOrder>({
+	odata,
+	autoParse: true,
+	transform: (rows, target) => {
+		console.log(target.title);
+		return rows.map(mapSalesOrder);
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`generics-не-являются-validation`,children:`Generics не являются validation`}),`
+`,(0,c.jsx)(t.p,{children:`Этот код компилируется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFn<{ Amount: number }>({
+	odata
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Но backend может вернуть:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{ "Amount": "not-a-number" }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`TypeScript не видит сеть. Для строгой boundary начните с `,(0,c.jsx)(t.code,{children:`unknown`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { isRecord } from "@ryuzaki13/react-foundation-lib/validators";
+
+function parseSalesOrder(value: unknown): SalesOrder {
+	if (!isRecord(value)) {
+		throw new Error("SalesOrder должен быть object");
+	}
+
+	if (typeof value.OrderId !== "string") {
+		throw new Error("SalesOrder.OrderId должен быть string");
+	}
+
+	if (typeof value.Amount !== "number") {
+		throw new Error("SalesOrder.Amount должен быть number");
+	}
+
+	return {
+		id: value.OrderId,
+		title: typeof value.Title === "string" ? value.Title : "",
+		amount: value.Amount,
+		createdAt: value.CreatedAt instanceof Date
+			? value.CreatedAt
+			: new Date(0)
+	};
+}
+
+const runner = odataQueryFn<unknown, SalesOrder>({
+	odata,
+	autoParse: true,
+	transform: (rows) => rows.map(parseSalesOrder)
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для критичного contract вместо fallback `,(0,c.jsx)(t.code,{children:`new Date(0)`}),` лучше бросить validation error. Пример показывает только технику narrowing.`]}),`
+`,(0,c.jsx)(t.h3,{id:`где-держать-mapping`,children:`Где держать mapping`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Generic metadata conversion — `,(0,c.jsx)(t.code,{children:`foundation-api/odata`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`DTO validation — API boundary владельца entity/feature.`}),`
+`,(0,c.jsx)(t.li,{children:`DTO-to-domain mapping — entity/feature приложения.`}),`
+`,(0,c.jsx)(t.li,{children:`Display formatting — formatter/UI owner.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не переносите SAP-specific domain mapper в foundation package.`}),`
+`,(0,c.jsx)(t.h2,{id:`tanstack-query-чтение`,children:`TanStack Query: чтение`}),`
+`,(0,c.jsx)(t.h3,{id:`provider-обязателен`,children:`Provider обязателен`}),`
+`,(0,c.jsxs)(t.p,{children:[`Hooks и metadata-aware runners используют `,(0,c.jsx)(t.code,{children:`QueryClient`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<QueryClientProvider client={queryClient}>
+	<App />
+</QueryClientProvider>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Вызов hook вне provider приведёт к ошибке TanStack Query.`}),`
+`,(0,c.jsx)(t.h3,{id:`query-key--identity-данных`,children:`Query key — identity данных`}),`
+`,(0,c.jsx)(t.p,{children:`Query key должен включать всё, что влияет на response:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const salesOrderKeys = {
+	all: ["sales-orders"] as const,
+	detail: (id: string) =>
+		[...salesOrderKeys.all, "detail", id] as const,
+	list: (params: {
+		companyId: string;
+		dateFrom: string;
+		dateTo: string;
+		skip: number;
+		top: number;
+	}) => [...salesOrderKeys.all, "list", params] as const
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализуйте Date в string:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const keyParams = {
+	companyId: companyId.trim(),
+	dateFrom: dateFrom.toISOString(),
+	dateTo: dateTo.toISOString(),
+	skip,
+	top
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не кладите в key:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`token;`}),`
+`,(0,c.jsx)(t.li,{children:`cookie;`}),`
+`,(0,c.jsx)(t.li,{children:`QueryClient;`}),`
+`,(0,c.jsx)(t.li,{children:`function;`}),`
+`,(0,c.jsx)(t.li,{children:`DOM node;`}),`
+`,(0,c.jsx)(t.li,{children:`огромный response body;`}),`
+`,(0,c.jsx)(t.li,{children:`mutable object, меняющийся после передачи.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`переиспользуемые-queryoptions`,children:[`Переиспользуемые `,(0,c.jsx)(t.code,{children:`queryOptions`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`export function salesOrderQueryOptions(params: SalesOrderListParams) {
+	const normalized = normalizeSalesOrderListParams(params);
+
+	return queryOptions({
+		queryKey: salesOrderKeys.list(normalized.key),
+		queryFn: odataQueryFn<SalesOrderDto, SalesOrder>({
+			odata: SALES_ORDER_ODATA,
+			options: {
+				expression: buildSalesOrderFilter(normalized),
+				sorts: normalized.sorts,
+				top: normalized.top,
+				skip: normalized.skip,
+				inlinecount: "allpages"
+			},
+			autoParse: true,
+			transform: (rows) => rows.map(mapSalesOrder)
+		}),
+		staleTime: 60_000
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Один factory можно использовать:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useQuery(salesOrderQueryOptions(params));
+
+queryClient.fetchQuery(salesOrderQueryOptions(params));
+
+queryClient.ensureQueryData(salesOrderQueryOptions(params));
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это предотвращает расхождение key/query function между component и loader.`}),`
+`,(0,c.jsx)(t.h3,{id:`result-envelope-в-query-cache`,children:`Result envelope в Query cache`}),`
+`,(0,c.jsx)(t.p,{children:`По умолчанию cache data:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	data: SalesOrder[];
+	totalCount?: number;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Component:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const query = useQuery(salesOrderQueryOptions(params));
+
+const rows = query.data?.data ?? [];
+const totalCount = query.data?.totalCount ?? rows.length;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте `,(0,c.jsx)(t.code,{children:`rows.length`}),` как общее количество при server paging.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`select-tanstack-query`,children:[(0,c.jsx)(t.code,{children:`select`}),` TanStack Query`]}),`
+`,(0,c.jsx)(t.p,{children:`Можно дать UI только rows:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const query = useQuery({
+	...salesOrderQueryOptions(params),
+	select: (result) => result.data
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Но `,(0,c.jsx)(t.code,{children:`totalCount`}),` станет недоступен этому observer. Для table paging лучше сохранить envelope.`]}),`
+`,(0,c.jsx)(t.h3,{id:`conditional-query`,children:`Conditional query`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const query = useQuery({
+	...salesOrderQueryOptions(params),
+	enabled: Boolean(companyId)
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не вызывайте `,(0,c.jsx)(t.code,{children:`useQuery`}),` условно:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Неверно: нарушает Rules of Hooks.
+if (companyId) {
+	useQuery(...);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`abortsignal`,children:`AbortSignal`}),`
+`,(0,c.jsx)(t.p,{children:`TanStack Query передаёт signal в runner автоматически:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`component unmount / query cancellation / refetch replacement
+                        │
+                        ▼
+                AbortSignal queryFn
+                        │
+                        ▼
+                  OData fetch
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не сохраняйте signal в module state или долгоживущее closure.`}),`
+`,(0,c.jsx)(t.p,{children:`При ручном вызове:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const controller = new AbortController();
+
+const promise = runner({
+	client: queryClient,
+	signal: controller.signal
+});
+
+controller.abort();
+await promise;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Abort обычно приводит к rejection от `,(0,c.jsx)(t.code,{children:`fetch`}),`. Не превращайте его автоматически в пустой array без явной UX policy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`paging`,children:`Paging`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const pageSize = 50;
+const pageIndex = 2;
+
+const options = {
+	top: pageSize,
+	skip: pageIndex * pageSize,
+	inlinecount: "allpages"
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`top`}),`, `,(0,c.jsx)(t.code,{children:`skip`}),`, filters и sorts должны входить в query key.`]}),`
+`,(0,c.jsx)(t.h3,{id:`infinite-query`,children:`Infinite query`}),`
+`,(0,c.jsxs)(t.p,{children:[`Direct runner не получает `,(0,c.jsx)(t.code,{children:`pageParam`}),`, потому что его runtime contract использует только `,(0,c.jsx)(t.code,{children:`client`}),` и `,(0,c.jsx)(t.code,{children:`signal`}),`. Оберните его:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const pageSize = 50;
+
+const query = useInfiniteQuery({
+	queryKey: [...salesOrderKeys.all, "infinite", normalizedFilters],
+	initialPageParam: 0,
+	queryFn: ({ client, signal, pageParam }) =>
+		odataQueryFn<SalesOrderDto, SalesOrder>({
+			odata: SALES_ORDER_ODATA,
+			options: {
+				expression: buildSalesOrderFilter(normalizedFilters),
+				top: pageSize,
+				skip: pageParam * pageSize,
+				inlinecount: "allpages"
+			},
+			transform: (rows) => rows.map(mapSalesOrder)
+		})({ client, signal }),
+	getNextPageParam: (lastPage, pages) => {
+		const loaded = pages.reduce(
+			(sum, page) => sum + page.data.length,
+			0
+		);
+
+		if (lastPage.totalCount !== undefined && loaded >= lastPage.totalCount) {
+			return undefined;
+		}
+
+		return pages.length;
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для backend, который не возвращает count, остановку нужно определять другим подтверждённым правилом, например `,(0,c.jsx)(t.code,{children:`lastPage.data.length < pageSize`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки-query`,children:`Ошибки query`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`if (query.isError) {
+	return <ErrorState error={query.error} />;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не показывайте пользователю raw SAP error payload целиком. UI message должен быть безопасным, а technical diagnostics — централизованным.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Не копируйте `,(0,c.jsx)(t.code,{children:`query.data`}),` в local state через effect:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Нежелательно: создаёт второй источник backend state.
+useEffect(() => {
+	setRows(query.data?.data ?? []);
+}, [query.data]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте Query data напрямую. Local state оставьте для draft/selection/interaction.`}),`
+`,(0,c.jsx)(t.h2,{id:`tanstack-query-mutations-и-cache`,children:`TanStack Query: mutations и cache`}),`
+`,(0,c.jsxs)(t.p,{children:[`Metadata-aware write runner нельзя передать напрямую как обычную `,(0,c.jsx)(t.code,{children:`mutationFn(input)`}),`, потому что runner ожидает `,(0,c.jsx)(t.code,{children:`{ client, signal? }`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Получите текущий client:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const queryClient = useQueryClient();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`И создавайте operation из mutation input.`}),`
+`,(0,c.jsx)(t.h3,{id:`create-mutation--invalidation`,children:`Create mutation + invalidation`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`type CreateSalesOrderInput = {
+	companyId: string;
+	title: string;
+};
+
+const createMutation = useMutation({
+	mutationFn: (input: CreateSalesOrderInput) =>
+		odataCreateFn<SalesOrderDto, SalesOrder, CreateSalesOrderBody>({
+			odata: SALES_ORDER_ODATA,
+			body: {
+				CompanyId: input.companyId,
+				Title: input.title
+			},
+			autoParse: true,
+			transform: mapSalesOrder
+		})({ client: queryClient }),
+	onSuccess: async () => {
+		await queryClient.invalidateQueries({
+			queryKey: salesOrderKeys.all
+		});
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`onSuccess`}),` получает runner result:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSuccess: async (result) => {
+	const created = result.data;
+	console.log(created.id);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`update-mutation--точечный-cache-update`,children:`Update mutation + точечный cache update`}),`
+`,(0,c.jsx)(t.p,{children:`Если backend возвращает актуальную Entity, можно обновить detail query без refetch:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const updateMutation = useMutation({
+	mutationFn: (input: UpdateSalesOrderInput) =>
+		odataUpdateFn<SalesOrderDto, SalesOrder, UpdateSalesOrderBody>({
+			odata: SALES_ORDER_ODATA,
+			params: wrapODataParams({
+				OrderId: input.id
+			}),
+			body: {
+				Title: input.title
+			},
+			autoParse: true,
+			transform: mapSalesOrder
+		})({ client: queryClient }),
+	onSuccess: (result, input) => {
+		queryClient.setQueryData(
+			salesOrderKeys.detail(input.id),
+			result
+		);
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Важно: если detail query хранит runner envelope, записывайте `,(0,c.jsx)(t.code,{children:`result`}),`, а не `,(0,c.jsx)(t.code,{children:`result.data`}),`. Cache shape должен совпадать.`]}),`
+`,(0,c.jsx)(t.h3,{id:`обновление-list-cache`,children:`Обновление list cache`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryClient.setQueriesData<{
+	data: SalesOrder[];
+	totalCount?: number;
+}>({ queryKey: salesOrderKeys.all }, (current) => {
+	if (!current) return current;
+
+	return {
+		...current,
+		data: current.data.map((order) =>
+			order.id === updated.id ? updated : order
+		)
+	};
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не мутируйте `,(0,c.jsx)(t.code,{children:`current.data`}),` через `,(0,c.jsx)(t.code,{children:`push`}),`, `,(0,c.jsx)(t.code,{children:`splice`}),` или присваивание поля. Возвращайте новые arrays/objects.`]}),`
+`,(0,c.jsx)(t.h3,{id:`delete-mutation`,children:`Delete mutation`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const deleteMutation = useMutation({
+	mutationFn: (orderId: string) =>
+		odataDeleteFn<unknown>({
+			odata: SALES_ORDER_ODATA,
+			params: wrapODataParams({ OrderId: orderId })
+		})({ client: queryClient }),
+	onSuccess: async (_result, orderId) => {
+		queryClient.removeQueries({
+			queryKey: salesOrderKeys.detail(orderId),
+			exact: true
+		});
+
+		await queryClient.invalidateQueries({
+			queryKey: salesOrderKeys.all
+		});
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`functionimport-mutation`,children:`FunctionImport mutation`}),`
+`,(0,c.jsx)(t.p,{children:`Даже если helper называется FunctionImport, cache lifecycle остаётся обычной TanStack mutation:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const closeMutation = useMutation({
+	mutationFn: (orderId: string) =>
+		odataFunctionImportFn<CloseOrderDto, SalesOrderStatus>({
+			odata: {
+				service: "Z_SALES_ORDER_SRV",
+				target: "CloseOrder"
+			},
+			params: wrapODataParams({ OrderId: orderId }),
+			transform: mapSalesOrderStatus
+		})({ client: queryClient }),
+	onSuccess: async (_result, orderId) => {
+		await queryClient.invalidateQueries({
+			queryKey: salesOrderKeys.detail(orderId)
+		});
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`как-выбрать-cache-strategy`,children:`Как выбрать cache strategy`}),`
+`,(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:`Strategy`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Response содержит полную актуальную Entity`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`setQueryData`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Mutation влияет на несколько неизвестных rows`}),(0,c.jsxs)(t.td,{children:[`scoped `,(0,c.jsx)(t.code,{children:`invalidateQueries`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен мгновенный UI и rollback возможен`}),(0,c.jsx)(t.td,{children:`optimistic update`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Несколько вкладок должны синхронизироваться`}),(0,c.jsx)(t.td,{children:`принятый broadcast mechanism`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Используется persisted descriptor`}),(0,c.jsxs)(t.td,{children:[`cache strategy `,(0,c.jsx)(t.code,{children:`/persisted`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Не инвалидируйте весь QueryClient:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Слишком широко.
+queryClient.invalidateQueries();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте key owner конкретного resource.`}),`
+`,(0,c.jsx)(t.h3,{id:`optimistic-update-с-rollback`,children:`Optimistic update с rollback`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`type OrdersSnapshot = Array<[
+	readonly unknown[],
+	{
+		data: SalesOrder[];
+		totalCount?: number;
+	} | undefined
+]>;
+
+const mutation = useMutation({
+	mutationFn: (input: UpdateSalesOrderInput) =>
+		odataUpdateFn<SalesOrderDto, SalesOrder, UpdateSalesOrderBody>({
+			odata: SALES_ORDER_ODATA,
+			params: wrapODataParams({ OrderId: input.id }),
+			body: { Title: input.title },
+			transform: mapSalesOrder
+		})({ client: queryClient }),
+	onMutate: async (input) => {
+		await queryClient.cancelQueries({ queryKey: salesOrderKeys.all });
+
+		const snapshot = queryClient.getQueriesData<{
+			data: SalesOrder[];
+			totalCount?: number;
+		}>({ queryKey: salesOrderKeys.all }) as OrdersSnapshot;
+
+		queryClient.setQueriesData<{
+			data: SalesOrder[];
+			totalCount?: number;
+		}>({ queryKey: salesOrderKeys.all }, (current) => {
+			if (!current) return current;
+
+			return {
+				...current,
+				data: current.data.map((order) =>
+					order.id === input.id
+						? { ...order, title: input.title }
+						: order
+				)
+			};
+		});
+
+		return { snapshot };
+	},
+	onError: (_error, _input, context) => {
+		for (const [queryKey, data] of context?.snapshot ?? []) {
+			queryClient.setQueryData(queryKey, data);
+		}
+	},
+	onSettled: async () => {
+		await queryClient.invalidateQueries({
+			queryKey: salesOrderKeys.all
+		});
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обязательные части optimistic flow:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`cancel связанных queries;`}),`
+`,(0,c.jsx)(t.li,{children:`сохранить snapshot;`}),`
+`,(0,c.jsx)(t.li,{children:`записать immutable optimistic state;`}),`
+`,(0,c.jsx)(t.li,{children:`вернуть context;`}),`
+`,(0,c.jsxs)(t.li,{children:[`rollback в `,(0,c.jsx)(t.code,{children:`onError`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`reconcile/invalidate в `,(0,c.jsx)(t.code,{children:`onSettled`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если rollback невозможно сделать корректно, используйте pending state mutation и server refetch вместо optimistic update.`}),`
+`,(0,c.jsx)(t.h3,{id:`abort-у-mutation`,children:`Abort у mutation`}),`
+`,(0,c.jsxs)(t.p,{children:[`Generic TanStack `,(0,c.jsx)(t.code,{children:`useMutation`}),` не передаёт AbortSignal в runner автоматически. Current OData runner contract допускает optional signal, но consumer должен создать отдельный lifecycle вручную, если write endpoint безопасно поддерживает cancellation.`]}),`
+`,(0,c.jsx)(t.p,{children:`Отмена browser request не означает, что SAP backend гарантированно отменил уже начатую write operation. Делайте write идемпотентной по backend contract, когда это возможно.`}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-mutation`,children:`Ошибка mutation`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`if (mutation.isError) {
+	showSafeErrorMessage();
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не делайте пустой catch:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`try {
+	await mutation.mutateAsync(input);
+} catch {
+	// Неверно: technical failure потерян.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Либо позвольте global mutation error policy обработать error, либо добавьте user recovery и сохраните technical error flow.`}),`
+`,(0,c.jsx)(t.h2,{id:`dev-dry-run-helpers`,children:`DEV dry-run helpers`}),`
+`,(0,c.jsx)(t.p,{children:`Публичные helpers:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFnDev
+odataReadFnDev
+odataCreateFnDev
+odataUpdateFnDev
+odataDeleteFnDev
+odataFunctionImportFnDev
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Options и generics повторяют соответствующие real helpers.`}),`
+`,(0,c.jsxs)(t.h3,{id:`поведение-в-__dev__`,children:[`Поведение в `,(0,c.jsx)(t.code,{children:`__DEV__`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`metadata request ─────────────── выполняется при необходимости
+target validation ───────────── выполняется
+path/query/body building ────── выполняется
+console diagnostics ─────────── выполняется
+warning notification ────────── показывается
+целевой data/write request ──── НЕ выполняется
+transform ───────────────────── НЕ выполняется
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Query dry-run возвращает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	data: [],
+	totalCount: 0
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Single dry-run:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	data: undefined
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`что-выводится-в-console`,children:`Что выводится в console`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`helper name;`}),`
+`,(0,c.jsx)(t.li,{children:`semantic operation;`}),`
+`,(0,c.jsx)(t.li,{children:`service/target;`}),`
+`,(0,c.jsx)(t.li,{children:`target kind;`}),`
+`,(0,c.jsx)(t.li,{children:`полный URL;`}),`
+`,(0,c.jsx)(t.li,{children:`path без base URL;`}),`
+`,(0,c.jsx)(t.li,{children:`query string;`}),`
+`,(0,c.jsx)(t.li,{children:`body;`}),`
+`,(0,c.jsx)(t.li,{children:`request init;`}),`
+`,(0,c.jsx)(t.li,{children:`итоговые transport headers preview;`}),`
+`,(0,c.jsx)(t.li,{children:`metadata target;`}),`
+`,(0,c.jsx)(t.li,{children:`params/options;`}),`
+`,(0,c.jsxs)(t.li,{children:[`признак `,(0,c.jsx)(t.code,{children:`autoParse`}),` и `,(0,c.jsx)(t.code,{children:`transform`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте real secrets/tokens в dev examples: params и body выводятся в console.`}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-request-всё-ещё-реален`,children:`Metadata request всё ещё реален`}),`
+`,(0,c.jsxs)(t.p,{children:[`Dry-run не является полностью offline. Для построения корректного target path нужны metadata, поэтому `,(0,c.jsx)(t.code,{children:`$metadata`}),` может быть загружена из сети.`]}),`
+`,(0,c.jsx)(t.h3,{id:`production-поведение`,children:`Production поведение`}),`
+`,(0,c.jsxs)(t.p,{children:[`В non-dev build `,(0,c.jsx)(t.code,{children:`*Dev`}),` helper делегирует real helper и выполняет настоящий request.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это важное правило безопасности:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`odataUpdateFnDev не является вечной заглушкой.
+В production он делает реальный update.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте Dev helper как mock API или способ гарантированно запретить write. Для теста подменяйте transport/network.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-нет-public-odatafetchfndev`,children:[`Почему нет public `,(0,c.jsx)(t.code,{children:`odataFetchFnDev`})]}),`
+`,(0,c.jsx)(t.p,{children:`Внутренний generic builder не экспортирован package entrypoint. Используйте только шесть specialized Dev helpers.`}),`
+`,(0,c.jsx)(t.h2,{id:`metadata-описание-сервиса`,children:`Metadata: описание сервиса`}),`
+`,(0,c.jsxs)(t.p,{children:[`Metadata — это XML-документ по адресу `,(0,c.jsx)(t.code,{children:`/<service>/$metadata`}),`. В нём сервер описывает:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`какие Entity и FunctionImport существуют;`}),`
+`,(0,c.jsx)(t.li,{children:`какие свойства есть у Entity;`}),`
+`,(0,c.jsx)(t.li,{children:`какие свойства являются ключами;`}),`
+`,(0,c.jsxs)(t.li,{children:[`типы свойств: `,(0,c.jsx)(t.code,{children:`Edm.String`}),`, `,(0,c.jsx)(t.code,{children:`Edm.Boolean`}),`, `,(0,c.jsx)(t.code,{children:`Edm.DateTime`}),` и другие;`]}),`
+`,(0,c.jsx)(t.li,{children:`обязательность параметров;`}),`
+`,(0,c.jsx)(t.li,{children:`HTTP method FunctionImport;`}),`
+`,(0,c.jsx)(t.li,{children:`связи code/text и другие SAP annotations.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`API-пакет загружает XML, передаёт его parser-у из `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),` и сохраняет разобранный результат в TanStack Query.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`GET /sap/opu/odata/sap/ZSALES_SRV/$metadata
+                 │
+                 ▼
+            XML Response
+                 │
+                 ▼
+       parseServiceMetadata(...)
+                 │
+                 ▼
+     EntityMetadata / FunctionImportMetadata
+                 │
+                 ▼
+          TanStack Query cache
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Metadata нужна metadata-aware helpers. Именно благодаря ей `,(0,c.jsx)(t.code,{children:`odataReadFn`}),` понимает keys, `,(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),` — HTTP method, а `,(0,c.jsx)(t.code,{children:`autoParse`}),` — типы полей.`]}),`
+`,(0,c.jsx)(t.h3,{id:`fetchmetadata`,children:(0,c.jsx)(t.code,{children:`fetchMetadata`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchMetadata(options)`}),` создаёт TanStack-compatible query function.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { fetchMetadata } from "@ryuzaki13/react-foundation-api/odata";
+
+const queryFn = fetchMetadata({
+  service: "ZSALES_SRV"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычно напрямую вызывать функцию не нужно. Используйте `,(0,c.jsx)(t.code,{children:`odataMetadataQueryOptions`}),`, `,(0,c.jsx)(t.code,{children:`getODataMetadataData`}),` или hooks ниже.`]}),`
+`,(0,c.jsx)(t.p,{children:`В запросе выставляются:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Accept: */*
+Content-Type: application/xml
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если XML невозможно разобрать, ошибка оборачивается сообщением с именем сервиса. Это помогает отличить transport error от некорректной metadata.`}),`
+`,(0,c.jsx)(t.h3,{id:`odatametadataqueryoptions`,children:(0,c.jsx)(t.code,{children:`odataMetadataQueryOptions`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Factory возвращает готовые `,(0,c.jsx)(t.code,{children:`queryOptions`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { odataMetadataQueryOptions } from "@ryuzaki13/react-foundation-api/odata";
+
+const metadata = await queryClient.fetchQuery(
+  odataMetadataQueryOptions({
+    service: "ZSALES_SRV"
+  })
+);
+
+console.log(metadata.entities);
+console.log(metadata.functionImports);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Query key включает тип записи, service и уже resolved `,(0,c.jsx)(t.code,{children:`baseUrl`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+  "odata",
+  "metadata",
+  {
+    service: "ZSALES_SRV",
+    baseUrl: "/sap/opu/odata/sap"
+  }
+]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Настройки query:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Настройка`}),(0,c.jsx)(t.th,{children:`Значение`}),(0,c.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:`enabled`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Boolean(service)`})}),(0,c.jsx)(t.td,{children:`Пустое имя не запускает запрос`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`staleTime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Infinity`})}),(0,c.jsx)(t.td,{children:`Metadata не протухает по обычному таймеру`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`gcTime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Infinity`})}),(0,c.jsx)(t.td,{children:`Metadata не выгружается как обычный неактивный query`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`meta`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`persistedQueryMeta`})}),(0,c.jsx)(t.td,{children:`Snapshot разрешено сохранять persistence-слою`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Infinity`}),` не означает, что metadata никогда не обновится. За её актуальностью следит отдельный version-check.`]}),`
+`,(0,c.jsx)(t.h3,{id:`useodatametadataquery`,children:(0,c.jsx)(t.code,{children:`useODataMetadataQuery`})}),`
+`,(0,c.jsx)(t.p,{children:`Хук одновременно наблюдает metadata и её серверную версию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataMetadataQuery } from "@ryuzaki13/react-foundation-api/odata";
+
+export function MetadataState() {
+  const query = useODataMetadataQuery({ service: "ZSALES_SRV" });
+
+  if (query.isPending) return <p>Загрузка metadata…</p>;
+  if (query.isError) return <p>{query.error.message}</p>;
+
+  return <p>Entity: {Object.keys(query.data.entities).length}</p>;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Хук требует `,(0,c.jsx)(t.code,{children:`QueryClientProvider`}),`, потому что внутри использует `,(0,c.jsx)(t.code,{children:`useQuery`}),` и `,(0,c.jsx)(t.code,{children:`useQueryClient`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`getodatametadatadata`,children:(0,c.jsx)(t.code,{children:`getODataMetadataData`})}),`
+`,(0,c.jsx)(t.p,{children:`Императивный вариант нужен вне React component: в query function, loader, mutation или service layer.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { getODataMetadataData } from "@ryuzaki13/react-foundation-api/odata";
+
+const metadata = await getODataMetadataData(
+  { service: "ZSALES_SRV" },
+  queryClient
+);
+
+const salesOrder = metadata?.entities.SalesOrderSet;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`При пустом `,(0,c.jsx)(t.code,{children:`service`}),` вернуть `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Получить metadata через общий QueryClient.`}),`
+`,(0,c.jsx)(t.li,{children:`Проверить server version, если endpoint настроен.`}),`
+`,(0,c.jsx)(t.li,{children:`При необходимости инвалидировать metadata только этого сервиса.`}),`
+`,(0,c.jsx)(t.li,{children:`Повторно получить metadata из QueryClient.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если технический version endpoint временно недоступен, ошибка version-check подавляется, а уже сохранённая metadata продолжает использоваться. Ошибка самой metadata не подавляется.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-нельзя-делать-обычный-fetchmetadata`,children:[`Почему нельзя делать обычный `,(0,c.jsx)(t.code,{children:`fetch(".../$metadata")`})]}),`
+`,(0,c.jsx)(t.p,{children:`Такой запрос обойдёт:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`единый URL adapter;`}),`
+`,(0,c.jsx)(t.li,{children:`SAP headers и cookies;`}),`
+`,(0,c.jsx)(t.li,{children:`TanStack Query deduplication;`}),`
+`,(0,c.jsx)(t.li,{children:`persisted snapshot;`}),`
+`,(0,c.jsx)(t.li,{children:`version-check;`}),`
+`,(0,c.jsx)(t.li,{children:`общий parser;`}),`
+`,(0,c.jsx)(t.li,{children:`единый error contract.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для application code это почти всегда неправильная граница ответственности.`}),`
+`,(0,c.jsx)(t.h2,{id:`metadata-version-check`,children:`Metadata version-check`}),`
+`,(0,c.jsx)(t.p,{children:`Metadata хранится долго, поэтому пакет умеет проверять время последней генерации сервиса через project-specific technical Entity.`}),`
+`,(0,c.jsx)(t.p,{children:`Endpoint настраивается в adapter:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureODataProjectAdapter({
+  metadataVersion: {
+    service: "ZTECH_SRV",
+    target: "MetadataVersions",
+    baseUrl: "default"
+  }
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ожидаемый server record:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataMetadataVersionRecord {
+  serviceName: string;
+  lastChanged: string;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Запрос строится примерно так:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/ZTECH_SRV/MetadataVersions('ZSALES_SRV')
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Перед подстановкой имя основного сервиса нормализуется через `,(0,c.jsx)(t.code,{children:`normalizeODataServiceName`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`useodatametadataversionquery`,children:(0,c.jsx)(t.code,{children:`useODataMetadataVersionQuery`})}),`
+`,(0,c.jsx)(t.p,{children:`Хук даёт прямой доступ к диагностике версии без загрузки metadata:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataMetadataVersionQuery } from "@ryuzaki13/react-foundation-api/odata";
+
+function MetadataVersion() {
+  const version = useODataMetadataVersionQuery({
+    service: "ZSALES_SRV",
+    staleTime: 15 * 60 * 1000
+  });
+
+  if (!version.data?.changedAt) return null;
+  return <time>{version.data.changedAt.toISOString()}</time>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Result:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataMetadataVersionResult {
+  service: string;
+  changedAt: Date | null;
+  version: string | null;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`version`}),` — OData datetime string, построенная из `,(0,c.jsx)(t.code,{children:`changedAt`}),`. Если adapter endpoint отсутствует, query function возвращает успешный пустой result с `,(0,c.jsx)(t.code,{children:`null`}),`, не делает network request.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Default `,(0,c.jsx)(t.code,{children:`staleTime`}),` version query — 2 часа, `,(0,c.jsx)(t.code,{children:`gcTime`}),` — `,(0,c.jsx)(t.code,{children:`Infinity`}),`. Query key также содержит application build id, чтобы разные сборки не смешивали persisted version snapshot.`]}),`
+`,(0,c.jsx)(t.h3,{id:`applyodatametadataversion`,children:(0,c.jsx)(t.code,{children:`applyODataMetadataVersion`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция сравнивает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`version.changedAt`}),` с сервера;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`dataUpdatedAt`}),` metadata query в TanStack Query.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata инвалидируется только когда:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`metadata уже есть
+AND changedAt существует
+AND changedAt > metadata.dataUpdatedAt
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+  applyODataMetadataVersion,
+  useODataMetadataVersionQuery
+} from "@ryuzaki13/react-foundation-api/odata";
+
+await applyODataMetadataVersion(
+  queryClient,
+  { service: "ZSALES_SRV" },
+  {
+    service: "ZSALES_SRV",
+    changedAt: new Date("2026-08-21T08:00:00Z"),
+    version: "datetime'2026-08-21T08:00:00'"
+  }
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Инвалидация точечная: metadata других сервисов и сам version query не затрагиваются. Уже идущий refetch не отменяется.`}),`
+`,(0,c.jsx)(t.h2,{id:`entity-metadata-hooks`,children:`Entity metadata hooks`}),`
+`,(0,c.jsx)(t.h3,{id:`useodatametadata`,children:(0,c.jsx)(t.code,{children:`useODataMetadata`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает metadata конкретной Entity:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataMetadata } from "@ryuzaki13/react-foundation-api/odata";
+
+function EntityInfo() {
+  const { metadata, metadataUpdatedAt, isLoading } = useODataMetadata({
+    service: "ZSALES_SRV",
+    target: "SalesOrderSet"
+  });
+
+  if (isLoading) return <p>Загрузка…</p>;
+
+  return (
+    <ul>
+      {metadata?.columns?.map((column) => (
+        <li key={column.id}>{column.id}</li>
+      ))}
+    </ul>
+  );
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Result:`}),`
+`,(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:`metadata`})}),(0,c.jsxs)(t.td,{children:[`Entity metadata или `,(0,c.jsx)(t.code,{children:`undefined`}),` во время загрузки/если target не найден`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`metadataUpdatedAt`})}),(0,c.jsx)(t.td,{children:`timestamp обновления metadata query`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isLoading`})}),(0,c.jsx)(t.td,{children:`идёт ли initial metadata load`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Если target оказался FunctionImport, хук выбросит понятную ошибку: FunctionImport нельзя использовать как Entity. Если metadata query завершилась ошибкой, хук также выбрасывает domain-oriented error с именем сервиса.`}),`
+`,(0,c.jsx)(t.h3,{id:`useodataentity`,children:(0,c.jsx)(t.code,{children:`useODataEntity`})}),`
+`,(0,c.jsx)(t.p,{children:`Добавляет удобные actions над Entity metadata:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataEntity } from "@ryuzaki13/react-foundation-api/odata";
+
+function EntityDiagnostics() {
+  const entity = useODataEntity({
+    service: "ZSALES_SRV",
+    target: "SalesOrderSet"
+  });
+
+  if (entity.isLoading) return null;
+
+  const path = entity.actions.getEntityPath({ SalesOrderId: "50000123" });
+  const columns = entity.actions.getKeys();
+  const pairs = entity.actions.getKeyPairs();
+  const pairsMap = entity.actions.getKeyPairsMap();
+
+  return <pre>{JSON.stringify({ path, columns, pairs, pairsMap }, null, 2)}</pre>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Actions:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Action`}),(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:`getEntityPath(values?)`})}),(0,c.jsx)(t.td,{children:`Metadata-correct путь Entity или parameterized Entity`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getKeys()`})}),(0,c.jsx)(t.td,{children:`Массив id всех columns Entity`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getKeyPairs()`})}),(0,c.jsxs)(t.td,{children:[`Пары `,(0,c.jsx)(t.code,{children:`{ codeKey, textKey }`}),` для связанных code/text columns`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getKeyPairsMap()`})}),(0,c.jsxs)(t.td,{children:[`Словарь `,(0,c.jsx)(t.code,{children:`{ [codeKey]: textKey }`})]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`До окончания metadata load actions вызывать нельзя: они выбрасывают ошибку. Сначала проверяйте `,(0,c.jsx)(t.code,{children:`isLoading`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ODataEntity`}),` — type alias результата хука без поля `,(0,c.jsx)(t.code,{children:`isLoading`}),`. Он полезен для props дочернего компонента, который получает уже готовую Entity model.`]}),`
+`,(0,c.jsx)(t.h2,{id:`справочники-odata`,children:`Справочники OData`}),`
+`,(0,c.jsx)(t.p,{children:`Справочник — небольшая или средняя Entity, которая содержит пары code/text и используется в select, filter, autocomplete или зависимых фильтрах.`}),`
+`,(0,c.jsx)(t.p,{children:`Пример server rows:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`[
+  {
+    "CompanyCode": "1000",
+    "CompanyName": "Главная компания",
+    "Plant": "1100",
+    "PlantName": "Основной завод"
+  },
+  {
+    "CompanyCode": "1000",
+    "CompanyName": "Главная компания",
+    "Plant": "1200",
+    "PlantName": "Резервный завод"
+  }
+]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Metadata связывает `,(0,c.jsx)(t.code,{children:`CompanyCode`}),` с `,(0,c.jsx)(t.code,{children:`CompanyName`}),`, а `,(0,c.jsx)(t.code,{children:`Plant`}),` с `,(0,c.jsx)(t.code,{children:`PlantName`}),`. Пакет строит из rows:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`полный `,(0,c.jsx)(t.code,{children:`items`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пары code/text;`}),`
+`,(0,c.jsx)(t.li,{children:`быстрый map code → text field;`}),`
+`,(0,c.jsx)(t.li,{children:`отдельные массивы для каждого уровня;`}),`
+`,(0,c.jsx)(t.li,{children:`chain уровней от наименьшей cardinality к наибольшей;`}),`
+`,(0,c.jsx)(t.li,{children:`timestamp cache snapshot.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`минимальный-useodatacollectionquery`,children:[`Минимальный `,(0,c.jsx)(t.code,{children:`useODataCollectionQuery`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataCollectionQuery } from "@ryuzaki13/react-foundation-api/odata";
+
+interface PlantItem {
+  CompanyCode: string;
+  CompanyName: string;
+  Plant: string;
+  PlantName: string;
+}
+
+function PlantSelect() {
+  const plants = useODataCollectionQuery<PlantItem>({
+    service: "ZREF_SRV",
+    target: "PlantSet"
+  });
+
+  if (plants.isPending) return <p>Загрузка…</p>;
+  if (plants.isError) return <p>Ошибка: {plants.error.message}</p>;
+
+  return (
+    <select>
+      {plants.data.separated.Plant.map((item) => (
+        <option key={item.Plant} value={item.Plant}>
+          {item.Plant} — {item.PlantName}
+        </option>
+      ))}
+    </select>
+  );
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Перед request хук загружает Entity metadata, поэтому code/text pairs не надо дублировать вручную.`}),`
+`,(0,c.jsx)(t.h3,{id:`odatacollectionconfig`,children:(0,c.jsx)(t.code,{children:`ODataCollectionConfig`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataServiceCollectionConfig {
+  service: string;
+  target: string;
+  limitedKeys?: readonly string[];
+  serverFilter?: FilterExpression<unknown>;
+}
+
+interface ODataCollectionConfig extends ODataServiceCollectionConfig {
+  excludeEmpty?: true;
+  sortByCode?: boolean;
+  hideCode?: true;
+  clientFilter?: (item: CollectionItem) => boolean;
+  swCache?: string;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Подробно:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Поле`}),(0,c.jsx)(t.th,{children:`Default`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`service`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsx)(t.td,{children:`Имя OData service`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`target`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsx)(t.td,{children:`Entity со справочником`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`limitedKeys`})}),(0,c.jsx)(t.td,{children:`все metadata columns`}),(0,c.jsxs)(t.td,{children:[`Ограничить `,(0,c.jsx)(t.code,{children:`$select`}),`; связанные text fields добавятся автоматически`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`serverFilter`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsxs)(t.td,{children:[`Выполнить `,(0,c.jsx)(t.code,{children:`$filter`}),` на сервере`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`excludeEmpty`})}),(0,c.jsx)(t.td,{children:`поведение lib helper`}),(0,c.jsxs)(t.td,{children:[`Исключение пустых codes при построении separated arrays; тип разрешает только `,(0,c.jsx)(t.code,{children:`true`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sortByCode`})}),(0,c.jsx)(t.td,{children:`code order`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`false`}),` создаёт observer projection, отсортированную по text`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hideCode`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsx)(t.td,{children:`UI-oriented flag; сам query его не использует`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`clientFilter`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsx)(t.td,{children:`Фильтрация уже загруженных rows до построения snapshot`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`swCache`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ttl=forever;name=ref`})}),(0,c.jsx)(t.td,{children:`Политика Service Worker cache`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Для config object желательно сохранять stable reference:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const plantOData = {
+  service: "ZREF_SRV",
+  target: "PlantSet",
+  limitedKeys: ["CompanyCode", "Plant"]
+} as const;
+
+function PlantField() {
+  const query = useODataCollectionQuery(plantOData);
+  // ...
+}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`limitedkeys-и-linked-text`,children:[(0,c.jsx)(t.code,{children:`limitedKeys`}),` и linked text`]}),`
+`,(0,c.jsx)(t.p,{children:`Допустим, вы запросили только codes:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`limitedKeys: ["CompanyCode", "Plant"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Metadata сообщает пары:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+  { codeKey: "CompanyCode", textKey: "CompanyName" },
+  { codeKey: "Plant", textKey: "PlantName" }
+]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Хук автоматически расширит `,(0,c.jsx)(t.code,{children:`$select`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`$select=CompanyCode,Plant,CompanyName,PlantName
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это защищает UI от ситуации, когда code загружен, а label отсутствует.`}),`
+`,(0,c.jsxs)(t.h3,{id:`serverfilter-и-clientfilter`,children:[(0,c.jsx)(t.code,{children:`serverFilter`}),` и `,(0,c.jsx)(t.code,{children:`clientFilter`})]}),`
+`,(0,c.jsx)(t.p,{children:`Server filter сокращает network payload:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createFilterEqual } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+const activePlants = useODataCollectionQuery({
+  service: "ZREF_SRV",
+  target: "PlantSet",
+  serverFilter: createFilterEqual("IsActive", true)
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Client filter выполняется после загрузки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const localPlants = useODataCollectionQuery({
+  service: "ZREF_SRV",
+  target: "PlantSet",
+  clientFilter: (item) => item.Plant.startsWith("1")
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Критически важная разница: `,(0,c.jsx)(t.code,{children:`serverFilter`}),` входит в query key, а `,(0,c.jsx)(t.code,{children:`clientFilter`}),` — нет.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это означает, что два consumers с одинаковыми `,(0,c.jsx)(t.code,{children:`service`}),`, `,(0,c.jsx)(t.code,{children:`target`}),`, `,(0,c.jsx)(t.code,{children:`limitedKeys`}),`, `,(0,c.jsx)(t.code,{children:`serverFilter`}),`, но разными `,(0,c.jsx)(t.code,{children:`clientFilter`}),` используют один Query cache slot и могут записать туда разные snapshots. Не создавайте разные `,(0,c.jsx)(t.code,{children:`clientFilter`}),` для одной identity. Если нужны разные projections, загружайте общий snapshot и фильтруйте через TanStack `,(0,c.jsx)(t.code,{children:`select`}),` или component `,(0,c.jsx)(t.code,{children:`useMemo`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`excludeEmpty`}),` также не входит в key и влияет на cached `,(0,c.jsx)(t.code,{children:`separated`}),`. Consumers одной identity должны использовать одинаковое значение.`]}),`
+`,(0,c.jsx)(t.h3,{id:`точный-query-key-справочника`,children:`Точный query key справочника`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createODataCollectionQueryKey } from "@ryuzaki13/react-foundation-api/odata";
+
+const key = createODataCollectionQueryKey({
+  service: "ZREF_SRV",
+  target: "PlantSet",
+  limitedKeys: ["CompanyCode", "Plant"]
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Форма key:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+  "odata",
+  "collection",
+  {
+    version: 2,
+    service: "ZREF_SRV",
+    target: "PlantSet",
+    limitedKeys: ["CompanyCode", "Plant"],
+    serverFilter: undefined
+  }
+]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Internal version отделяет snapshots разных форматов. Не собирайте key вручную.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createODataCollectionBaseQueryKey()`}),` возвращает prefix всех collection queries:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await queryClient.invalidateQueries({
+  queryKey: createODataCollectionBaseQueryKey()
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это широкая инвалидация всех справочников. Для одного справочника используйте точный key.`}),`
+`,(0,c.jsx)(t.h3,{id:`odatacollectionresult`,children:(0,c.jsx)(t.code,{children:`ODataCollectionResult`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataCollectionResult<T> {
+  items: T[];
+  keyPairs: Array<{ codeKey: string; textKey: string }>;
+  keyPairsMap: Record<string, string>;
+  separated: Record<string, T[]>;
+  chain: Array<{ codeKey: string; count: number }>;
+  count: number;
+  cacheUpdatedAt: number;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const data = query.data;
+
+data.items;
+// Все rows после clientFilter.
+
+data.keyPairs;
+// [{ codeKey: "CompanyCode", textKey: "CompanyName" }, ...]
+
+data.keyPairsMap.Plant;
+// "PlantName"
+
+data.separated.Plant;
+// Уникальные rows уровня Plant.
+
+data.chain;
+// Уровни, отсортированные от меньшего количества уникальных codes к большему.
+
+data.count;
+// Количество rows после clientFilter.
+
+data.cacheUpdatedAt;
+// Timestamp для проверки актуальности snapshot.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Transport fields `,(0,c.jsx)(t.code,{children:`ID`}),`, `,(0,c.jsx)(t.code,{children:`CNT`}),`, `,(0,c.jsx)(t.code,{children:`__metadata`}),`, `,(0,c.jsx)(t.code,{children:`__Parameters`}),` удаляются из каждого item.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки-загрузки-справочника`,children:`Ошибки загрузки справочника`}),`
+`,(0,c.jsxs)(t.p,{children:[`Низкоуровневая загрузка справочника логирует transport/parsing error и возвращает `,(0,c.jsx)(t.code,{children:`{ items: [] }`}),`. Поэтому `,(0,c.jsx)(t.code,{children:`useODataCollectionQuery`}),` может завершиться успешным пустым result вместо `,(0,c.jsx)(t.code,{children:`isError`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Практический вывод:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`пустой справочник не всегда означает, что server действительно вернул 0 rows;`}),`
+`,(0,c.jsx)(t.li,{children:`для критичных сценариев используйте metadata-aware query helper напрямую, если ошибка должна обязательно попасть в error boundary;`}),`
+`,(0,c.jsx)(t.li,{children:`проверяйте project logs/error reporting при неожиданно пустых данных.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это фактическое поведение текущего API, а не рекомендация скрывать ошибки.`}),`
+`,(0,c.jsx)(t.h3,{id:`сортировка-codetext`,children:`Сортировка code/text`}),`
+`,(0,c.jsxs)(t.p,{children:[`Query cache всегда хранит канонический порядок по code. Если `,(0,c.jsx)(t.code,{children:`sortByCode: false`}),`, hook применяет TanStack Query `,(0,c.jsx)(t.code,{children:`select`}),` и возвращает observer projection по text.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const byCode = useODataCollectionQuery({
+  service: "ZREF_SRV",
+  target: "PlantSet",
+  sortByCode: true
+});
+
+const byText = useODataCollectionQuery({
+  service: "ZREF_SRV",
+  target: "PlantSet",
+  sortByCode: false
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Оба hooks используют один network snapshot. `,(0,c.jsx)(t.code,{children:`byText`}),` не переписывает порядок `,(0,c.jsx)(t.code,{children:`byCode`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-lifetime`,children:`Query lifetime`}),`
+`,(0,c.jsx)(t.p,{children:`Collection query использует:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`staleTime = 2 часа
+gcTime    = 1 час после потери observers
+meta      = persistedQueryMeta
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Snapshot может одновременно находиться:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`в памяти QueryClient;`}),`
+`,(0,c.jsx)(t.li,{children:`в persistence storage QueryClient;`}),`
+`,(0,c.jsx)(t.li,{children:`в HTTP cache Service Worker.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это разные уровни, подробнее — в разделе о кэшах.`}),`
+`,(0,c.jsx)(t.h2,{id:`актуализация-справочников`,children:`Актуализация справочников`}),`
+`,(0,c.jsx)(t.p,{children:`Для больших справочников невыгодно постоянно скачивать всё заново. Поэтому пакет поддерживает технический endpoint с Entity, изменившимися за последние 7 дней.`}),`
+`,(0,c.jsx)(t.p,{children:`Adapter:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureODataProjectAdapter({
+  collectionUpdates: {
+    service: "ZTECH_SRV",
+    target: "CollectionUpdates",
+    baseUrl: "default"
+  }
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Expected record:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataCollectionUpdateRecord {
+  entityName: string;
+  lastChanged: string;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`useodatacollectionupdatesquery`,children:(0,c.jsx)(t.code,{children:`useODataCollectionUpdatesQuery`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataCollectionUpdatesQuery } from "@ryuzaki13/react-foundation-api/odata";
+
+function UpdatesDiagnostics() {
+  const query = useODataCollectionUpdatesQuery({
+    staleTime: 60 * 60 * 1000
+  });
+
+  return <pre>{JSON.stringify(query.data, null, 2)}</pre>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Result:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataCollectionUpdatesResult {
+  items: ODataCollectionUpdateItem[];
+  byEntityName: Record<string, ODataCollectionUpdateItem>;
+  fetchedAt: number;
+  coverageStartedAt: number;
+}
+
+interface ODataCollectionUpdateItem {
+  entityName: string;
+  lastChanged: string;
+  lastChangedAt: Date | null;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`coverageStartedAt = fetchedAt - 7 дней`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если endpoint не настроен, query остаётся активным, но возвращает успешный пустой result без network request. Collection hooks ждут завершения updates query перед своим request.`}),`
+`,(0,c.jsx)(t.p,{children:`Default:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Параметр`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`updates `,(0,c.jsx)(t.code,{children:`staleTime`})]}),(0,c.jsx)(t.td,{children:`4 часа`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`updates `,(0,c.jsx)(t.code,{children:`gcTime`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Infinity`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`updates SW policy`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ttl=4h;name=ref-updates`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`updates persistence`}),(0,c.jsxs)(t.td,{children:[`включена через `,(0,c.jsx)(t.code,{children:`persistedQueryMeta`})]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Query key содержит build id. Используйте `,(0,c.jsx)(t.code,{children:`createODataCollectionUpdatesQueryKey()`}),`, не собирайте его вручную.`]}),`
+`,(0,c.jsx)(t.h3,{id:`shouldrefreshodatacollectioncache`,children:(0,c.jsx)(t.code,{children:`shouldRefreshODataCollectionCache`})}),`
+`,(0,c.jsx)(t.p,{children:`Helper отвечает только на вопрос «нужен ли свежий snapshot?».`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { shouldRefreshODataCollectionCache } from "@ryuzaki13/react-foundation-api/odata";
+
+const shouldRefresh = shouldRefreshODataCollectionCache(
+  {
+    update: {
+      entityName: "PlantSet",
+      lastChanged: "20260821090000",
+      lastChangedAt: new Date("2026-08-21T09:00:00Z")
+    },
+    metadataUpdatedAt: Date.now(),
+    updatesCoverageStartedAt: Date.now() - 7 * 24 * 60 * 60 * 1000
+  },
+  cachedCollection
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, если выполняется хотя бы одно:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`в updates есть usable `,(0,c.jsx)(t.code,{children:`lastChangedAt`}),`, а cache отсутствует или старее;`]}),`
+`,(0,c.jsx)(t.li,{children:`metadata обновлена позже cache;`}),`
+`,(0,c.jsx)(t.li,{children:`cache отсутствует;`}),`
+`,(0,c.jsx)(t.li,{children:`cache старше окна, которое покрывает updates endpoint.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Последнее правило принципиально: если endpoint сообщает только изменения за 7 дней, отсутствие Entity в ответе ничего не доказывает для cache возрастом больше недели.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Некорректные timestamps (`,(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),`, `,(0,c.jsx)(t.code,{children:`0`}),`, отрицательные) игнорируются.`]}),`
+`,(0,c.jsx)(t.h3,{id:`resolveodatacollectionswcachepolicy`,children:(0,c.jsx)(t.code,{children:`resolveODataCollectionSwCachePolicy`})}),`
+`,(0,c.jsx)(t.p,{children:`Если snapshot нужно обновить, helper превращает обычную TTL policy в bust policy:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveODataCollectionSwCachePolicy("ttl=24h;name=ref", true);
+// "bust=24h;name=ref"
+
+resolveODataCollectionSwCachePolicy("ttl=forever;name=ref", true);
+// "bust=forever;name=ref"
+
+resolveODataCollectionSwCachePolicy("off", true);
+// "off"
+
+resolveODataCollectionSwCachePolicy("bust=1h;name=ref", true);
+// уже bust, строка не меняется
+
+resolveODataCollectionSwCachePolicy("custom-policy", true);
+// "bust=forever;name=ref"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При `,(0,c.jsx)(t.code,{children:`shouldBust === false`}),` исходная строка возвращается без изменений.`]}),`
+`,(0,c.jsx)(t.h3,{id:`public-constants`,children:`Public constants`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`ODATA_COLLECTION_UPDATES_LOOKBACK_MS;
+// 7 дней в миллисекундах
+
+ODATA_COLLECTION_DEFAULT_SW_CACHE;
+// "ttl=forever;name=ref"
+
+ODATA_COLLECTION_BUST_SW_CACHE;
+// "bust=forever;name=ref"
+
+ODATA_COLLECTION_UPDATES_SW_CACHE;
+// "ttl=4h;name=ref-updates"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не копируйте строковые значения в application code, если нужен именно package default.`}),`
+`,(0,c.jsx)(t.h2,{id:`ui-model-справочника`,children:`UI model справочника`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useODataCollectionQuery`}),` отвечает за server snapshot. `,(0,c.jsx)(t.code,{children:`useODataCollection`}),` добавляет локальные операции для select/listbox/virtualized UI.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odatacollectionmodel`,children:(0,c.jsx)(t.code,{children:`ODataCollectionModel`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataCollectionModel {
+  codeKey: string;
+  minSearchTextLength?: number;
+  minSearchCodeLength?: number;
+  searchDebounceDelay?: number;
+  maxVisibleItems?: number;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`useodatacollectionmodel`,children:(0,c.jsx)(t.code,{children:`useODataCollectionModel`})}),`
+`,(0,c.jsx)(t.p,{children:`Подставляет defaults из общего collection store и фиксирует model на весь lifecycle component:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataCollectionModel } from "@ryuzaki13/react-foundation-api/odata";
+
+const model = useODataCollectionModel({
+  codeKey: "Plant",
+  maxVisibleItems: 100,
+  minSearchCodeLength: 1,
+  minSearchTextLength: 2,
+  searchDebounceDelay: 250
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Последующие изменения переданного object не пересоздают stable model. Рассматривайте вход как initial config, а не reactive props.`}),`
+`,(0,c.jsx)(t.h3,{id:`useodatacollection`,children:(0,c.jsx)(t.code,{children:`useODataCollection`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import {
+  useODataCollection,
+  useODataCollectionModel
+} from "@ryuzaki13/react-foundation-api/odata";
+
+function PlantList() {
+  const model = useODataCollectionModel({
+    codeKey: "Plant",
+    maxVisibleItems: 50
+  });
+
+  const collection = useODataCollection({
+    odata: {
+      service: "ZREF_SRV",
+      target: "PlantSet"
+    },
+    model,
+    pageSize: 25
+  });
+
+  const visible = collection.getItems(
+    (code, text) => code.startsWith("1") || text.toLowerCase().includes("завод")
+  );
+
+  return (
+    <ul>
+      {visible.map((item) => (
+        <li key={item.Plant}>{item.PlantName}</li>
+      ))}
+    </ul>
+  );
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Result 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:`Поле/action`}),(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:`data`})}),(0,c.jsxs)(t.td,{children:[`Raw `,(0,c.jsx)(t.code,{children:`ODataCollectionResult`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`isLoading`}),`, `,(0,c.jsx)(t.code,{children:`isError`})]}),(0,c.jsx)(t.td,{children:`Query state`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`codeKey`})}),(0,c.jsx)(t.td,{children:`Активное code field из model`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`textKey`})}),(0,c.jsx)(t.td,{children:`Linked text field из metadata`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getItems(predicate?, selected?)`})}),(0,c.jsxs)(t.td,{children:[`Получить не более `,(0,c.jsx)(t.code,{children:`maxVisibleItems`}),`, учесть dependencies и выбранные rows`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findSourceItemsByKeys(field, keys)`})}),(0,c.jsxs)(t.td,{children:[`Найти rows полного `,(0,c.jsx)(t.code,{children:`items`}),` по значениям произвольного field`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`setFilteredItems(items?)`})}),(0,c.jsx)(t.td,{children:`Ограничить активный code level набором dependency rows`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getPage(pageIndex)`})}),(0,c.jsxs)(t.td,{children:[`Slice по `,(0,c.jsx)(t.code,{children:`pageSize`}),` для virtualization`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildSearchIndex(field)`})}),(0,c.jsx)(t.td,{children:`Построить prefix index длиной от 1 до 5 symbols`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`debounce(key, fn, delay?)`})}),(0,c.jsx)(t.td,{children:`Независимый timer по string key`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`itemsMap`})}),(0,c.jsx)(t.td,{children:`Map active code → row`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`separatedItems`})}),(0,c.jsx)(t.td,{children:`Rows active code level`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`orderedKeys`})}),(0,c.jsx)(t.td,{children:`Codes в текущем порядке`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`totalCount`})}),(0,c.jsx)(t.td,{children:`Размер active separated level`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pageSize`})}),(0,c.jsx)(t.td,{children:`Фактический размер page`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getItems`}),` исключает rows, уже переданные в `,(0,c.jsx)(t.code,{children:`currentSelectedKeys`}),`, применяет dependencies, затем predicate и останавливается на лимите.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`setFilteredItems(undefined)`}),` или пустой массив снимает dependency filter.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildSearchIndex`}),` индексирует lowercase prefixes максимум до 5 symbols. Для поиска по более длинной строке используйте первые 5 symbols для получения candidates, затем точный predicate.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поле `,(0,c.jsx)(t.code,{children:`filter`}),` во входных props в текущей реализации не используется. Не полагайтесь на него; фильтруйте через `,(0,c.jsx)(t.code,{children:`odata.clientFilter`}),`, `,(0,c.jsx)(t.code,{children:`getItems(predicate)`}),` или собственную projection.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`refetch`}),` и `,(0,c.jsx)(t.code,{children:`invalidate`}),` в result помечены deprecated. Для явного управления используйте `,(0,c.jsx)(t.code,{children:`QueryClient`}),` и public key factory.`]}),`
+`,(0,c.jsx)(t.h2,{id:`chains-зависимых-справочников`,children:`Chains зависимых справочников`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`chain`}),` помогает расположить связанные filters от самого узкого уровня к самому широкому. Например:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+  { codeKey: "CompanyCode", count: 3 },
+  { codeKey: "Plant", count: 24 },
+  { codeKey: "StorageLocation", count: 180 }
+]
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`useodatacollectionchains`,children:(0,c.jsx)(t.code,{children:`useODataCollectionChains`})}),`
+`,(0,c.jsx)(t.p,{children:`Хук читает chains нескольких collection snapshots и подписывается на изменения Query cache:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataCollectionChains } from "@ryuzaki13/react-foundation-api/odata";
+
+const services = [
+  { service: "ZREF_SRV", target: "PlantSet" },
+  { service: "ZREF_SRV", target: "MaterialSet" }
+] as const;
+
+function ChainsView() {
+  const chains = useODataCollectionChains([...services]);
+
+  return <pre>{JSON.stringify(chains, null, 2)}</pre>;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Map key имеет форму `,(0,c.jsx)(t.code,{children:`service.target`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  "ZREF_SRV.PlantSet": [
+    { codeKey: "CompanyCode", count: 3 },
+    { codeKey: "Plant", count: 24 }
+  ]
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Хук не загружает справочники сам. Он наблюдает только snapshots, которые уже появились в QueryClient.`}),`
+`,(0,c.jsx)(t.h2,{id:`зависимые-odata-segments`,children:`Зависимые OData segments`}),`
+`,(0,c.jsx)(t.p,{children:`Segment описывает один level сложного справочника.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataCollectionSegment {
+  placeholder: string;
+  hideCode?: true;
+  selectText?: true;
+}
+
+interface ODataDependentSegment extends ODataCollectionSegment {
+  panelVisibility?: "user" | "always" | "none";
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Значения `,(0,c.jsx)(t.code,{children:`panelVisibility`}),`:`]}),`
+`,(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:`user`})}),(0,c.jsx)(t.td,{children:`Видимость определяется пользовательским вариантом; default`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`always`})}),(0,c.jsx)(t.td,{children:`Segment всегда показывается в общей filter panel`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`none`})}),(0,c.jsx)(t.td,{children:`Segment не показывается в panel`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`selectText: true`}),` означает, что selected value должен быть text, а не code. Это контракт для UI consumer; сам transport ничего не меняет.`]}),`
+`,(0,c.jsx)(t.h3,{id:`flattenodatadependentservices`,children:(0,c.jsx)(t.code,{children:`flattenODataDependentServices`})}),`
+`,(0,c.jsx)(t.p,{children:`На входе services сгруппированы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dependentServices = [
+  {
+    odata: {
+      service: "ZREF_SRV",
+      target: "PlantSet"
+    },
+    segments: {
+      CompanyCode: {
+        placeholder: "Компания",
+        panelVisibility: "always"
+      },
+      Plant: {
+        placeholder: "Завод"
+      }
+    },
+    model: {
+      maxVisibleItems: 100
+    }
+  }
+] as const;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция делает flat segment list:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { flattenODataDependentServices } from "@ryuzaki13/react-foundation-api/odata";
+
+const segments = flattenODataDependentServices(dependentServices);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждый `,(0,c.jsx)(t.code,{children:`ODataDependentSegmentItem`}),` содержит:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ODataDependentSegmentItem {
+  id: string;
+  serviceKey: string;
+  serviceIndex: number;
+  segmentIndex: number;
+  odata: ODataCollectionConfig;
+  segment: ODataDependentSegment;
+  model: ODataCollectionModel;
+  panelVisibility: ControlPanelVisibility;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`model.codeKey`}),` автоматически равен id segment. `,(0,c.jsx)(t.code,{children:`serviceKey`}),` строится как `,(0,c.jsx)(t.code,{children:`service.target`}),`. Индексы сохраняют исходный стабильный порядок.`]}),`
+`,(0,c.jsx)(t.h3,{id:`sortodatadependentsegmentitemsbychains`,children:(0,c.jsx)(t.code,{children:`sortODataDependentSegmentItemsByChains`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { sortODataDependentSegmentItemsByChains } from "@ryuzaki13/react-foundation-api/odata";
+
+const ordered = sortODataDependentSegmentItemsByChains(
+  segments,
+  {
+    "ZREF_SRV.PlantSet": [
+      { codeKey: "CompanyCode", count: 3 },
+      { codeKey: "Plant", count: 24 }
+    ]
+  },
+  ["Plant"]
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Порядок без override:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Исходный порядок services.`}),`
+`,(0,c.jsx)(t.li,{children:`Внутри service — chain order для известных ids.`}),`
+`,(0,c.jsx)(t.li,{children:`Segment, присутствующие в chain, идут раньше неизвестных.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Неизвестные сохраняют исходный `,(0,c.jsx)(t.code,{children:`segmentIndex`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Полная стабильность обеспечивается исходным flat index.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`orderOverrideIds`}),` поднимает указанные ids в заданном порядке. Дубликаты удаляются, неизвестные ids игнорируются, остальные segments сохраняют base order.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`sortODataDependentServicesByChains`}),` оставлен как deprecated API старой service-level модели. Для нового кода сначала flatten, затем сортируйте segment items.`]}),`
+`,(0,c.jsx)(t.h2,{id:`odata-metadata--table-columns`,children:`OData metadata → Table columns`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useODataTableColumns`}),` связывает metadata с helpers модуля `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/table`}),`. Есть два режима.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-build`,children:[`Режим `,(0,c.jsx)(t.code,{children:`build`})]}),`
+`,(0,c.jsx)(t.p,{children:`Генерирует columns только по metadata:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useODataTableColumns } from "@ryuzaki13/react-foundation-api/odata";
+
+interface SalesOrderRow {
+  SalesOrderId: string;
+  NetAmount: number;
+  CreatedAt: Date;
+}
+
+function SalesOrderTable() {
+  const { columns, defaultColumnVisibility, isLoading } =
+    useODataTableColumns<SalesOrderRow>({
+      mode: "build",
+      service: "ZSALES_SRV",
+      target: "SalesOrderSet",
+      resolveHeader: (column) =>
+        column.id === "SalesOrderId" ? "Заказ" : column.label ?? column.id,
+      resolveVisible: (column) => column.id !== "InternalStatus",
+      resolveFormatting: (column) => {
+        if (column.id === "NetAmount") {
+          return { role: "number" };
+        }
+
+        return undefined;
+      }
+    });
+
+  if (isLoading) return <p>Подготовка columns…</p>;
+
+  return (
+    <Table
+      columns={columns}
+      initialState={{ columnVisibility: defaultColumnVisibility }}
+    />
+  );
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Callback purposes:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Callback`}),(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:`resolveHeader(column)`})}),(0,c.jsx)(t.td,{children:`Переопределить header generated column`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveVisible(column)`})}),(0,c.jsx)(t.td,{children:`Сформировать initial visibility`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveFormatting(column)`})}),(0,c.jsx)(t.td,{children:`Добавить typed formatting metadata`})]})]})]}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-enrich`,children:[`Режим `,(0,c.jsx)(t.code,{children:`enrich`})]}),`
+`,(0,c.jsx)(t.p,{children:`Сохраняет ваши columns, но дополняет их OData formatting context:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const baseColumns = [
+  {
+    accessorKey: "SalesOrderId",
+    header: "Заказ"
+  },
+  {
+    accessorKey: "NetAmount",
+    header: "Сумма"
+  }
+] as const;
+
+const table = useODataTableColumns<SalesOrderRow>({
+  mode: "enrich",
+  service: "ZSALES_SRV",
+  target: "SalesOrderSet",
+  columns: baseColumns
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В режиме `,(0,c.jsx)(t.code,{children:`enrich`}),` initial visibility возвращается только для leaf columns, которые удалось сопоставить с metadata по stable column id. Group columns обходятся рекурсивно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`result`,children:`Result`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface UseODataTableColumnsResult<TData extends object> {
+  columns: TableColumnDef<TData>[];
+  defaultColumnVisibility: Record<string, boolean> | undefined;
+  metadata: EntityMetadata | undefined;
+  isLoading: boolean;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`До загрузки metadata:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`build`}),` возвращает пустой `,(0,c.jsx)(t.code,{children:`columns`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`enrich`}),` возвращает shallow copy входных columns;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`defaultColumnVisibility`}),` равен `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`metadata`}),` равна `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не сохраняйте `,(0,c.jsx)(t.code,{children:`defaultColumnVisibility`}),` обратно в metadata. Это стартовое состояние TanStack Table, которое пользователь затем может менять отдельно.`]}),`
+`,(0,c.jsx)(t.h2,{id:`автоматическое-восстановление-sso`,children:`Автоматическое восстановление SSO`}),`
+`,(0,c.jsxs)(t.p,{children:[`SAP Gateway иногда вместо OData JSON возвращает redirect или HTML-форму ADFS/SSO. Если обычный JSON parser попытается разобрать такой ответ, разработчик увидит непонятную ошибку вида «Unexpected token `,(0,c.jsx)(t.code,{children:`<`}),`». Transport распознаёт этот сценарий и пытается восстановить session.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-распознаётся-sso`,children:`Как распознаётся SSO`}),`
+`,(0,c.jsx)(t.p,{children:`Есть два основных сигнала:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`При `,(0,c.jsx)(t.code,{children:`redirect: "manual"`}),` browser возвращает response с `,(0,c.jsx)(t.code,{children:`type === "opaqueredirect"`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Response body выглядит как HTML и содержит form с input `,(0,c.jsx)(t.code,{children:`SAMLRequest`}),` или `,(0,c.jsx)(t.code,{children:`SAMLResponse`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не любая HTML-форма считается SSO. Проверка намеренно узкая:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { isSsoForm } from "@ryuzaki13/react-foundation-api/odata";
+
+isSsoForm({
+  action: "/adfs/ls/",
+  method: "POST",
+  inputs: { SAMLRequest: "..." }
+});
+// true
+
+isSsoForm({
+  action: "/login",
+  method: "POST",
+  inputs: { username: "" }
+});
+// false
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ssoform`,children:(0,c.jsx)(t.code,{children:`SsoForm`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SsoForm = {
+  action: string;
+  method: string;
+  inputs: Record<string, string>;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`inputs`}),` могут содержать чувствительные одноразовые SAML values. Не выводите весь object в console и не добавляйте его в analytics/error report.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ssorequirederror`,children:(0,c.jsx)(t.code,{children:`SsoRequiredError`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { SsoRequiredError } from "@ryuzaki13/react-foundation-api/odata";
+
+try {
+  await fetchODataJson("/ZSALES_SRV/SalesOrderSet");
+} catch (error) {
+  if (error instanceof SsoRequiredError) {
+    console.error(error.message, {
+      recoverable: error.recoverable,
+      hasForm: Boolean(error.form),
+      hasRecoveryUrl: Boolean(error.recoveryUrl)
+    });
+  }
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Instance fields:`}),`
+`,(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:`message`})}),(0,c.jsx)(t.td,{children:`Человекочитаемая причина`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`form`})}),(0,c.jsx)(t.td,{children:`Извлечённая SAML form, если была в HTML`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`recoveryUrl`})}),(0,c.jsx)(t.td,{children:`URL для iframe navigation, если был redirect`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`recoverable`})}),(0,c.jsx)(t.td,{children:`Можно ли transport-у повторить automatic recovery`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Default `,(0,c.jsx)(t.code,{children:`recoverable`}),` равен `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`automatic-recovery-lifecycle`,children:`Automatic recovery lifecycle`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`OData request
+    │
+    ├─ normal JSON ───────────────────────────────► success
+    │
+    └─ redirect / SAML form
+             │
+             ▼
+      hidden iframe recovery
+             │
+             ▼
+        retry request once
+             │
+             ├─ success ─────────────────────────► success
+             │
+             └─ SSO снова требуется
+                       │
+                       ▼
+             unrecoverable SsoRequiredError
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Transport использует глобальный gate:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`несколько одновременных SAP requests не создают несколько recovery iframes;`}),`
+`,(0,c.jsx)(t.li,{children:`первый request запускает recovery;`}),`
+`,(0,c.jsx)(t.li,{children:`остальные ждут тот же promise;`}),`
+`,(0,c.jsx)(t.li,{children:`после успешного gate каждый request повторяется;`}),`
+`,(0,c.jsx)(t.li,{children:`если recovery или retry снова потребовал SSO, transport блокирует последующие SAP requests unrecoverable error до reload страницы.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Такое блокирование защищает от бесконечного цикла redirect → iframe → retry.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ssoRetried`}),` в `,(0,c.jsx)(t.code,{children:`RequestInitType`}),` — внутренняя метка одного retry. Не выставляйте её в application code.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-означает-завершение-iframe`,children:`Что означает завершение iframe`}),`
+`,(0,c.jsxs)(t.p,{children:[`Recovery promise завершается после `,(0,c.jsx)(t.code,{children:`load`}),` или `,(0,c.jsx)(t.code,{children:`error`}),` iframe и короткой settle delay. Само событие iframe ещё не доказывает, что authentication успешна. Истинная проверка — повторный OData request.`]}),`
+`,(0,c.jsx)(t.h3,{id:`recoverssosession`,children:(0,c.jsx)(t.code,{children:`recoverSsoSession`})}),`
+`,(0,c.jsx)(t.p,{children:`Обычно вызывается автоматически. Public function полезна для диагностического или controlled flow:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { recoverSsoSession } from "@ryuzaki13/react-foundation-api/odata";
+
+const recovered = await recoverSsoSession({
+  recoveryUrl: "/sap/opu/odata/sap/ZSALES_SRV/"
+});
+
+if (!recovered) {
+  // Среда без window/document либо recovery target отсутствует.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Или с form:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const recovered = await recoverSsoSession({
+  form: {
+    action: "/adfs/ls/",
+    method: "POST",
+    inputs: {
+      SAMLRequest: samlRequest
+    }
+  }
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Одновременные ручные вызовы также переиспользуют один promise.`}),`
+`,(0,c.jsxs)(t.p,{children:[`В SSR/Node без `,(0,c.jsx)(t.code,{children:`window`}),` функция возвращает `,(0,c.jsx)(t.code,{children:`false`}),`. Основной runtime модуля — browser SPA.`]}),`
+`,(0,c.jsx)(t.h3,{id:`submitssoform`,children:(0,c.jsx)(t.code,{children:`submitSsoForm`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Низкоуровневая imperative function создаёт hidden iframe и form, монтирует их в document и вызывает `,(0,c.jsx)(t.code,{children:`form.submit()`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { submitSsoForm } from "@ryuzaki13/react-foundation-api/odata";
+
+const submitted = submitSsoForm(ssoForm);
+
+if (!submitted) {
+  // Нет document/body либо form не является SAML form.
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это явный browser side effect. Для обычного OData request не вызывайте её — automatic recovery уже встроено в `,(0,c.jsx)(t.code,{children:`fetchBase`}),`/`,(0,c.jsx)(t.code,{children:`fetchODataJson`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`csrf-для-sap-write-operations`,children:`CSRF для SAP write operations`}),`
+`,(0,c.jsx)(t.p,{children:`SAP Gateway требует CSRF token для изменяющих requests. Transport управляет token автоматически.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Write определяется как любой method, кроме `,(0,c.jsx)(t.code,{children:`GET`}),` и `,(0,c.jsx)(t.code,{children:`HEAD`}),`. Следовательно, token запрашивается для `,(0,c.jsx)(t.code,{children:`POST`}),`, `,(0,c.jsx)(t.code,{children:`PUT`}),`, `,(0,c.jsx)(t.code,{children:`PATCH`}),`, `,(0,c.jsx)(t.code,{children:`DELETE`}),` и других custom write methods, если request распознан как SAP.`]}),`
+`,(0,c.jsx)(t.h3,{id:`полный-lifecycle`,children:`Полный lifecycle`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`POST /ZSALES_SRV/SalesOrderSet
+        │
+        ▼
+CSRF token уже есть в memory cache?
+        │
+   ┌────┴────┐
+  да        нет
+   │          │
+   │          ▼
+   │   GET /ZSALES_SRV/
+   │   x-csrf-token: Fetch
+   │          │
+   │          ▼
+   │      сохранить token
+   └────┬─────┘
+        ▼
+write request + x-csrf-token
+        │
+        ├─ 2xx ───────────────────────────────► success
+        │
+        └─ 401/403
+             │
+             ▼
+       удалить cached token
+             │
+             ▼
+       запросить новый token
+             │
+             ▼
+          retry once
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`token-scope`,children:`Token scope`}),`
+`,(0,c.jsx)(t.p,{children:`Для обычного OData scope включает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`baseUrlType + sapClient + serviceName
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Например:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`odata:100:ZSALES_SRV
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это не позволяет случайно использовать token одного сервиса/mandant для другого.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`baseUrl: "config"`}),` scope строится из application id и SAP client, а token загружается с `,(0,c.jsx)(t.code,{children:`/Statistics`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`deduplication`,children:`Deduplication`}),`
+`,(0,c.jsx)(t.p,{children:`Пакет хранит отдельно:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`готовые tokens;`}),`
+`,(0,c.jsx)(t.li,{children:`promises уже идущих token requests.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если пять mutations стартовали одновременно без token, network получит один token request, а остальные дождутся его результата.`}),`
+`,(0,c.jsx)(t.h3,{id:`headers-token-request`,children:`Headers token request`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`x-csrf-token: Fetch
+sap-language: ru
+sap-contextid-accept: header
+Accept-Language: ru
+sap-client: <client>, если определён
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Credentials всегда `,(0,c.jsx)(t.code,{children:`include`}),`, redirect для SAP — `,(0,c.jsx)(t.code,{children:`manual`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-должен-делать-application-code`,children:`Что должен делать application code`}),`
+`,(0,c.jsx)(t.p,{children:`Ничего из следующего делать не надо:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Не нужно и не следует:
+let csrfToken: string;
+localStorage.setItem("csrf", csrfToken);
+headers.set("x-csrf-token", csrfToken);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Достаточно использовать metadata-aware mutation helper или `,(0,c.jsx)(t.code,{children:`fetchBase`}),` с write method. Token живёт только во внутреннем memory cache и не сохраняется в localStorage/IndexedDB.`]}),`
+`,(0,c.jsx)(t.h2,{id:`четыре-разных-уровня-кэширования`,children:`Четыре разных уровня кэширования`}),`
+`,(0,c.jsx)(t.p,{children:`В OData-сценарии слово «кэш» может означать разные механизмы. Их нельзя смешивать.`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Уровень`}),(0,c.jsx)(t.th,{children:`Что хранит`}),(0,c.jsx)(t.th,{children:`Identity`}),(0,c.jsx)(t.th,{children:`Кто управляет`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`TanStack Query memory cache`}),(0,c.jsx)(t.td,{children:`Parsed backend snapshot и query state`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`queryKey`})}),(0,c.jsx)(t.td,{children:`QueryClient/application`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Query persistence`}),(0,c.jsx)(t.td,{children:`Разрешённые snapshots между reload`}),(0,c.jsxs)(t.td,{children:[`Тот же `,(0,c.jsx)(t.code,{children:`queryKey`}),` + persister policy`]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`query-client`}),` package`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Cross-tab broadcast`}),(0,c.jsx)(t.td,{children:`События/синхронизация между tabs`}),(0,c.jsx)(t.td,{children:`Query contract`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`query-client`}),` package`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Service Worker runtime cache`}),(0,c.jsx)(t.td,{children:`HTTP Response`}),(0,c.jsx)(t.td,{children:`URL + SW policy`}),(0,c.jsx)(t.td,{children:`Service Worker`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Browser HTTP cache может существовать дополнительно, но модуль не использует его как application state.`}),`
+`,(0,c.jsx)(t.h3,{id:`tanstack-query-cache`,children:`TanStack Query cache`}),`
+`,(0,c.jsx)(t.p,{children:`Это главный владелец server snapshots в React application:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const queryKey = ["sales-orders", { companyId }] as const;
+
+const data = queryClient.getQueryData(queryKey);
+await queryClient.invalidateQueries({ queryKey });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`все inputs, меняющие server result, должны входить в key;`}),`
+`,(0,c.jsx)(t.li,{children:`query data — backend snapshot, не mutable form draft;`}),`
+`,(0,c.jsx)(t.li,{children:`не мутируйте object/array на месте;`}),`
+`,(0,c.jsx)(t.li,{children:`mutation должна явно invalidировать или обновить затронутые keys.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-persistence`,children:`Query persistence`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),` разрешает инфраструктуре QueryClient сохранять query. Metadata, справочники и список их обновлений используют этот marker.`]}),`
+`,(0,c.jsx)(t.p,{children:`Persistence не означает вечную актуальность. После восстановления snapshot проверяется version/updates logic.`}),`
+`,(0,c.jsx)(t.p,{children:`Не сохраняйте auth tokens и SAML payload в query data.`}),`
+`,(0,c.jsx)(t.h3,{id:`cross-tab-broadcast`,children:`Cross-tab broadcast`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если project QueryClient настроен на broadcast, изменения cache могут синхронизироваться между вкладками. Сам `,(0,c.jsx)(t.code,{children:`odata`}),` module не создаёт broadcast channel. Он только соблюдает stable query contracts.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`service-worker-cache-и-x-sw-cache`,children:[`Service Worker cache и `,(0,c.jsx)(t.code,{children:`x-sw-cache`})]}),`
+`,(0,c.jsx)(t.p,{children:`OData transport только выставляет header:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`x-sw-cache: ttl=24h;max=100;name=ui
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Интерпретация header принадлежит Service Worker policy проекта. Если Service Worker не установлен или не понимает policy, header сам по себе ничего не кэширует.`}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Policy`}),(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:`off`})}),(0,c.jsx)(t.td,{children:`Network-only`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ttl=10m`})}),(0,c.jsx)(t.td,{children:`Cache с TTL 10 минут`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ttl=24h;max=200;name=ui`})}),(0,c.jsx)(t.td,{children:`Именованный cache с TTL и лимитом`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ttl=forever;name=ref`})}),(0,c.jsx)(t.td,{children:`Долгоживущий reference cache`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`bust=24h;name=ref`})}),(0,c.jsx)(t.td,{children:`Принудительно обновить запись из network`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для auth-sensitive или user-specific responses безопасный default — `,(0,c.jsx)(t.code,{children:`off`}),`, если Service Worker policy не доказывает корректное разделение users/sessions. Не применяйте broad shared caching только ради скорости.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`swcache-в-разных-apis`,children:[(0,c.jsx)(t.code,{children:`swCache`}),` в разных APIs`]}),`
+`,(0,c.jsx)(t.p,{children:`У metadata-aware helper есть два места, но итог один:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataQueryFn({
+  odata,
+  options: {
+    top: 100
+  },
+  swCache: "ttl=5m;name=sales"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`У low-level `,(0,c.jsx)(t.code,{children:`odataFetch`}),` policy находится внутри options:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataFetch("/ZSALES_SRV/SalesOrderSet", {
+  top: 100,
+  swCache: "ttl=5m;name=sales"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`У `,(0,c.jsx)(t.code,{children:`fetchQueryFn`}),` — рядом с `,(0,c.jsx)(t.code,{children:`init`}),` и `,(0,c.jsx)(t.code,{children:`transform`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`обработка-ошибок`,children:`Обработка ошибок`}),`
+`,(0,c.jsx)(t.h3,{id:`http-json-error`,children:`HTTP JSON error`}),`
+`,(0,c.jsx)(t.p,{children:`Transport пытается собрать полезное сообщение из OData/JSON payload в таком порядке:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`строковый `,(0,c.jsx)(t.code,{children:`error`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error.code`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error.message.value`}),` или `,(0,c.jsx)(t.code,{children:`error.message`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`top-level `,(0,c.jsx)(t.code,{children:`details`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`top-level `,(0,c.jsx)(t.code,{children:`message`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Повторы удаляются, части соединяются через `,(0,c.jsx)(t.code,{children:`|`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример response:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-json`,children:`{
+  "error": {
+    "code": "ZSALES/001",
+    "message": {
+      "value": "Заказ заблокирован"
+    }
+  }
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Error message:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`ZSALES/001 | Заказ заблокирован
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если подходящего поля нет, fallback:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`HTTP error: 500 Internal Server Error
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`plain-text-error`,children:`Plain text error`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для не-JSON response непустой text становится `,(0,c.jsx)(t.code,{children:`Error.message`}),`. Поэтому UI не должен слепо рендерить HTML через `,(0,c.jsx)(t.code,{children:`dangerouslySetInnerHTML`}),`; transport возвращает обычную строку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`networkcors`,children:`Network/CORS`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для response status `,(0,c.jsx)(t.code,{children:`0`}),` формируется сообщение:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Ошибка сети или CORS. Проверьте подключение и настройки сервера.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Browser может выбросить `,(0,c.jsx)(t.code,{children:`TypeError`}),` до создания Response. Такой error пробрасывается как есть.`]}),`
+`,(0,c.jsx)(t.h3,{id:`unexpected-html`,children:`Unexpected HTML`}),`
+`,(0,c.jsx)(t.p,{children:`Если HTML не содержит SAML form, transport:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Создаёт `,(0,c.jsx)(t.code,{children:`Error("Unexpected HTML response from OData endpoint")`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Передаёт безопасный summary в error-report infrastructure.`}),`
+`,(0,c.jsx)(t.li,{children:`Выбрасывает error consumer-у.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`В report попадает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`request/response URL без query string;`}),`
+`,(0,c.jsx)(t.li,{children:`method, base URL type, SAP client;`}),`
+`,(0,c.jsx)(t.li,{children:`status и status text;`}),`
+`,(0,c.jsx)(t.li,{children:`content type, redirect flag, response type;`}),`
+`,(0,c.jsx)(t.li,{children:`длина HTML;`}),`
+`,(0,c.jsx)(t.li,{children:`title не длиннее 200 symbols;`}),`
+`,(0,c.jsx)(t.li,{children:`количество forms;`}),`
+`,(0,c.jsx)(t.li,{children:`до 40 уникальных input names;`}),`
+`,(0,c.jsx)(t.li,{children:`text preview не длиннее 1000 symbols.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`В report не передаются:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`полный raw HTML;`}),`
+`,(0,c.jsx)(t.li,{children:`query string URL;`}),`
+`,(0,c.jsx)(t.li,{children:`значения hidden inputs;`}),`
+`,(0,c.jsx)(t.li,{children:`SAMLRequest/SAMLResponse values.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это снижает риск утечки credentials/tokens в diagnostic channel.`}),`
+`,(0,c.jsx)(t.h3,{id:`unsupported-body`,children:`Unsupported body`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если Content-Type не JSON, body не HTML и `,(0,c.jsx)(t.code,{children:`JSON.parse(text)`}),` не удался:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Unsupported response content type and body is not JSON
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-metadata-aware-validation`,children:`Ошибка metadata-aware validation`}),`
+`,(0,c.jsx)(t.p,{children:`До network request helper может сообщить:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`target не найден;`}),`
+`,(0,c.jsx)(t.li,{children:`Entity использована как FunctionImport или наоборот;`}),`
+`,(0,c.jsx)(t.li,{children:`operation несовместима с target;`}),`
+`,(0,c.jsx)(t.li,{children:`FunctionImport не содержит HTTP method;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствуют обязательные params;`}),`
+`,(0,c.jsx)(t.li,{children:`plain read пытается использовать parameterized Entity;`}),`
+`,(0,c.jsx)(t.li,{children:`body имеет неправильную форму.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Такая ошибка обычно означает проблему application contract, а не временный network failure. Не запускайте бессмысленные automatic retries для неё.`}),`
+`,(0,c.jsx)(t.h3,{id:`error-handling-в-react`,children:`Error handling в React`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function SalesOrders() {
+  const query = useQuery(salesOrdersQueryOptions({ companyId: "1000" }));
+
+  if (query.isPending) return <Spinner />;
+
+  if (query.isError) {
+    return (
+      <ErrorPanel
+        title="Не удалось загрузить заказы"
+        description={query.error.message}
+        onRetry={() => query.refetch()}
+      />
+    );
+  }
+
+  return <SalesOrderTable rows={query.data} />;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для mutation показывайте feedback на уровне пользовательского действия и не очищайте draft при ошибке.`}),`
+`,(0,c.jsx)(t.h2,{id:`abort-и-concurrency`,children:`Abort и concurrency`}),`
+`,(0,c.jsx)(t.h3,{id:`query-cancellation`,children:`Query cancellation`}),`
+`,(0,c.jsxs)(t.p,{children:[`TanStack Query передаёт `,(0,c.jsx)(t.code,{children:`signal`}),` в query function. Передайте его metadata-aware runner:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryFn: ({ signal, client }) =>
+  odataQueryFn<RawRow>({ odata })({ client, signal })
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если request отменён, browser fetch завершится AbortError. Это не обязательно application error; TanStack Query умеет корректно учитывать cancellation.`}),`
+`,(0,c.jsx)(t.h3,{id:`caller-provided-signal`,children:`Caller-provided signal`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchQueryFn`}),` добавляет query signal только когда `,(0,c.jsx)(t.code,{children:`init.signal`}),` не задан. Явный caller signal имеет приоритет.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждый запуск получает новый clone `,(0,c.jsx)(t.code,{children:`init`}),`, поэтому отменённый signal предыдущего refetch не «заражает» следующий.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mutation-cancellation`,children:`Mutation cancellation`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useMutation`}),` не передаёт AbortSignal автоматически как query. Если сценарий требует cancel, создайте `,(0,c.jsx)(t.code,{children:`AbortController`}),` на уровне feature и передайте `,(0,c.jsx)(t.code,{children:`controller.signal`}),` runner-у.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не переиспользуйте один уже aborted controller для следующей mutation.`}),`
+`,(0,c.jsx)(t.h2,{id:`security-checklist`,children:`Security checklist`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Используйте только public import `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не сохраняйте CSRF/SAML values в localStorage, query cache или logs.`}),`
+`,(0,c.jsx)(t.li,{children:`Не вставляйте server HTML в DOM.`}),`
+`,(0,c.jsx)(t.li,{children:`Не передавайте user input в raw OData URL; стройте filters/params через typed helpers lib-пакета.`}),`
+`,(0,c.jsx)(t.li,{children:`Не считайте TypeScript generic runtime validation.`}),`
+`,(0,c.jsx)(t.li,{children:`Не включайте SW cache для user-specific данных без явной cache policy.`}),`
+`,(0,c.jsx)(t.li,{children:`Не собирайте metadata/function path строковой конкатенацией.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Не отключайте `,(0,c.jsx)(t.code,{children:`credentials: "include"`}),` для SAP request: transport управляет cookies централизованно.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не отправляйте mutation через GET только ради обхода CSRF; HTTP method определяется service metadata/operation contract.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Не выводите `,(0,c.jsx)(t.code,{children:`body`}),` и params с secrets при использовании Dev helpers.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`deprecated-api`,children:`Deprecated API`}),`
+`,(0,c.jsx)(t.p,{children:`Следующие helpers остаются public, но новый код на них строить не следует:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(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:`fetchJsonQueryFn`})}),(0,c.jsx)(t.td,{children:`Не использует metadata-aware target contract`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`odataQueryFn`}),` или `,(0,c.jsx)(t.code,{children:`fetchQueryFn`}),` для не-OData response`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchJsonMutationFn`})}),(0,c.jsx)(t.td,{children:`Raw URL и слабый operation contract`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`odataCreateFn`}),`, `,(0,c.jsx)(t.code,{children:`odataUpdateFn`}),`, `,(0,c.jsx)(t.code,{children:`odataFunctionImportFn`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchDeleteFn`})}),(0,c.jsx)(t.td,{children:`Raw URL, не валидирует Entity keys`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataDeleteFn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sortODataDependentServicesByChains`})}),(0,c.jsx)(t.td,{children:`Старая service-level сортировка`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`flattenODataDependentServices`}),` + `,(0,c.jsx)(t.code,{children:`sortODataDependentSegmentItemsByChains`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataCollection(...).refetch`})}),(0,c.jsx)(t.td,{children:`Imperative method старой UI model`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`QueryClient`}),` + key factory`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataCollection(...).invalidate`})}),(0,c.jsx)(t.td,{children:`Imperative method старой UI model`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`QueryClient.invalidateQueries`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Deprecated не означает «сломано сегодня». Это означает, что API может быть удалён и не должен распространяться на новые modules.`}),`
+`,(0,c.jsx)(t.h3,{id:`legacy-examples-только-для-миграции`,children:`Legacy examples только для миграции`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Было
+const load = fetchJsonQueryFn<RawOrder[]>(
+  "/ZSALES_SRV/SalesOrderSet"
+);
+
+// Стало
+const load = odataQueryFn<RawOrder>({
+  odata: {
+    service: "ZSALES_SRV",
+    target: "SalesOrderSet"
+  }
+});
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Было
+const remove = fetchDeleteFn(
+  "/ZSALES_SRV/SalesOrderSet('50000123')"
+);
+
+// Стало
+const remove = odataDeleteFn({
+  odata: {
+    service: "ZSALES_SRV",
+    target: "SalesOrderSet"
+  },
+  params: wrapODataParams({
+    SalesOrderId: "50000123"
+  })
+});
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`что-тестировать-в-application-module`,children:`Что тестировать в application module`}),`
+`,(0,c.jsx)(t.p,{children:`Не нужно повторно тестировать всю foundation implementation. Проверяйте свой contract:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`правильные service/target;`}),`
+`,(0,c.jsx)(t.li,{children:`query key включает все identity inputs;`}),`
+`,(0,c.jsx)(t.li,{children:`params правильно собраны из feature inputs;`}),`
+`,(0,c.jsx)(t.li,{children:`transform создаёт ожидаемую domain model;`}),`
+`,(0,c.jsx)(t.li,{children:`mutation обновляет/инвалидирует нужные cache keys;`}),`
+`,(0,c.jsx)(t.li,{children:`UI различает loading, empty и error;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`enabled`}),` запрещает неполный request.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`unit-test-mapper`,children:`Unit test mapper`}),`
+`,(0,c.jsx)(t.p,{children:`Mapper проще и надёжнее тестировать отдельно от network:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { describe, expect, it } from "vitest";
+
+describe("mapSalesOrder", () => {
+  it("создаёт domain model из raw OData row", () => {
+    expect(
+      mapSalesOrder({
+        SalesOrderId: "50000123",
+        NetAmount: "1250.50",
+        CreatedAt: "/Date(1787280000000)/",
+        IsBlocked: "X"
+      })
+    ).toEqual({
+      id: "50000123",
+      amount: 1250.5,
+      createdAt: new Date(1787280000000),
+      blocked: true
+    });
+  });
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если mapping рассчитан на `,(0,c.jsx)(t.code,{children:`autoParse: true`}),`, test input должен соответствовать уже parsed runtime values.`]}),`
+`,(0,c.jsx)(t.h3,{id:`unit-test-query-options`,children:`Unit test query options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { QueryClient } from "@tanstack/react-query";
+import { describe, expect, it, vi } from "vitest";
+
+describe("salesOrdersQueryOptions", () => {
+  it("включает companyId в identity", () => {
+    const first = salesOrdersQueryOptions({ companyId: "1000" });
+    const second = salesOrdersQueryOptions({ companyId: "2000" });
+
+    expect(first.queryKey).not.toEqual(second.queryKey);
+  });
+
+  it("не запускается без обязательного input", () => {
+    const options = salesOrdersQueryOptions({ companyId: "" });
+    expect(options.enabled).toBe(false);
+  });
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`transport-test-без-metadata`,children:`Transport test без metadata`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для low-level transport можно подменить `,(0,c.jsx)(t.code,{children:`fetch`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { afterEach, describe, expect, it, vi } from "vitest";
+import { fetchODataJson } from "@ryuzaki13/react-foundation-api/odata";
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+describe("orders transport", () => {
+  it("разворачивает OData V2 collection envelope", async () => {
+    vi.stubGlobal(
+      "fetch",
+      vi.fn().mockResolvedValue(
+        new Response(
+          JSON.stringify({
+            d: {
+              results: [
+                {
+                  __metadata: { uri: "..." },
+                  SalesOrderId: "50000123"
+                }
+              ],
+              __count: "1"
+            }
+          }),
+          {
+            status: 200,
+            headers: { "Content-Type": "application/json" }
+          }
+        )
+      )
+    );
+
+    const result = await fetchODataJson<
+      Array<{ SalesOrderId: string }>
+    >("/ZSALES_SRV/SalesOrderSet");
+
+    expect(result).toEqual({
+      data: [{ SalesOrderId: "50000123" }],
+      totalCount: 1
+    });
+  });
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В project test environment учтите compile-time constants package (`,(0,c.jsx)(t.code,{children:`__DEV__`}),`, `,(0,c.jsx)(t.code,{children:`__SAP_CLIENT__`}),` и другие), которые обычно подставляет build config.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mutation-cache-test`,children:`Mutation cache test`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { QueryClient } from "@tanstack/react-query";
+import { describe, expect, it, vi } from "vitest";
+
+it("после create инвалидирует список", async () => {
+  const queryClient = new QueryClient();
+  const invalidate = vi.spyOn(queryClient, "invalidateQueries");
+  const listKey = ["sales-orders", "list", { companyId: "1000" }] as const;
+
+  // В integration test здесь вызывается mutation success handler.
+  await queryClient.invalidateQueries({ queryKey: listKey });
+
+  expect(invalidate).toHaveBeenCalledWith({ queryKey: listKey });
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ssocsrf-tests`,children:`SSO/CSRF tests`}),`
+`,(0,c.jsx)(t.p,{children:`В application tests обычно достаточно проверить пользовательский fallback. Детальный transport contract уже тестируется в package. Если всё же нужен integration test:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`мокайте redirect/HTML form и subsequent retry;`}),`
+`,(0,c.jsx)(t.li,{children:`никогда не используйте real SAML payload;`}),`
+`,(0,c.jsx)(t.li,{children:`проверяйте, что concurrent writes не создают несколько token requests;`}),`
+`,(0,c.jsx)(t.li,{children:`проверяйте один retry после 401/403;`}),`
+`,(0,c.jsx)(t.li,{children:`очищайте DOM и global mocks после test.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`полный-public-api`,children:`Полный public API`}),`
+`,(0,c.jsx)(t.p,{children:`Ниже перечислены exports package subpath. Это карта поиска; подробное поведение основных функций описано выше.`}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-aware-operations`,children:`Metadata-aware operations`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`odataQueryFn`})}),(0,c.jsx)(t.td,{children:`GET collection/plain или parameterized Entity`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataReadFn`})}),(0,c.jsx)(t.td,{children:`GET одной Entity по keys`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataCreateFn`})}),(0,c.jsx)(t.td,{children:`POST новой Entity`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataUpdateFn`})}),(0,c.jsx)(t.td,{children:`PUT Entity по keys`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataDeleteFn`})}),(0,c.jsx)(t.td,{children:`DELETE Entity по keys`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFunctionImportFn`})}),(0,c.jsx)(t.td,{children:`FunctionImport с method из metadata`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFetchFnRequest`})}),(0,c.jsx)(t.td,{children:`Conditional type options по semantic operation`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`dev-operation-helpers`,children:`DEV operation helpers`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`odataQueryFnDev`})}),(0,c.jsx)(t.td,{children:`Dry-run query в dev, real query в production`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataReadFnDev`})}),(0,c.jsx)(t.td,{children:`Dry-run read в dev`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataCreateFnDev`})}),(0,c.jsx)(t.td,{children:`Dry-run create в dev`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataUpdateFnDev`})}),(0,c.jsx)(t.td,{children:`Dry-run update в dev`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataDeleteFnDev`})}),(0,c.jsx)(t.td,{children:`Dry-run delete в dev`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFunctionImportFnDev`})}),(0,c.jsx)(t.td,{children:`Dry-run FunctionImport в dev`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`low-level-requests`,children:`Low-level requests`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`odataFetch`})}),(0,c.jsx)(t.td,{children:`Собрать OData query options и выполнить OData V2 JSON request`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFetchOptions`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`$filter`}),`, `,(0,c.jsx)(t.code,{children:`$orderby`}),`, `,(0,c.jsx)(t.code,{children:`$select`}),`, `,(0,c.jsx)(t.code,{children:`$expand`}),`, paging и SW policy`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchBase`})}),(0,c.jsxs)(t.td,{children:[`Базовый SAP-aware `,(0,c.jsx)(t.code,{children:`Response`}),` transport`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchODataJson`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`fetchBase`}),` + OData V2 envelope parsing`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchJson`})}),(0,c.jsxs)(t.td,{children:[`Вернуть только `,(0,c.jsx)(t.code,{children:`data`}),` из `,(0,c.jsx)(t.code,{children:`fetchODataJson`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchQueryFn`})}),(0,c.jsxs)(t.td,{children:[`Query function для произвольного `,(0,c.jsx)(t.code,{children:`Response`}),` transform`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isNoContentResponse`})}),(0,c.jsx)(t.td,{children:`Runtime guard marker-а 204/205`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchJsonQueryFn`})}),(0,c.jsx)(t.td,{children:`Deprecated raw JSON query factory`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchJsonMutationFn`})}),(0,c.jsx)(t.td,{children:`Deprecated POST/PUT JSON factory`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchDeleteFn`})}),(0,c.jsx)(t.td,{children:`Deprecated DELETE factory`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`project-adapter-и-url`,children:`Project adapter и URL`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`configureODataProjectAdapter`})}),(0,c.jsx)(t.td,{children:`Полностью заменить global adapter`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getODataProjectAdapter`})}),(0,c.jsx)(t.td,{children:`Прочитать текущий adapter`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataProjectAdapter`})}),(0,c.jsx)(t.td,{children:`Тип adapter`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataProjectTechnicalEndpoint`})}),(0,c.jsx)(t.td,{children:`Тип metadata/collection technical endpoint`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeODataServiceName`})}),(0,c.jsxs)(t.td,{children:[`Убрать suffix после `,(0,c.jsx)(t.code,{children:`;`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveODataBaseUrl`})}),(0,c.jsx)(t.td,{children:`Выбрать base URL с учётом dev DP0 service`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveODataSapClient`})}),(0,c.jsx)(t.td,{children:`Получить SAP client из adapter`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseURLType`})}),(0,c.jsx)(t.td,{children:`Union доступных base URL ids`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseUrlMap`})}),(0,c.jsx)(t.td,{children:`Readonly map id → URL prefix`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseODataURL`})}),(0,c.jsx)(t.td,{children:`Standard SAP OData prefix`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseODataDp0URL`})}),(0,c.jsx)(t.td,{children:`DP0 prefix в dev/preview, standard в production`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseODataUI2URL`})}),(0,c.jsx)(t.td,{children:`SAP UI2 prefix`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseAppConfigURL`})}),(0,c.jsx)(t.td,{children:`Build-time app config prefix`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getInputUrl`})}),(0,c.jsxs)(t.td,{children:[`Получить string URL из `,(0,c.jsx)(t.code,{children:`RequestInfo`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeRelativePath`})}),(0,c.jsx)(t.td,{children:`Удалить query/hash и гарантировать leading slash`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RequestInitType`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`RequestInit`}),` + internal retry markers`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FetchErrorReportContext`})}),(0,c.jsx)(t.td,{children:`Контекст безопасного transport report`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`sso`,children:`SSO`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`SsoRequiredError`})}),(0,c.jsx)(t.td,{children:`Специализированная authentication error`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SsoForm`})}),(0,c.jsx)(t.td,{children:`Action/method/hidden inputs contract`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SsoRecoveryArgs`})}),(0,c.jsx)(t.td,{children:`Аргументы recovery`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SsoRequiredErrorOptions`})}),(0,c.jsxs)(t.td,{children:[`Options error, включая `,(0,c.jsx)(t.code,{children:`recoverable`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isSsoForm`})}),(0,c.jsx)(t.td,{children:`Guard для SAMLRequest/SAMLResponse form`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`recoverSsoSession`})}),(0,c.jsx)(t.td,{children:`Controlled hidden iframe recovery`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`submitSsoForm`})}),(0,c.jsx)(t.td,{children:`Imperative submit hidden SSO form`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-1`,children:`Metadata`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`fetchMetadata`})}),(0,c.jsxs)(t.td,{children:[`Создать query function загрузки `,(0,c.jsx)(t.code,{children:`$metadata`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataMetadataQueryOptions`})}),(0,c.jsx)(t.td,{children:`Stable metadata query options`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataMetadataQuery`})}),(0,c.jsx)(t.td,{children:`Metadata query + version synchronization`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataMetadataVersionQuery`})}),(0,c.jsx)(t.td,{children:`Отдельная диагностика server version`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`applyODataMetadataVersion`})}),(0,c.jsx)(t.td,{children:`Сравнить version и точечно invalidировать metadata`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getODataMetadataData`})}),(0,c.jsx)(t.td,{children:`Императивно получить актуальную metadata через QueryClient`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataMetadata`})}),(0,c.jsx)(t.td,{children:`Metadata одной Entity`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataEntity`})}),(0,c.jsx)(t.td,{children:`Entity metadata + path/columns/code-text actions`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataEntity`})}),(0,c.jsx)(t.td,{children:`Тип готовой Entity model без loading flag`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`collections`,children:`Collections`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`useODataCollectionQuery`})}),(0,c.jsx)(t.td,{children:`Загрузить и подготовить reference collection`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionResult`})}),(0,c.jsx)(t.td,{children:`Prepared collection snapshot`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataServiceCollectionConfig`})}),(0,c.jsx)(t.td,{children:`Identity/server options справочника`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionConfig`})}),(0,c.jsx)(t.td,{children:`Полный config query/UI справочника`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createODataCollectionBaseQueryKey`})}),(0,c.jsx)(t.td,{children:`Prefix всех collection queries`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createODataCollectionQueryKey`})}),(0,c.jsx)(t.td,{children:`Exact stable collection key`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataCollectionUpdatesQuery`})}),(0,c.jsx)(t.td,{children:`Наблюдать технический список обновлений`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataCollectionUpdatesQueryOptions`})}),(0,c.jsx)(t.td,{children:`Query options списка обновлений`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchODataCollectionUpdates`})}),(0,c.jsx)(t.td,{children:`Query function списка обновлений`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createODataCollectionUpdatesQueryKey`})}),(0,c.jsx)(t.td,{children:`Stable updates key`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionUpdatesOptions`})}),(0,c.jsxs)(t.td,{children:[`Настройка `,(0,c.jsx)(t.code,{children:`staleTime`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionUpdatesResult`})}),(0,c.jsx)(t.td,{children:`Prepared updates snapshot`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionUpdateItem`})}),(0,c.jsx)(t.td,{children:`Одна Entity и время изменения`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`shouldRefreshODataCollectionCache`})}),(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:`resolveODataCollectionSwCachePolicy`})}),(0,c.jsx)(t.td,{children:`Превратить TTL в bust policy при обновлении`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODATA_COLLECTION_UPDATES_LOOKBACK_MS`})}),(0,c.jsx)(t.td,{children:`Окно updates endpoint — 7 дней`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODATA_COLLECTION_DEFAULT_SW_CACHE`})}),(0,c.jsx)(t.td,{children:`Default long-lived collection policy`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODATA_COLLECTION_BUST_SW_CACHE`})}),(0,c.jsx)(t.td,{children:`Default forced refresh policy`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODATA_COLLECTION_UPDATES_SW_CACHE`})}),(0,c.jsx)(t.td,{children:`Updates endpoint SW policy`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`collection-ui-model-и-props-types`,children:`Collection UI model и props types`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`useODataCollectionModel`})}),(0,c.jsx)(t.td,{children:`Зафиксировать model и подставить defaults`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataCollection`})}),(0,c.jsx)(t.td,{children:`Search/filter/index/paging actions для UI`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionModel`})}),(0,c.jsx)(t.td,{children:`Search, limits и active code key`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionSegment`})}),(0,c.jsx)(t.td,{children:`Placeholder/hide/select-text contract`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCollectionProps`})}),(0,c.jsx)(t.td,{children:`Multi-value и dependencies props`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataSelectBaseProps`})}),(0,c.jsx)(t.td,{children:`Общие props collection select`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataSingleSelectProps`})}),(0,c.jsx)(t.td,{children:`Single-value вариант props`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`dependent-segments`,children:`Dependent segments`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`ControlPanelVisibility`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`user`}),`, `,(0,c.jsx)(t.code,{children:`always`}),` или `,(0,c.jsx)(t.code,{children:`none`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataDependentSegment`})}),(0,c.jsx)(t.td,{children:`Segment + panel visibility`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataDependentSegments`})}),(0,c.jsx)(t.td,{children:`Record segments по id`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataDependentBaseProps`})}),(0,c.jsx)(t.td,{children:`Service config с несколькими segments`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataDependentSegmentItem`})}),(0,c.jsx)(t.td,{children:`Нормализованный flat segment`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`flattenODataDependentServices`})}),(0,c.jsx)(t.td,{children:`Service groups → flat segments`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataCollectionChains`})}),(0,c.jsx)(t.td,{children:`Chains из Query cache`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sortODataDependentSegmentItemsByChains`})}),(0,c.jsx)(t.td,{children:`Stable segment-level ordering`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sortODataDependentServicesByChains`})}),(0,c.jsx)(t.td,{children:`Deprecated service-level ordering`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`table-columns`,children:`Table columns`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(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:`useODataTableColumns`})}),(0,c.jsx)(t.td,{children:`Построить/обогатить TanStack columns по metadata`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UseODataTableColumnsConfig`})}),(0,c.jsx)(t.td,{children:`Union build/enrich config`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UseODataTableColumnsBuildConfig`})}),(0,c.jsx)(t.td,{children:`Config генерации columns`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UseODataTableColumnsEnrichConfig`})}),(0,c.jsx)(t.td,{children:`Config обогащения existing columns`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UseODataTableColumnsResult`})}),(0,c.jsx)(t.td,{children:`Columns, visibility, metadata, loading`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`ошибка-перепутаны-params-и-options`,children:[`Ошибка: перепутаны `,(0,c.jsx)(t.code,{children:`params`}),` и `,(0,c.jsx)(t.code,{children:`options`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверная идея: key Entity положен в $filter.
+odataReadFn({
+  odata,
+  params: wrapODataParams({}),
+  options: {
+    expression: createFilterEqual("SalesOrderId", "50000123")
+  }
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для read key должен быть в `,(0,c.jsx)(t.code,{children:`params`}),`. `,(0,c.jsx)(t.code,{children:`options.expression`}),` — `,(0,c.jsx)(t.code,{children:`$filter`}),` списка.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-functionimport-вызван-через-create`,children:`Ошибка: FunctionImport вызван через create`}),`
+`,(0,c.jsxs)(t.p,{children:[`Business verb «создать» не делает target Entity. Если metadata объявляет FunctionImport, используйте `,(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),`, даже если action бизнесово создаёт объект.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-query-key-не-содержит-filter`,children:`Ошибка: query key не содержит filter`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Плохо: все companyId используют один slot.
+queryKey: ["sales-orders"]
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Хорошо.
+queryKey: ["sales-orders", { companyId }]
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-cache-data-используется-как-form-draft`,children:`Ошибка: cache data используется как form draft`}),`
+`,(0,c.jsxs)(t.p,{children:[`Не редактируйте object из `,(0,c.jsx)(t.code,{children:`useQuery().data`}),` напрямую. Создайте отдельный draft state/form model. После save обновите или инвалидируйте cache.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ошибка-autoparse-принят-за-schema-validation`,children:[`Ошибка: `,(0,c.jsx)(t.code,{children:`autoParse`}),` принят за schema validation`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`autoParse`}),` преобразует известные top-level primitive fields по metadata. Он не доказывает, что обязательные поля существуют и business invariants соблюдены.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ошибка-sortbycode-добавили-в-collection-key-вручную`,children:[`Ошибка: `,(0,c.jsx)(t.code,{children:`sortByCode`}),` добавили в collection key вручную`]}),`
+`,(0,c.jsx)(t.p,{children:`Sort order — observer projection, не server identity. Используйте public key factory и hook option.`}),`
+`,(0,c.jsxs)(t.h3,{id:`ошибка-разные-clientfilter-используют-один-collection-key`,children:[`Ошибка: разные `,(0,c.jsx)(t.code,{children:`clientFilter`}),` используют один collection key`]}),`
+`,(0,c.jsx)(t.p,{children:`Это может привести к конкурирующим snapshots. Вынесите различие в observer/component projection.`}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-sw-cache-считается-query-cache`,children:`Ошибка: SW cache считается Query cache`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`x-sw-cache`}),` не обновляет `,(0,c.jsx)(t.code,{children:`useQuery().data`}),` сам. После mutation всё равно нужна QueryClient cache strategy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-dev-helper-используется-как-production-mock`,children:`Ошибка: Dev helper используется как production mock`}),`
+`,(0,c.jsxs)(t.p,{children:[`В production `,(0,c.jsx)(t.code,{children:`*Dev`}),` выполняет реальный request. Для mock подменяйте network/runner в test layer.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-raw-deep-import`,children:`Ошибка: raw deep import`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Запрещено: private implementation path.
+import { odataFetch } from "@ryuzaki13/react-foundation-api/src/odata/odataFetch";
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Правильно.
+import { odataFetch } from "@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`faq`,children:`FAQ`}),`
+`,(0,c.jsx)(t.h3,{id:`какой-helper-выбирать-для-обычного-списка`,children:`Какой helper выбирать для обычного списка?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataQueryFn`}),`. Если это code/text справочник для UI — `,(0,c.jsx)(t.code,{children:`useODataCollectionQuery`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-прочитать-одну-запись`,children:`Как прочитать одну запись?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataReadFn`}),` и keys в `,(0,c.jsx)(t.code,{children:`params`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-вызвать-sap-action`,children:`Как вызвать SAP action?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала посмотрите metadata. Если target — FunctionImport, используйте `,(0,c.jsx)(t.code,{children:`odataFunctionImportFn`}),`; method будет взят из metadata.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-сначала-вручную-загружать-metadata`,children:[`Нужно ли сначала вручную загружать `,(0,c.jsx)(t.code,{children:`$metadata`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Metadata-aware helpers делают это через переданный QueryClient.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-runner-требует-client`,children:[`Почему runner требует `,(0,c.jsx)(t.code,{children:`client`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata является общим server snapshot. QueryClient обеспечивает reuse, deduplication, persistence и version invalidation.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-result-helper-а-содержит--data--а-не-только-data`,children:[`Почему result helper-а содержит `,(0,c.jsx)(t.code,{children:`{ data }`}),`, а не только data?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Envelope сохраняет `,(0,c.jsx)(t.code,{children:`totalCount`}),` и одинаково подходит query/mutation integrations.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`где-находится-totalcount`,children:[`Где находится `,(0,c.jsx)(t.code,{children:`totalCount`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`result.totalCount`}),`, если server прислал OData V2 `,(0,c.jsx)(t.code,{children:`d.__count`}),`, обычно при `,(0,c.jsx)(t.code,{children:`$inlinecount`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-поле-даты-осталось-строкой`,children:`Почему поле даты осталось строкой?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверьте `,(0,c.jsx)(t.code,{children:`autoParse: true`}),`, metadata type и уровень вложенности. Parsing shallow: nested object не обходится рекурсивно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-mutation-получила-403`,children:`Почему mutation получила 403?`}),`
+`,(0,c.jsx)(t.p,{children:`Transport автоматически обновляет CSRF token и повторяет request один раз. Если ошибка осталась, вероятны authorization/business rules, неверный SAP client или SSO problem.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-справочник-пустой-но-iserror--false`,children:[`Почему справочник пустой, но `,(0,c.jsx)(t.code,{children:`isError === false`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Текущий collection loader логирует request error и возвращает пустой items result. Смотрите logs и используйте более строгий query helper для критичного flow.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-справочник-скачался-хотя-есть-persisted-cache`,children:`Почему справочник скачался, хотя есть persisted cache?`}),`
+`,(0,c.jsx)(t.p,{children:`Snapshot мог быть старее server update, metadata update или семидневного coverage window. Тогда hook инвалидирует Query cache и отправляет SW bust policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-пакет-в-ssr`,children:`Можно ли использовать пакет в SSR?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Часть pure builders/types — да, но основной transport рассчитан на browser: cookies, `,(0,c.jsx)(t.code,{children:`window`}),`, `,(0,c.jsx)(t.code,{children:`document`}),`, iframe SSO, Service Worker headers. Разделяйте server/client boundaries явно.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-вручную-добавлять-sap-client`,children:[`Нужно ли вручную добавлять `,(0,c.jsx)(t.code,{children:`sap-client`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Настройте `,(0,c.jsx)(t.code,{children:`resolveSapClient`}),` в project adapter; transport добавит header.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-передать-custom-headers`,children:`Можно ли передать custom headers?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Да, через `,(0,c.jsx)(t.code,{children:`init.headers`}),`. Обязательные transport headers могут быть дополнены/нормализованы. Не подменяйте централизованные CSRF/SSO механизмы.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-root-import-пакета`,children:`Можно ли использовать root import пакета?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Используйте точный subpath:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { odataQueryFn } from "@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`связанные-модули`,children:`Связанные модули`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),` — metadata parser, filters, params, path builders и OData value conversion.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/query-client`}),` — QueryClient, persistence и broadcast infrastructure.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/table`}),` — metadata-driven columns и formatting runtime.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/resource`}),` — generic resource descriptors поверх TanStack Query.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/persisted`}),` — persisted resource operations и adapters.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/error-report`}),` — доставка безопасных error reports.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Главный принцип модуля:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Metadata определяет transport contract.
+Query key определяет identity server snapshot.
+QueryClient владеет snapshot.
+Mutation явно синхронизирует cache.
+Service Worker cache остаётся отдельным HTTP-слоем.
+`})})]})}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};