@ryuzaki13/react-foundation-ui 1.8.12 → 1.8.13

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

@@ -0,0 +1,355 @@
+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`,blockquote:`blockquote`,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/SAP/Transport Requests`}),`
+`,(0,c.jsxs)(t.h1,{id:`sap-transport-requests-через-ryuzaki13react-foundation-apitransport`,children:[`SAP transport requests через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/transport`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль получает transport requests текущего пользователя из SAP UI2 OData endpoints и нормализует workbench/customizing records.`}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Здесь слово `,(0,c.jsx)(t.code,{children:`transport`}),` означает SAP transport request. Это не generic HTTP transport. Для обычного HTTP используйте `,(0,c.jsx)(t.a,{href:`../http/README.mdx`,children:(0,c.jsx)(t.code,{children:`/http`})}),`, для SAP/OData transport infrastructure — `,(0,c.jsx)(t.a,{href:`../odata/README.mdx`,children:(0,c.jsx)(t.code,{children:`/odata`})}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для разработчика без SAP-базы: transport request — контейнер, в котором изменения переносятся между SAP systems. Workbench и customizing — разные категории, поэтому package сохраняет `,(0,c.jsx)(t.code,{children:`type`}),` рядом с каждым id.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`SAP UI2 WorkbenchRequests ──► normalize ──┐
+                                         ├─► TransportRequest[]
+SAP UI2 CustomizingRequests ─► normalize ─┘
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	fetchCustomizingTransportRequests,
+	fetchTransportRequests,
+	fetchUserTransportRequests,
+	fetchWorkbenchTransportRequests,
+	getTransportRequestKey,
+	normalizeTransportRequests,
+	transportRequestKeys
+} from "@ryuzaki13/react-foundation-api/transport";
+
+import type {
+	TransportRequest,
+	TransportRequestRaw,
+	TransportRequestScope,
+	TransportRequestType,
+	UserTransportRequests
+} from "@ryuzaki13/react-foundation-api/transport";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const requests = await fetchTransportRequests("workbench");
+
+for (const request of requests) {
+	console.log(request.id, request.text);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Scopes:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TransportRequestType = "workbench" | "customizing";
+type TransportRequestScope = TransportRequestType | "all";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Без аргумента загружается только `,(0,c.jsx)(t.code,{children:`workbench`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-выбрать-scope`,children:`Как выбрать scope`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Нужно UI`}),(0,c.jsx)(t.th,{children:`Scope`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Только workbench request`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`workbench`}),` или аргумент не передан`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Только customizing request`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`customizing`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Единый список обеих категорий`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`all`})})]})]})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await fetchTransportRequests();
+// То же, что fetchTransportRequests("workbench")
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`fetch-functions`,children:`Fetch functions`}),`
+`,(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:`Endpoint`}),(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:`fetchWorkbenchTransportRequests`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`/TRANSPORT/WorkbenchRequests`})}),(0,c.jsx)(t.td,{children:`workbench array`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchCustomizingTransportRequests`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`/TRANSPORT/CustomizingRequests`})}),(0,c.jsx)(t.td,{children:`customizing array`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchUserTransportRequests`})}),(0,c.jsx)(t.td,{children:`Оба endpoint параллельно`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ workbench, customizing, all }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchTransportRequests(scope)`})}),(0,c.jsx)(t.td,{children:`Endpoint по scope`}),(0,c.jsx)(t.td,{children:`единый array`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Используется base URL `,(0,c.jsx)(t.code,{children:`odataUi2`}),`: в dev/preview он направлен через настроенный DP0/UI2 proxy, в production — `,(0,c.jsx)(t.code,{children:`/sap/opu/odata/UI2`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Запросы наследуют policy OData transport:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`credentials: include`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`SAP language/client headers;`}),`
+`,(0,c.jsx)(t.li,{children:`SSO detection/recovery;`}),`
+`,(0,c.jsx)(t.li,{children:`OData V2 envelope parsing;`}),`
+`,(0,c.jsx)(t.li,{children:`HTTP error handling.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если один из двух запросов `,(0,c.jsx)(t.code,{children:`fetchUserTransportRequests`}),` завершился ошибкой, `,(0,c.jsx)(t.code,{children:`Promise.all`}),` отклоняется и частичный object не возвращается.`]}),`
+`,(0,c.jsx)(t.h3,{id:`точные-network-paths`,children:`Точные network paths`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`base URL odataUi2
+├── /TRANSPORT/WorkbenchRequests
+└── /TRANSPORT/CustomizingRequests
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В dev/preview `,(0,c.jsx)(t.code,{children:`odataUi2`}),` обычно становится:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap-dp0/opu/odata/UI2
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В production:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap/opu/odata/UI2
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Итоговый URL определяется OData transport build/project configuration. Consumer не должен добавлять этот prefix вручную.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-делает-каждая-function`,children:`Что делает каждая function`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchWorkbenchTransportRequests()`}),`:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Выполняет UI2 OData GET.`}),`
+`,(0,c.jsx)(t.li,{children:`Снимает OData V2 envelope общим transport-ом.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Если payload falsy, возвращает `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Нормализует records с type `,(0,c.jsx)(t.code,{children:`workbench`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchCustomizingTransportRequests()`}),` делает то же с type `,(0,c.jsx)(t.code,{children:`customizing`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchUserTransportRequests()`}),` запускает обе функции параллельно через `,(0,c.jsx)(t.code,{children:`Promise.all`}),`, затем строит:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	workbench,
+	customizing,
+	all: [...workbench, ...customizing]
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchTransportRequests(scope)`}),` — удобный selector над этими calls.`]}),`
+`,(0,c.jsx)(t.h3,{id:`abortsignal`,children:`AbortSignal`}),`
+`,(0,c.jsxs)(t.p,{children:[`Public fetch functions не принимают `,(0,c.jsx)(t.code,{children:`AbortSignal`}),`. Их можно использовать как TanStack queryFn, но cancellation QueryClient не прерывает underlying request через этот API.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если abort становится обязательным для общей инфраструктуры, расширьте package contract; не создавайте deep import низкоуровневого helper-а.`}),`
+`,(0,c.jsx)(t.h2,{id:`результат`,children:`Результат`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TransportRequest {
+	id: string;
+	type: "workbench" | "customizing";
+	text: string;
+	isDefaultRequest: boolean;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`all`}),` формируется как workbench records, затем customizing records:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface UserTransportRequests {
+	workbench: TransportRequest[];
+	customizing: TransportRequest[];
+	all: TransportRequest[];
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{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.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:`id`})}),(0,c.jsx)(t.td,{children:`да`}),(0,c.jsx)(t.td,{children:`Нормализованный SAP request number`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`type`})}),(0,c.jsx)(t.td,{children:`да`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`workbench`}),` либо `,(0,c.jsx)(t.code,{children:`customizing`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`text`})}),(0,c.jsx)(t.td,{children:`да`}),(0,c.jsx)(t.td,{children:`Нормализованное description; может быть пустой строкой`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isDefaultRequest`})}),(0,c.jsx)(t.td,{children:`да`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`true`}),` только при strict input `,(0,c.jsx)(t.code,{children:`true`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Надёжный UI label:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getRequestLabel(request: TransportRequest) {
+	return request.text
+		? \`\${request.id} — \${request.text}\`
+		: request.id;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте `,(0,c.jsx)(t.code,{children:`text`}),` как identity: description может измениться или быть пустым.`]}),`
+`,(0,c.jsx)(t.h2,{id:`normalizetransportrequests`,children:(0,c.jsx)(t.code,{children:`normalizeTransportRequests`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция полезна отдельно для тестов или custom transport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normalized = normalizeTransportRequests(
+	[
+		{ id: " DEVK900001 ", description: " Исправление ", isDefaultRequest: true },
+		{ id: "", description: "Без номера" },
+		{ id: "DEVK900001", description: "Дубликат" }
+	],
+	"workbench"
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат содержит одну запись `,(0,c.jsx)(t.code,{children:`DEVK900001`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`id`}),` нормализуется как text с trim.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Запись без непустого `,(0,c.jsx)(t.code,{children:`id`}),` удаляется.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Дубликаты `,(0,c.jsx)(t.code,{children:`id`}),` внутри одного input удаляются, сохраняется первый.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`description`}),` нормализуется с trim; отсутствие превращается в пустую строку.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`type`}),` берётся из второго аргумента для всех records.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`isDefaultRequest`}),` равен `,(0,c.jsx)(t.code,{children:`true`}),` только при входном значении `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Порядок первых уникальных records сохраняется.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Нормализация не изменяет исходный array/objects.`}),`
+`,(0,c.jsx)(t.h3,{id:`raw-contract`,children:`Raw contract`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TransportRequestRaw {
+	id?: string | null;
+	description?: string | null;
+	isDefaultRequest?: boolean | null;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Все поля могут отсутствовать. После normalization `,(0,c.jsx)(t.code,{children:`id`}),`, `,(0,c.jsx)(t.code,{children:`text`}),`, `,(0,c.jsx)(t.code,{children:`type`}),`, `,(0,c.jsx)(t.code,{children:`isDefaultRequest`}),` уже обязательны.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пошаговый-пример-normalization`,children:`Пошаговый пример normalization`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = [
+	{
+		id: " DP0K970966 ",
+		description: " MIME типы ",
+		isDefaultRequest: true
+	},
+	{
+		id: "DP0K970966",
+		description: "Дубликат",
+		isDefaultRequest: false
+	},
+	{
+		id: null,
+		description: "Без id"
+	}
+];
+
+const result = normalizeTransportRequests(source, "workbench");
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{
+		id: "DP0K970966",
+		type: "workbench",
+		text: "MIME типы",
+		isDefaultRequest: true
+	}
+]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Почему остаётся первая запись: функция сразу добавляет нормализованный id в `,(0,c.jsx)(t.code,{children:`Set`}),` и пропускает последующие совпадения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`дубликаты-между-типами`,children:`Дубликаты между типами`}),`
+`,(0,c.jsxs)(t.p,{children:[`Normalization выполняется отдельно для каждого endpoint. Одинаковый id может присутствовать один раз в workbench и один раз в customizing. Array `,(0,c.jsx)(t.code,{children:`all`}),` сохранит обе записи, потому что их semantic identity различается по `,(0,c.jsx)(t.code,{children:`type`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`query-keys`,children:`Query keys`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`transportRequestKeys.all;
+// ["transportRequests"]
+
+transportRequestKeys.list();
+// ["transportRequests", "workbench"]
+
+transportRequestKeys.list("all");
+// ["transportRequests", "all"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример с TanStack Query:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const scope: TransportRequestScope = "all";
+
+const query = useQuery({
+	queryKey: transportRequestKeys.list(scope),
+	queryFn: () => fetchTransportRequests(scope)
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Factory ключей не создаёт query options и не передаёт AbortSignal; lifecycle запроса настраивает consumer.`}),`
+`,(0,c.jsx)(t.h3,{id:`reusable-query-options`,children:`Reusable query options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { queryOptions } from "@tanstack/react-query";
+import {
+	fetchTransportRequests,
+	transportRequestKeys
+} from "@ryuzaki13/react-foundation-api/transport";
+
+export const transportRequestsQueryOptions = (
+	scope: TransportRequestScope = "workbench"
+) =>
+	queryOptions({
+		queryKey: transportRequestKeys.list(scope),
+		queryFn: () => fetchTransportRequests(scope),
+		staleTime: 5 * 60 * 1000
+	});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`scope`}),` обязательно входит в key. Иначе workbench/customizing/all начнут делить один cache slot.`]}),`
+`,(0,c.jsx)(t.h3,{id:`react-ui-со-всеми-состояниями`,children:`React UI со всеми состояниями`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function TransportRequestSelect({
+	scope = "workbench",
+	value,
+	onChange
+}: {
+	scope?: TransportRequestScope;
+	value?: string;
+	onChange: (id: string) => void;
+}) {
+	const query = useQuery(transportRequestsQueryOptions(scope));
+
+	if (query.isPending) return <p>Загрузка transport requests…</p>;
+	if (query.isError) return <p role="alert">{query.error.message}</p>;
+	if (query.data.length === 0) return <p>Доступных requests нет</p>;
+
+	return (
+		<select value={value ?? ""} onChange={(event) => onChange(event.target.value)}>
+			<option value="">Выберите transport request</option>
+			{query.data.map((request) => (
+				<option key={getTransportRequestKey(request)} value={request.id}>
+					{request.text ? \`\${request.id} — \${request.text}\` : request.id}
+				</option>
+			))}
+		</select>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`scope === "all"`}),`, form value только `,(0,c.jsx)(t.code,{children:`id`}),` может быть неоднозначным при collision разных types. В таком UI храните `,(0,c.jsx)(t.code,{children:`{ type, id }`}),` или stable key и явно преобразуйте его при submit.`]}),`
+`,(0,c.jsx)(t.h2,{id:`stable-key-отдельной-записи`,children:`Stable key отдельной записи`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getTransportRequestKey({ type: "workbench", id: "DEVK900001" });
+// "workbench:DEVK900001"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Включение `,(0,c.jsx)(t.code,{children:`type`}),` предотвращает collision одинаковых ID из разных списков. Функция не escaping-ит `,(0,c.jsx)(t.code,{children:`:`}),`; SAP transport ID обычно не содержит этот символ.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Stable key предназначен для React `,(0,c.jsx)(t.code,{children:`key`}),`, maps и UI identity:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const map = new Map(
+	requests.map((request) => [getTransportRequestKey(request), request])
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не отправляйте `,(0,c.jsx)(t.code,{children:`workbench:DEVK...`}),` в backend вместо request id, если backend ожидает только `,(0,c.jsx)(t.code,{children:`id`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`отличие-от-adt`,children:[`Отличие от `,(0,c.jsx)(t.code,{children:`/adt`})]}),`
+`,(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.code,{children:`/transport`})}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`/adt`})})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Backend`}),(0,c.jsx)(t.td,{children:`SAP UI2 OData`}),(0,c.jsx)(t.td,{children:`SAP ADT CTS`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Формат`}),(0,c.jsx)(t.td,{children:`JSON/OData envelope`}),(0,c.jsx)(t.td,{children:`XML`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Категории`}),(0,c.jsx)(t.td,{children:`workbench/customizing`}),(0,c.jsx)(t.td,{children:`Общие ADT headers`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Parser`}),(0,c.jsx)(t.td,{children:`OData transport`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fast-xml-parser`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Не объединяйте records автоматически: контракты endpoint и значения полей различаются.`}),`
+`,(0,c.jsxs)(t.p,{children:[`ADT result богаче техническими fields (`,(0,c.jsx)(t.code,{children:`owner`}),`, `,(0,c.jsx)(t.code,{children:`statusCode`}),`, `,(0,c.jsx)(t.code,{children:`parentTransportNo`}),`), но UI2 module явно разделяет workbench/customizing и знает default request. Выбор source зависит от backend use case, а не от того, какой endpoint оказался удобнее.`]}),`
+`,(0,c.jsx)(t.h2,{id:`обработка-ошибок`,children:`Обработка ошибок`}),`
+`,(0,c.jsx)(t.p,{children:`Network и OData V2 errors пробрасываются caller-у. Function не превращает HTTP error в пустой array.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`fetchUserTransportRequests`}),` действует fail-fast result contract:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`workbench success + customizing error = Promise rejection
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если product допускает partial UI, orchestrate calls отдельно на feature boundary:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const [workbench, customizing] = await Promise.allSettled([
+	fetchWorkbenchTransportRequests(),
+	fetchCustomizingTransportRequests()
+]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`После этого feature обязана явно показать partial state; не маскируйте failed category как настоящий пустой список.`}),`
+`,(0,c.jsx)(t.h2,{id:`cache-после-создания-transport-а`,children:`Cache после создания transport-а`}),`
+`,(0,c.jsx)(t.p,{children:`Этот module только читает lists. Если другой feature создаёт request через OData/ADT, после успеха инвалидируйте подходящий scope:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await queryClient.invalidateQueries({
+	queryKey: transportRequestKeys.all
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Prefix `,(0,c.jsx)(t.code,{children:`all`}),` здесь означает «все query keys семейства transport requests», а не только scope `,(0,c.jsx)(t.code,{children:`"all"`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Точечно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await queryClient.invalidateQueries({
+	queryKey: transportRequestKeys.list("workbench")
+});
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`pure-normalization`,children:`Pure normalization`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { expect, it } from "vitest";
+import { normalizeTransportRequests } from "@ryuzaki13/react-foundation-api/transport";
+
+it("trim-ит поля и сохраняет первый duplicate", () => {
+	expect(
+		normalizeTransportRequests(
+			[
+				{ id: " A ", description: " Первый ", isDefaultRequest: true },
+				{ id: "A", description: " Второй " }
+			],
+			"workbench"
+		)
+	).toEqual([
+		{
+			id: "A",
+			type: "workbench",
+			text: "Первый",
+			isDefaultRequest: true
+		}
+	]);
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`что-проверить`,children:`Что проверить`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`пустой/null/whitespace id удаляется;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустое description становится `,(0,c.jsx)(t.code,{children:`""`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`только strict `,(0,c.jsx)(t.code,{children:`true`}),` даёт default flag;`]}),`
+`,(0,c.jsx)(t.li,{children:`duplicates сохраняют первую запись;`}),`
+`,(0,c.jsx)(t.li,{children:`workbench/customizing types проставляются argument-ом;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`all`}),` сохраняет порядок категорий;`]}),`
+`,(0,c.jsx)(t.li,{children:`одинаковые ids разных types имеют разные stable keys;`}),`
+`,(0,c.jsx)(t.li,{children:`ошибка одного parallel endpoint отклоняет combined function.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Network tests должны mock-ать UI2 endpoints и OData envelope. Не используйте real SAP session в unit tests.`}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`использовать-module-как-generic-http-transport`,children:`Использовать module как generic HTTP transport`}),`
+`,(0,c.jsxs)(t.p,{children:[`Название относится к SAP transport requests. Для HTTP есть `,(0,c.jsx)(t.code,{children:`/http`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`не-включить-scope-в-query-key`,children:`Не включить scope в query key`}),`
+`,(0,c.jsx)(t.p,{children:`Каждый scope возвращает разные данные.`}),`
+`,(0,c.jsxs)(t.h3,{id:`использовать-id-как-react-key-при-scope-all`,children:[`Использовать `,(0,c.jsx)(t.code,{children:`id`}),` как React key при scope `,(0,c.jsx)(t.code,{children:`all`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`getTransportRequestKey`}),`, чтобы учесть type.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-пустой-text-ошибкой`,children:[`Считать пустой `,(0,c.jsx)(t.code,{children:`text`}),` ошибкой`]}),`
+`,(0,c.jsx)(t.p,{children:`Public normalized contract допускает пустое description.`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-partial-result`,children:`Ожидать partial result`}),`
+`,(0,c.jsxs)(t.p,{children:[`Combined fetch использует `,(0,c.jsx)(t.code,{children:`Promise.all`}),` и fail-fast semantics.`]}),`
+`,(0,c.jsx)(t.h3,{id:`deep-import-odata-transport`,children:`Deep import OData transport`}),`
+`,(0,c.jsxs)(t.p,{children:[`Application импортирует только `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/transport`}),`. Internal calls остаются detail package-а.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-ограничения`,children:`Ошибки и ограничения`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Модуль только читает requests; он не создаёт, не освобождает и не импортирует transport.`}),`
+`,(0,c.jsx)(t.li,{children:`Authorization определяется SAP backend.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Пустой/falsy payload endpoint превращается в `,(0,c.jsx)(t.code,{children:`[]`}),`; HTTP/SSO errors пробрасываются.`]}),`
+`,(0,c.jsx)(t.li,{children:`Нет автоматической TanStack Query cache policy — используйте экспортированные keys.`}),`
+`,(0,c.jsx)(t.li,{children:`Runtime требует настроенного SAP proxy/base URLs и cookies.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`faq`,children:`FAQ`}),`
+`,(0,c.jsx)(t.h3,{id:`как-получить-обе-категории`,children:`Как получить обе категории?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchTransportRequests("all")`}),` для flat array или `,(0,c.jsx)(t.code,{children:`fetchUserTransportRequests()`}),` для grouped object.`]}),`
+`,(0,c.jsx)(t.h3,{id:`какая-категория-загружается-по-умолчанию`,children:`Какая категория загружается по умолчанию?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`workbench`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-all-может-содержать-одинаковый-id-дважды`,children:[`Почему `,(0,c.jsx)(t.code,{children:`all`}),` может содержать одинаковый id дважды?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если он пришёл из разных categories, records имеют разные `,(0,c.jsx)(t.code,{children:`type`}),` и считаются разными.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-создать-transport-request`,children:`Можно ли создать transport request?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Модуль read-only.`}),`
+`,(0,c.jsx)(t.h3,{id:`есть-ли-automatic-query-cache`,children:`Есть ли automatic query cache?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Используйте exported key factory вместе с TanStack Query.`}),`
+`,(0,c.jsx)(t.h3,{id:`работает-ли-без-sap-sso`,children:`Работает ли без SAP SSO?`}),`
+`,(0,c.jsx)(t.p,{children:`Только если endpoint доступен и auth boundary настроена host environment. Package использует общий SAP transport с cookies/SSO policy.`}),`
+`,(0,c.jsx)(t.h2,{id:`полный-api`,children:`Полный API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Группа`}),(0,c.jsx)(t.th,{children:`Exports`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Fetch`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`fetchWorkbenchTransportRequests`}),`, `,(0,c.jsx)(t.code,{children:`fetchCustomizingTransportRequests`}),`, `,(0,c.jsx)(t.code,{children:`fetchUserTransportRequests`}),`, `,(0,c.jsx)(t.code,{children:`fetchTransportRequests`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Normalize/key`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`normalizeTransportRequests`}),`, `,(0,c.jsx)(t.code,{children:`transportRequestKeys`}),`, `,(0,c.jsx)(t.code,{children:`getTransportRequestKey`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Types`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`TransportRequestType`}),`, `,(0,c.jsx)(t.code,{children:`TransportRequestScope`}),`, `,(0,c.jsx)(t.code,{children:`TransportRequest`}),`, `,(0,c.jsx)(t.code,{children:`TransportRequestRaw`}),`, `,(0,c.jsx)(t.code,{children:`UserTransportRequests`})]})]})]})]})]})}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};

package/storybook-static/assets/{README-DV4fCpqN.js → README-DlwhWCvQ.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,blockquote:`blockquote`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Utils`}),`
+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`,blockquote:`blockquote`,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 Lib/API/Utils`}),`
 `,(0,c.jsxs)(t.h1,{id:`общие-утилиты-ryuzaki13react-foundation-libutils`,children:[`Общие утилиты `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/utils`})]}),`
 `,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`utils`}),` объединяет небольшие технические функции, которые нужны в разных частях React- и TypeScript-приложения:`]}),`
 `,(0,c.jsxs)(t.ul,{children:[`