@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

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

@@ -0,0 +1,325 @@
+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/SAP/ADT Transports`}),`
+`,(0,c.jsxs)(t.h1,{id:`sap-adt-transports-через-ryuzaki13react-foundation-apiadt`,children:[`SAP ADT transports через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/adt`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль получает transport requests текущего пользователя из SAP ADT endpoint и преобразует XML в простой массив объектов.`}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BE%D0%B3%D0%B4%D0%B0-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%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%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:`#fetchusertransports`,children:(0,c.jsx)(t.code,{children:`fetchUserTransports`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#parseusertransportsxml`,children:(0,c.jsx)(t.code,{children:`parseUserTransportsXml`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82-%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82%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-%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:`#%D0%BF%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9-api`,children:`Полный API`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`adt`}),`, если backend доступен по `,(0,c.jsx)(t.code,{children:`/sap/bc/adt/cts/transports`}),` и возвращает ADT XML. Если нужны отдельные UI2 списки workbench/customizing в JSON, используйте `,(0,c.jsx)(t.a,{href:`../transport/README.mdx`,children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/transport`})}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`SAP ADT XML
+    │
+    ▼
+parseUserTransportsXml
+    │
+    ▼
+UserTransport[]
+`})}),`
+`,(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 fast-xml-parser
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { fetchUserTransports, parseUserTransportsXml } from "@ryuzaki13/react-foundation-api/adt";
+
+import type { UserTransport } from "@ryuzaki13/react-foundation-api/adt";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function loadTransports() {
+	try {
+		const transports = await fetchUserTransports();
+		return transports;
+	} catch (error) {
+		console.error("Не удалось получить transports", error);
+		return [];
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchUserTransports`}),` возвращает Promise. Пока он выполняется, данных ещё нет; ошибку нужно обработать через `,(0,c.jsx)(t.code,{children:`try/catch`}),`, TanStack Query или error boundary владельца сценария.`]}),`
+`,(0,c.jsx)(t.h2,{id:`fetchusertransports`,children:(0,c.jsx)(t.code,{children:`fetchUserTransports`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция выполняет GET:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap/bc/adt/cts/transports?_action=FIND&trfunction=K
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Запрос отправляется через SAP/OData transport пакета с:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Accept: application/xml, text/xml, */*`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`cookies через `,(0,c.jsx)(t.code,{children:`credentials: include`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`SAP language/client и SSO policy общего OData transport;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустым base URL, потому что ADT endpoint уже содержит `,(0,c.jsx)(t.code,{children:`/sap/...`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Ответ читается как text и передаётся `,(0,c.jsx)(t.code,{children:`parseUserTransportsXml`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если сервер вместо XML вернул HTML login/error page, функция выбросит ошибку. Это защищает UI от ситуации, когда HTML ошибочно принимается за пустой список transports.`}),`
+`,(0,c.jsx)(t.h2,{id:`parseusertransportsxml`,children:(0,c.jsx)(t.code,{children:`parseUserTransportsXml`})}),`
+`,(0,c.jsx)(t.p,{children:`Parser можно использовать отдельно, например в тесте или при получении XML другим transport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const xml = \`
+<root>
+	<CTS_REQ_HEADER>
+		<TRKORR>DEVK900001</TRKORR>
+		<AS4TEXT>Исправление отчёта</AS4TEXT>
+		<AS4USER>IVANOV</AS4USER>
+		<TARSYSTEM>QAS</TARSYSTEM>
+		<TRFUNCTION>K</TRFUNCTION>
+		<TRSTATUS>D</TRSTATUS>
+	</CTS_REQ_HEADER>
+</root>\`;
+
+const transports = parseUserTransportsXml(xml);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Пустая или состоящая из пробелов строка превращается в `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`XML разбирается `,(0,c.jsx)(t.code,{children:`fast-xml-parser`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Во вложенной структуре рекурсивно ищутся узлы `,(0,c.jsx)(t.code,{children:`CTS_REQ_HEADER`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Поля преобразуются в `,(0,c.jsx)(t.code,{children:`UserTransport`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Записи без непустого `,(0,c.jsx)(t.code,{children:`TRKORR`}),` отбрасываются.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Дубликаты `,(0,c.jsx)(t.code,{children:`transportNo`}),` удаляются; сохраняется первая запись.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если header-узлы не найдены, parser ищет вложенные `,(0,c.jsx)(t.code,{children:`TRKORR`}),` и создаёт минимальные записи.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Parser делает `,(0,c.jsx)(t.code,{children:`trim`}),` строковых полей, но не декодирует бизнес-значения статуса/function и не проверяет их по справочнику SAP.`]}),`
+`,(0,c.jsx)(t.p,{children:`Некорректный XML может привести к исключению parser-а. Функция не заменяет его пустым массивом: повреждённый ответ должен быть виден как ошибка.`}),`
+`,(0,c.jsx)(t.h2,{id:`формат-результата`,children:`Формат результата`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface UserTransport {
+	transportNo: string;
+	description: string | undefined;
+	owner: string | undefined;
+	targetSystem: string | undefined;
+	functionCode: string | undefined;
+	statusCode: string | undefined;
+	parentTransportNo: string | undefined;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Соответствие XML:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`XML`}),(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:`TRKORR`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`transportNo`})}),(0,c.jsx)(t.td,{children:`Обязательный номер transport`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AS4TEXT`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`description`})}),(0,c.jsx)(t.td,{children:`Описание`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AS4USER`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`owner`})}),(0,c.jsx)(t.td,{children:`Владелец`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TARSYSTEM`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`targetSystem`})}),(0,c.jsx)(t.td,{children:`Целевая система`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TRFUNCTION`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`functionCode`})}),(0,c.jsx)(t.td,{children:`SAP transport function code`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TRSTATUS`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`statusCode`})}),(0,c.jsx)(t.td,{children:`SAP status code`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`STRKORR`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parentTransportNo`})}),(0,c.jsx)(t.td,{children:`Родительский request/task`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Optional-поле может быть `,(0,c.jsx)(t.code,{children:`undefined`}),`. Проверяйте его перед отображением:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"const label = transport.description\n	? `${transport.transportNo} — ${transport.description}`\n	: transport.transportNo;\n"})}),`
+`,(0,c.jsx)(t.h2,{id:`как-устроен-adt-response`,children:`Как устроен ADT response`}),`
+`,(0,c.jsx)(t.p,{children:`ADT endpoint возвращает не OData JSON, а ABAP XML. Реальный документ обычно содержит namespace и несколько служебных обёрток:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-xml`,children:`<?xml version="1.0" encoding="UTF-8"?>
+<asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
+	<asx:values>
+		<DATA>
+			<CTS_REQ_HEADER>
+				<TRKORR>DEVK900001</TRKORR>
+				<AS4TEXT>Исправление отчёта</AS4TEXT>
+				<AS4USER>IVANOV</AS4USER>
+				<TARSYSTEM>QAS</TARSYSTEM>
+				<TRFUNCTION>K</TRFUNCTION>
+				<TRSTATUS>D</TRSTATUS>
+				<STRKORR>DEVK900000</STRKORR>
+			</CTS_REQ_HEADER>
+		</DATA>
+	</asx:values>
+</asx:abap>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Parser намеренно не зависит от точного положения `,(0,c.jsx)(t.code,{children:`CTS_REQ_HEADER`}),`: он рекурсивно обходит objects и arrays. Поэтому дополнительная server wrapper-структура не ломает parsing, пока имена полезных tags остаются прежними.`]}),`
+`,(0,c.jsx)(t.h3,{id:`request-parameters-endpoint`,children:`Request parameters endpoint`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`_action=FIND
+trfunction=K
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Они зафиксированы внутри `,(0,c.jsx)(t.code,{children:`fetchUserTransports`}),`. Consumer не может изменить owner, function, status или paging через options. Если нужен другой ADT query, создайте отдельный API у владельца package, а не подменяйте поведение этой функции string manipulation-ом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-используется-общий-sap-transport`,children:`Почему используется общий SAP transport`}),`
+`,(0,c.jsxs)(t.p,{children:[`Хотя response не OData, `,(0,c.jsx)(t.code,{children:`fetchUserTransports`}),` использует `,(0,c.jsx)(t.code,{children:`fetchBase`}),` из `,(0,c.jsx)(t.code,{children:`/odata`}),`, потому что ему нужны те же infrastructure concerns:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`cookies текущей SAP session;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`sap-language`}),` и configured `,(0,c.jsx)(t.code,{children:`sap-client`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`manual redirect detection;`}),`
+`,(0,c.jsx)(t.li,{children:`automatic SSO recovery;`}),`
+`,(0,c.jsx)(t.li,{children:`единая HTTP error policy.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Base URL передаётся как пустая строка, потому что path уже начинается с `,(0,c.jsx)(t.code,{children:`/sap/bc/adt`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`подробный-алгоритм-parser-а`,children:`Подробный алгоритм parser-а`}),`
+`,(0,c.jsx)(t.h3,{id:`1-пустой-документ`,children:`1. Пустой документ`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseUserTransportsXml("");
+// []
+
+parseUserTransportsXml("   \\n\\t");
+// []
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Whitespace-only input не отправляется в XML parser.`}),`
+`,(0,c.jsx)(t.h3,{id:`2-xml-остаётся-строковым`,children:`2. XML остаётся строковым`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fast-xml-parser`}),` настроен с `,(0,c.jsx)(t.code,{children:`parseTagValue: false`}),`. Значения вроде `,(0,c.jsx)(t.code,{children:`0001`}),`, `,(0,c.jsx)(t.code,{children:`D`}),` или transport number не превращаются автоматически в numbers/booleans.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это важно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-xml`,children:`<TRKORR>DEVK900001</TRKORR>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`должен остаться exact identifier, а не пройти numeric coercion.`}),`
+`,(0,c.jsx)(t.h3,{id:`3-поиск-всех-headers`,children:`3. Поиск всех headers`}),`
+`,(0,c.jsxs)(t.p,{children:[`Parser собирает каждый nested value по key `,(0,c.jsx)(t.code,{children:`CTS_REQ_HEADER`}),`. Один XML parser может представить:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`один header как object;`}),`
+`,(0,c.jsx)(t.li,{children:`несколько соседних headers как array;`}),`
+`,(0,c.jsx)(t.li,{children:`headers внутри дополнительных wrappers.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Оба случая нормализуются к одному массиву.`}),`
+`,(0,c.jsx)(t.h3,{id:`4-runtime-narrowing`,children:`4. Runtime narrowing`}),`
+`,(0,c.jsx)(t.p,{children:`Любой найденный value сначала проверяется как record. Primitive/null не превращаются в transport.`}),`
+`,(0,c.jsx)(t.h3,{id:`5-нормализация-text`,children:`5. Нормализация text`}),`
+`,(0,c.jsx)(t.p,{children:`Все SAP fields проходят text normalization:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`"  DEVK900001  " -> "DEVK900001"
+"   "            -> undefined
+null             -> undefined
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Запись без `,(0,c.jsx)(t.code,{children:`transportNo`}),` отбрасывается полностью.`]}),`
+`,(0,c.jsx)(t.h3,{id:`6-дедупликация`,children:`6. Дедупликация`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseUserTransportsXml(\`
+<root>
+	<CTS_REQ_HEADER>
+		<TRKORR>DEVK900001</TRKORR>
+		<AS4TEXT>Первое описание</AS4TEXT>
+	</CTS_REQ_HEADER>
+	<CTS_REQ_HEADER>
+		<TRKORR>DEVK900001</TRKORR>
+		<AS4TEXT>Второе описание</AS4TEXT>
+	</CTS_REQ_HEADER>
+</root>
+\`);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Вернёт первую запись. Parser не объединяет optional fields дубликатов.`}),`
+`,(0,c.jsxs)(t.h3,{id:`7-fallback-без-cts_req_header`,children:[`7. Fallback без `,(0,c.jsx)(t.code,{children:`CTS_REQ_HEADER`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Некоторые responses содержат только nested `,(0,c.jsx)(t.code,{children:`TRKORR`}),`. Тогда parser формирует минимальные records:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseUserTransportsXml(\`
+<root>
+	<RESULT><TRKORR>DEVK900003</TRKORR></RESULT>
+	<RESULT><TRKORR>DEVK900004</TRKORR></RESULT>
+</root>
+\`);
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{
+		transportNo: "DEVK900003",
+		description: undefined,
+		owner: undefined,
+		targetSystem: undefined,
+		functionCode: undefined,
+		statusCode: undefined,
+		parentTransportNo: undefined
+	},
+	// ...
+]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Fallback включается только если ни одного корректного header record не найдено.`}),`
+`,(0,c.jsx)(t.h2,{id:`использование-с-tanstack-query`,children:`Использование с TanStack Query`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не навязывает query key/stale policy. Их определяет feature:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { queryOptions, useQuery } from "@tanstack/react-query";
+import { fetchUserTransports } from "@ryuzaki13/react-foundation-api/adt";
+
+const adtTransportKeys = {
+	all: ["adt-transports"] as const,
+	list: () => [...adtTransportKeys.all, "list"] as const
+};
+
+export const adtTransportsQueryOptions = () =>
+	queryOptions({
+		queryKey: adtTransportKeys.list(),
+		queryFn: fetchUserTransports,
+		staleTime: 5 * 60 * 1000
+	});
+
+function TransportSelect() {
+	const query = useQuery(adtTransportsQueryOptions());
+
+	if (query.isPending) return <p>Загрузка транспортов…</p>;
+	if (query.isError) return <p>{query.error.message}</p>;
+	if (query.data.length === 0) return <p>Доступных транспортов нет</p>;
+
+	return (
+		<select>
+			{query.data.map((item) => (
+				<option key={item.transportNo} value={item.transportNo}>
+					{item.transportNo}
+					{item.description ? \` — \${item.description}\` : ""}
+				</option>
+			))}
+		</select>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchUserTransports`}),` не принимает `,(0,c.jsx)(t.code,{children:`AbortSignal`}),`, поэтому query cancellation не прерывает underlying fetch через этот API. Не обещайте UI мгновенный transport abort. Если это станет обязательным, контракт должен быть расширен в package.`]}),`
+`,(0,c.jsx)(t.p,{children:`Query key не должен содержать user secrets. Если список зависит от logged-in user, смена user/session должна сопровождаться очисткой auth-sensitive Query cache на project boundary.`}),`
+`,(0,c.jsx)(t.h2,{id:`parent-request-и-task`,children:`Parent request и task`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`parentTransportNo`}),` обычно помогает отличить task от верхнеуровневого request:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getTransportLabel(transport: UserTransport) {
+	const kind = transport.parentTransportNo ? "Задача" : "Запрос";
+	return \`\${kind}: \${transport.transportNo}\`;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это только presentation inference. Модуль не интерпретирует SAP status/function codes и не гарантирует бизнес-классификацию. Для правил конкретной системы используйте domain mapping приложения.`}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.p,{children:`Parser — pure function, поэтому тестируйте fixtures без network:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { describe, expect, it } from "vitest";
+import { parseUserTransportsXml } from "@ryuzaki13/react-foundation-api/adt";
+
+it("сохраняет leading zeros и optional fields", () => {
+	const result = parseUserTransportsXml(\`
+		<root>
+			<CTS_REQ_HEADER>
+				<TRKORR>DEVK900001</TRKORR>
+				<TRSTATUS>D</TRSTATUS>
+			</CTS_REQ_HEADER>
+		</root>
+	\`);
+
+	expect(result).toEqual([
+		{
+			transportNo: "DEVK900001",
+			description: undefined,
+			owner: undefined,
+			targetSystem: undefined,
+			functionCode: undefined,
+			statusCode: "D",
+			parentTransportNo: undefined
+		}
+	]);
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Минимальный набор cases:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`single header;`}),`
+`,(0,c.jsx)(t.li,{children:`array headers;`}),`
+`,(0,c.jsx)(t.li,{children:`nested wrappers/namespaces;`}),`
+`,(0,c.jsx)(t.li,{children:`duplicate number;`}),`
+`,(0,c.jsx)(t.li,{children:`whitespace fields;`}),`
+`,(0,c.jsx)(t.li,{children:`empty XML;`}),`
+`,(0,c.jsxs)(t.li,{children:[`fallback `,(0,c.jsx)(t.code,{children:`TRKORR`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`malformed XML и ожидаемая ошибка.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для transport integration mock-айте `,(0,c.jsx)(t.code,{children:`fetch`}),`/MSW и проверяйте Content-Type `,(0,c.jsx)(t.code,{children:`text/html`}),`, XML body и HTTP error. Не используйте real SAP credentials в tests.`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`использовать-поля-function-и-status`,children:[`Использовать поля `,(0,c.jsx)(t.code,{children:`function`}),` и `,(0,c.jsx)(t.code,{children:`status`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Правильные имена public contract — `,(0,c.jsx)(t.code,{children:`functionCode`}),` и `,(0,c.jsx)(t.code,{children:`statusCode`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`считать-status-code-готовым-label`,children:`Считать status code готовым label`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`"D"`}),` остаётся строкой `,(0,c.jsx)(t.code,{children:`"D"`}),`. Расшифровка зависит от SAP contract проекта и не выполняется package-ом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`принимать-пустой-array-за-любую-ошибку`,children:`Принимать пустой array за любую ошибку`}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустой или whitespace XML даёт `,(0,c.jsx)(t.code,{children:`[]`}),`, но HTTP, HTML и malformed XML errors выбрасываются. Обрабатывайте error отдельно от empty state.`]}),`
+`,(0,c.jsx)(t.h3,{id:`объединять-adt-и-ui2-records-без-mapper-а`,children:`Объединять ADT и UI2 records без mapper-а`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`/adt`}),` и `,(0,c.jsx)(t.code,{children:`/transport`}),` имеют разные source contracts. Если feature показывает их вместе, создайте явную domain model и collision policy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`deep-import-parser-а`,children:`Deep import parser-а`}),`
+`,(0,c.jsx)(t.p,{children:`Используйте только:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { parseUserTransportsXml } from "@ryuzaki13/react-foundation-api/adt";
+`})}),`
+`,(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:`fast-xml-parser`}),` должен быть установлен в host, использующем этот entrypoint.`]}),`
+`,(0,c.jsx)(t.li,{children:`Это не generic ADT client: endpoint и query parameters зафиксированы.`}),`
+`,(0,c.jsx)(t.li,{children:`Функция не создаёт/не освобождает transport и не проверяет authorization.`}),`
+`,(0,c.jsxs)(t.li,{children:[`SSO/cookies требуют browser/proxy окружения SAP. На server runtime поведение зависит от переданного глобального `,(0,c.jsx)(t.code,{children:`fetch`}),` и cookie boundary.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`HTML-response, HTTP error и XML parse error не превращаются в `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Дедупликация выполняется только по `,(0,c.jsx)(t.code,{children:`transportNo`}),` и сохраняет первую найденную запись.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`faq`,children:`FAQ`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-передать-другой-endpoint`,children:`Можно ли передать другой endpoint?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. `,(0,c.jsx)(t.code,{children:`fetchUserTransports`}),` — конкретный ADT use case с фиксированным endpoint.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-получить-только-transports-конкретного-owner`,children:`Можно ли получить только transports конкретного owner?`}),`
+`,(0,c.jsx)(t.p,{children:`Не через текущий public API. Фильтруйте result локально либо расширьте package contract, если server-side filter является общей потребностью.`}),`
+`,(0,c.jsx)(t.h3,{id:`parser-меняет-исходную-xml-string`,children:`Parser меняет исходную XML string?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Он создаёт новые JS objects.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-optional-fields-явно-содержат-undefined`,children:[`Почему optional fields явно содержат `,(0,c.jsx)(t.code,{children:`undefined`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Таков стабильный `,(0,c.jsx)(t.code,{children:`UserTransport`}),` shape. Consumer может безопасно destructure поля без проверки их наличия как properties.`]}),`
+`,(0,c.jsx)(t.h3,{id:`работает-ли-в-node`,children:`Работает ли в Node?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Pure parser работает при наличии `,(0,c.jsx)(t.code,{children:`fast-xml-parser`}),`. Network function зависит от общего SAP transport, URL/cookies/build constants и в первую очередь рассчитана на browser application.`]}),`
+`,(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:`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:`fetchUserTransports`})}),(0,c.jsx)(t.td,{children:`Загружает и разбирает ADT XML`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseUserTransportsXml`})}),(0,c.jsx)(t.td,{children:`Преобразует XML string в массив`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UserTransport`})}),(0,c.jsx)(t.td,{children:`Контракт результата`})]})]})]})]})}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};