@kollors/react-codegen 2.0.0-alpha.4 → 2.0.0-alpha.6

package/README.ru.md

@@ -2,27 +2,29 @@
 
 [English](README.md)
 
-Генерация одного самодостаточного TypeScript-клиента из OpenAPI-схемы, GraphQL-схемы и операций либо сразу из обеих схем.
-
-Требуются Node.js 22 или новее и TanStack Query 5 в подключающем приложении.
+Генератор TypeScript-типов, функций запросов и React-хуков для TanStack Query из OpenAPI и GraphQL. Для каждой настроенной схемы создаётся отдельный `.ts`-файл.
 
 ## Установка
 
+Нужна Node.js 22 или новее. В приложении, которое использует сгенерированные хуки, должен быть установлен TanStack Query 5 и настроен `QueryClientProvider`.
+
 ```sh
 npm install -D @kollors/react-codegen@alpha
 ```
 
-## Конфигурация
+Сгенерированные файлы содержат код отправки запросов. Они используют TanStack Query; сам React Codegen нужен только для генерации.
+
+## Конфигурация и запуск
 
 Создайте `codegen.config.js`:
 
 ```js
 export default {
   auth: {
-    storage: 'localStorage', // 'localStorage' | 'sessionStorage' | 'cookie' | 'none'
+    storage: 'localStorage',
     key: 'accessToken',
-    scheme: 'Bearer', // false — отправлять токен без схемы
-    credentials: 'same-origin', // 'omit' | 'same-origin' | 'include'
+    scheme: 'Bearer',
+    credentials: 'same-origin',
   },
   openapi: {
     schema: './openapi.yaml',
@@ -38,53 +40,168 @@ export default {
 };
 ```
 
-Запуск:
+Запустите генерацию:
 
 ```sh
 npx react-codegen codegen.config.js
 ```
 
-Пути разрешаются относительно файла конфигурации. Наличие секции `openapi` запускает генерацию OpenAPI, наличие `graphql` — GraphQL. Отсутствующую секцию можно опустить; нужна хотя бы одна. Каждая секция создаёт один TypeScript-файл. `documents` — каталог: в нём и всех подпапках рекурсивно ищутся файлы `.graphql`. Собственный OpenAPI-генератор работает в памяти, без сторонних генераторов, дочерних процессов и промежуточных файлов. GraphQL пока использует прежний генератор и временную подпапку внутри `.react-codegen-temp` в каталоге пакета; после генерации она удаляется. Готовые файлы сначала записываются рядом с назначением, затем публикуются атомарным переименованием.
+Этот пример создаёт `src/api/openapi.ts` и `src/api/graphql.ts`. Укажите `openapi`, `graphql` или обе секции; нужна хотя бы одна. Каталоги создаются автоматически, а выходные файлы должны иметь разные имена.
+
+Пути считаются от файла конфигурации. Конфиг использует `export default`; в проекте с CommonJS назовите его `codegen.config.mjs` и передайте это имя в команду.
+
+| Настройка | Обязательна | Назначение или значение по умолчанию |
+| --- | --- | --- |
+| `openapi.schema` | Да | OpenAPI 3.0.x или 3.1.x в YAML/JSON: путь к файлу или HTTP URL |
+| `openapi.output` | Да | Путь к создаваемому `.ts`-файлу |
+| `openapi.baseUrl` | Нет | Начало URL для запросов; без настройки пути остаются относительными |
+| `graphql.schema` | Да | GraphQL SDL или introspection JSON: путь к файлу или HTTP URL |
+| `graphql.documents` | Да | Каталог с именованными запросами, мутациями и фрагментами в файлах `.graphql`; вложенные каталоги тоже читаются |
+| `graphql.output` | Да | Путь к создаваемому `.ts`-файлу |
+| `graphql.endpoint` | Нет | Адрес запросов; по умолчанию `/api/graphql` |
+| `auth` | Нет | Общие [настройки авторизации](#авторизация) |
+| `openapi.auth`, `graphql.auth` | Нет | Заменяют общие настройки авторизации для выбранного клиента |
+
+GraphQL introspection JSON может содержать `__schema` или `data.__schema`. В `schema` также можно указать HTTP-адрес GraphQL API: генератор запросит его схему через introspection.
+
+## Использование сгенерированного кода
+
+### Запросы
+
+Для OpenAPI GET-операции с `operationId: getPet` вызовите хук в компоненте или другом хуке:
+
+```ts
+import { useGetPet } from './api/openapi';
+
+export function usePetName(id: string) {
+  return useGetPet({ pathParams: { id } }, { select: pet => pet.name });
+}
+```
+
+Для GraphQL-запроса `MovieDetailsQuery`, который выбирает `movie.title`:
+
+```ts
+import { useMovieDetailsQuery } from './api/graphql';
+
+export function useMovieTitle(id: string) {
+  return useMovieDetailsQuery({ id }, { select: data => data.movie?.title });
+}
+```
+
+Оба генератора создают следующие функции для запросов:
+
+| Назначение | OpenAPI `getPet` | GraphQL `MovieDetailsQuery` |
+| --- | --- | --- |
+| Хук запроса | `useGetPet` | `useMovieDetailsQuery` |
+| Хук с Suspense | `useSuspenseGetPet` | `useSuspenseMovieDetailsQuery` |
+| Настройки для `QueryClient` | `getPetQuery` | `movieDetailsQuery` |
+| Ключ кеша | `getPetQueryKey` | `movieDetailsQueryKey` |
+| Прямой запрос | `fetchGetPet` | `fetchMovieDetailsQuery` |
+
+В OpenAPI имена строятся из `operationId`, а при его отсутствии — из HTTP-метода и пути. В GraphQL — из имени операции. GraphQL также экспортирует тип выбранного результата, тип переменных и строку документа: например, `MovieDetailsQuery`, `MovieDetailsQueryVariables` и `MovieDetailsQueryDocument`.
+
+### Мутации
+
+Для OpenAPI-методов кроме GET и для GraphQL-мутаций создаются хуки мутаций. Пример для OpenAPI-операции с `operationId: createPet`:
+
+```ts
+import { useCreatePet, type CreatePetRequestBody } from './api/openapi';
+
+export function useSavePet() {
+  const mutation = useCreatePet();
+  return (body: CreatePetRequestBody) => mutation.mutate({ body });
+}
+```
+
+В OpenAPI аргументы сгруппированы в `pathParams`, `queryParams`, `headers` и `body`. В GraphQL передаются переменные операции. Обязательность задаёт схема; переменные GraphQL со знаком `!` обязательны, если у них нет значения по умолчанию.
+
+Если обязательных аргументов нет, хуки и функции запросов можно вызывать без них. В этом случае для мутаций также доступны `mutate()` и `mutateAsync()` без аргументов.
+
+### Пропуск запроса
+
+Обычные хуки запросов принимают `skipToken`:
+
+```ts
+import { skipToken } from '@tanstack/react-query';
+import { useGetPet } from './api/openapi';
+
+export function useOptionalPet(id?: string) {
+  return useGetPet(id ? { pathParams: { id } } : skipToken);
+}
+```
+
+Хуки с Suspense не принимают `skipToken`. Аргументы для них можно опустить, если у операции нет обязательных аргументов.
+
+### Запросы и ключи кеша
 
-В `schema` можно передавать локальный путь или URL. Каталоги для `output` создаются автоматически.
+Загрузка данных через TanStack Query:
+
+```ts
+import { QueryClient } from '@tanstack/react-query';
+import { getPetQuery } from './api/openapi';
 
-## Генератор OpenAPI
+const queryClient = new QueryClient();
+const pet = await queryClient.fetchQuery(getPetQuery({ pathParams: { id: '42' } }));
+```
+
+Чтобы обновить кеш в приложении, используйте его `QueryClient`:
+
+```ts
+import { useQueryClient } from '@tanstack/react-query';
+import { getPetQueryKey } from './api/openapi';
 
-Обязательны только `schema` и `output`. Один документ OpenAPI 3.0.x или 3.1.x в YAML/JSON превращается в один `.ts`-файл с типами, fetcher, функциями запросов и хуками TanStack Query 5. Swagger 2.0 не поддерживается. Готовый клиент не импортирует наш пакет. `yaml` нужен только для чтения схемы при генерации.
+export function useRefreshPet(id: string) {
+  const queryClient = useQueryClient();
+  return () => queryClient.invalidateQueries({ queryKey: getPetQueryKey({ pathParams: { id } }) });
+}
+```
 
-Для операции с `operationId: getPet`:
+Прямой запрос без TanStack Query:
 
 ```ts
-import { useGetPet, getPetQuery, getPetQueryKey, fetchGetPet } from './api/openapi';
+import { fetchGetPet } from './api/openapi';
 
-const variables = { pathParams: { id: '42' } };
-const query = useGetPet(variables, { select: pet => pet.name });
-await queryClient.fetchQuery(getPetQuery(variables));
-await queryClient.invalidateQueries({ queryKey: getPetQueryKey(variables) });
-await fetchGetPet(variables, abortController.signal);
+const controller = new AbortController();
+const pet = await fetchGetPet({ pathParams: { id: '42' } }, controller.signal);
 ```
 
-Для GET создаются `useX`, `useSuspenseX`, `xQuery`, `xQueryKey` и `fetchX`. Для остальных методов — мутация `useX` и функция `fetchX`, например `useCreatePet().mutate({ body: pet })`. Аргументы сгруппированы в `pathParams`, `queryParams`, `headers` и `body`; обязательность задаёт схема. Если обязательных аргументов нет, вызов возможен без них. Обычные query принимают `skipToken` из TanStack; suspense-query требуют аргументы. Имена строятся из `operationId`, а при его отсутствии — из метода и пути. Коллизия имён сообщает оба места в схеме.
+Вызов `controller.abort()` отменяет прямой запрос. Хуки запросов получают сигнал отмены от TanStack Query автоматически. Функции запросов и вспомогательные функции GraphQL работают так же.
+
+Для работы с кешем используйте сгенерированные функции ключей. Ключи учитывают адрес API и аргументы; в OpenAPI — также заголовки запроса. Токены из хранилища и браузерные cookie в ключ не входят, поэтому при смене пользователя очищайте соответствующий кеш.
+
+## Авторизация
 
-Ключи кеша включают настроенный базовый URL, HTTP-метод, путь, имя операции и аргументы. Сгенерированный `Accept` и явно переданные заголовки приводятся к сериализованным именам и значениям: эквивалентные `Headers`, объекты и массивы пар используют одну запись кеша, разные значения заголовков — разные. Токены из хранилища и браузерные cookie в ключ не входят; при смене пользователя очищайте соответствующий кеш запросов.
+Общая секция `auth` применяется к обоим клиентам. `openapi.auth` или `graphql.auth` целиком заменяет её для выбранного клиента.
 
-### Что поддерживается
+Без `auth` сгенерированный клиент не добавляет заголовок `Authorization`.
 
-- Примитивы, массивы, объекты, словари, enum, внутренние `$ref`, рекурсивные компоненты, пересечения `allOf`, объединения `oneOf`/`anyOf`. В OpenAPI 3.1 — также булевы схемы, `const` и массивы типов.
-- `required` определяет необязательные поля. `null` появляется только там, где разрешён схемой. Массовой замены `null` на `undefined` нет. Для `readOnly`/`writeOnly` при необходимости создаются входные и выходные типы.
-- Параметры пути/заголовков `simple`; query-параметры `form`, плоский `deepObject` с `explode: true`, массивы `spaceDelimited`/`pipeDelimited` с `explode: false`. Параметры операции переопределяют параметры уровня пути.
-- JSON/`+json`, текст/XML как строки, бинарные тела/ответы как `Blob`, multipart и URL-encoded тела из объектов. При нескольких форматах запроса порядок выбора: JSON, `+json`, URL-encoded, multipart, остальные поддерживаемые форматы по алфавиту. Ответ читается по фактическому Content-Type; типы успешных ответов объединяются. `default` используется как успешный ответ только при отсутствии явных 2xx. Пустые ответы мутаций имеют тип `void` и возвращают `undefined`.
-- Описания становятся комментариями. Даты остаются строками. Числовые границы, паттерны и длины не добавляют проверок во время выполнения. `oneOf` становится union без проверки исключительности. `discriminator` не добавляет выдуманных полей и значений: поле-дискриминатор нужно описать в схеме.
+| Параметр | Обязателен | Поведение |
+| --- | --- | --- |
+| `storage` | Если указан `auth` | Откуда читать токен; варианты ниже |
+| `key` | Если `storage` отличается от `none` | Имя записи в хранилище или cookie |
+| `scheme` | Нет | Префикс заголовка; по умолчанию `Bearer`. Значение `false` отправляет токен без изменений |
+| `credentials` | Нет | Правила отправки браузерных cookie; по умолчанию `same-origin` |
 
-### Текущие ограничения
+| `storage` | Источник токена |
+| --- | --- |
+| `localStorage` | `localStorage.getItem(key)` |
+| `sessionStorage` | `sessionStorage.getItem(key)` |
+| `cookie` | Cookie с именем `key`, прочитанная через `document.cookie` |
+| `none` | Токен не читается, заголовок авторизации не добавляется |
 
-Неподдерживаемые конструкции вызывают ошибку с местом в схеме до замены выходного файла: внешние `$ref` (сначала объедините схему), callbacks/webhooks, cookie-параметры, `content` у параметров, вложенные объекты/массивы параметров, `allowReserved`, стили пути `label`/`matrix`, пользовательский encoding форм, неподдерживаемые Content-Type и сложные ключевые слова JSON Schema: условия, `not`, динамические ссылки, `prefixItems`, `patternProperties`, `unevaluatedProperties`. Типизированные `additionalProperties` вместе с именованными свойствами отклоняются: индексная сигнатура TypeScript ошибочно ограничила бы и именованные свойства; словарь можно вынести в отдельное свойство. Рекурсивные типы должны быть компонентами; циклические цепочки алиасов и циклические YAML-ссылки отклоняются.
+| `credentials` | Браузерные cookie |
+| --- | --- |
+| `omit` | Не отправлять |
+| `same-origin` | Разрешить для запросов к тому же origin |
+| `include` | Разрешить также для запросов к другому origin |
 
-Fetch не позволяет отправлять тело с GET/HEAD и выполнять TRACE. GET с описанным ответом без тела отклоняется: React Query не кеширует `undefined`, и генератор не заменяет его на `null`. Пустые текстовые ответы остаются пустыми строками. Сегменты пути `.` и `..` отклоняются до отправки запроса: Fetch нормализовал бы их и изменил маршрут. `servers` и `security` из схемы не заменяют настройки: используйте `baseUrl` и `auth`. Заголовки ответа отдельно не возвращаются. Сгенерированные типы не проверяют фактические ответы сервера во время выполнения.
+Если токен отсутствует или пустой, заголовок авторизации не добавляется. Для cookie с флагом `HttpOnly`, которые JavaScript не может прочитать, настройте отправку браузером:
 
-### Переход с прежнего генератора
+```js
+auth: { storage: 'none', credentials: 'include' }
+```
 
-Перегенерируйте клиент. Привычные camelCase имена операций и группы аргументов сохраняются, но полной совместимости всех экспортов нет. Удалены пустой контекст, `deepMerge`, `QueryOperation`, общий `queryKeyFn` и `@ts-nocheck`. Начиная с `2.0.0-alpha.4`, ключи кеша имеют вид `[baseUrl, method, path, operationName, normalizedVariables]` вместо `[operationName, variables]`: используйте `xQueryKey`, обновите вручную составленные ключи инвалидации и очистите сохранённый кеш при обновлении. Имена типов приводятся к PascalCase, пунктуация и подчёркивания разделяют слова. Ошибки представлены `OpenapiHttpError` или обычным `Error` вместо `ErrorWrapper`. Более строгие типы могут потребовать исправить места вызова.
+При этом действуют правила браузера для cookie и CORS. При прямом вызове `createOpenapiFetcher` или `createGraphqlFetcher` можно передать `getToken`, возвращающий полное значение заголовка `Authorization`. Этот параметр относится к функциям создания клиента, а не к конфигу генератора.
 
 ## Программный API
 
@@ -92,33 +209,53 @@ Fetch не позволяет отправлять тело с GET/HEAD и вы
 import { generate, type CodegenConfig } from '@kollors/react-codegen';
 
 const config: CodegenConfig = {
-  auth: {
-    storage: 'localStorage',
-    key: 'accessToken',
-  },
-  graphql: {
-    schema: './schema.graphql',
-    documents: './src/graphql',
-    output: './src/api/graphql.ts',
-    endpoint: '/graphql',
+  openapi: {
+    schema: './openapi.yaml',
+    output: './src/api/openapi.ts',
   },
 };
 
-const result = await generate(config);
-console.log(result.outputs);
+const { outputs } = await generate(config);
+console.log(outputs);
 ```
 
-В программном API относительные пути считаются от текущей рабочей директории. `generate` возвращает пути созданных файлов.
+Настройки совпадают с конфигом CLI. Относительные пути считаются от текущей рабочей директории. `generate` возвращает пути созданных файлов.
+
+## Поддержка схем и ограничения
+
+Оба генератора создают типы по схеме. Они не проверяют данные ответа сервера во время выполнения. Ошибка генерации сохраняет существующие выходные файлы.
 
-## Авторизация и ошибки
+### OpenAPI
 
-Общие настройки `auth` применяются к обоим клиентам. Чтобы заменить их для одного клиента, укажите `auth` внутри `openapi` или `graphql`. Поддерживаются `storage`: `localStorage`, `sessionStorage`, `cookie` и `none`. Если секция `auth` указана, `storage` обязателен. В `key` указывается имя записи с токеном; ключ обязателен для `localStorage`, `sessionStorage` и `cookie`, но не используется с `none`. `scheme` необязателен и по умолчанию равен `Bearer`; значение `false` отправляет токен без схемы. `credentials` необязателен и по умолчанию использует поведение Fetch API `same-origin`; также доступны `omit` и `include`.
+- Поддерживаются OpenAPI 3.0.x и 3.1.x; Swagger 2.0 не поддерживается.
+- Поддерживаются объекты, массивы, словари, enum, внутренние `$ref`, рекурсивные компоненты, `allOf`, `oneOf` и `anyOf`. В OpenAPI 3.1 — также `const`, булевы схемы и массивы типов.
+- `required` определяет обязательные поля; `null` включается там, где разрешён схемой. Поля `readOnly` исключаются из типов запросов, `writeOnly` — из типов ответов. Даты остаются строками.
+- Поддерживаются JSON, `+json`, текст/XML как строки, бинарные данные как `Blob`, multipart и URL-encoded тела. При нескольких форматах запроса приоритет такой: JSON, `+json`, URL-encoded, multipart, остальные поддерживаемые форматы по алфавиту.
+- Поддерживаются параметры пути и заголовков `simple`, query-параметры `form`, плоский `deepObject` с `explode: true` и массивы `spaceDelimited`/`pipeDelimited` с `explode: false`. Вложенные объекты и массивы параметров не поддерживаются.
 
-Если `auth` не задан ни глобально, ни в секции клиента, сгенерированный клиент не добавляет заголовок `Authorization`. JavaScript не может прочитать cookie с флагом `HttpOnly`; для них укажите `auth: { storage: 'none', credentials: 'include' }`, и браузер отправит cookie сам. `graphql.endpoint` по умолчанию равен `/api/graphql`. `openapi.baseUrl` по умолчанию пустой, поэтому пути из схемы остаются относительными.
+Внешние `$ref` нужно объединить в один документ перед генерацией. Не поддерживаются callbacks, webhooks, cookie-параметры, `content` у параметров, `allowReserved`, стили пути `label`/`matrix` и пользовательский encoding форм. Сложные ограничения JSON Schema, например условия, `not`, `dependentRequired`, `patternProperties` и `unevaluatedProperties`, вызывают ошибку с местом в схеме.
 
-При прямом использовании фабрик fetcher можно передать `getToken`; функция должна вернуть полное значение заголовка `Authorization`.
+Типизированные `additionalProperties` вместе с именованными свойствами не поддерживаются; вынесите словарь в отдельное свойство. Числовые границы, паттерны и длины не проверяются во время выполнения. `oneOf` становится TypeScript-объединением без проверки, что подходит ровно один вариант; поле дискриминатора и его значения нужно описать в схеме.
 
-Ошибки HTTP представлены классами `GraphqlHttpError` и `OpenapiHttpError`; они содержат статус и данные ответа. Ошибки выполнения GraphQL представлены `GraphqlResponseError` со всеми сообщениями сервера.
+Адрес и авторизация задаются через `baseUrl` и `auth`; `servers` и `security` из схемы не применяются. Для GET нужно описать тело ответа. Пустые ответы мутаций возвращают `undefined` с типом `void`; отсутствие объявленного тела ответа вызывает ошибку запроса. Тела GET/HEAD, метод TRACE и сегменты пути `.` или `..` отклоняются. Заголовки ответа отдельно не возвращаются.
+
+### GraphQL
+
+Поддерживаются именованные запросы и мутации, фрагменты, псевдонимы полей, интерфейсы и объединения. Тип результата описывает выбранные поля. Выбирайте `__typename`, если нужно различать варианты объединения.
+
+Поля, допускающие `null`, имеют тип `T | null`; условные поля с `@skip` или `@include` могут быть необязательными. Списки сохраняют возможность `null` у элементов. Входные поля и переменные со знаком `!` и значением по умолчанию можно опустить, но нельзя передать `null`. Входные объекты с `@oneOf` требуют ровно одно поле со значением, отличным от `null`. Пользовательские скаляры имеют тип `unknown`.
+
+Subscriptions и `@defer`/`@stream` не поддерживаются. Загрузка схемы не использует `auth`; если адрес схемы требует авторизации, используйте локальный экспорт схемы.
+
+### Ошибки запросов
+
+| Ошибка | Данные |
+| --- | --- |
+| `OpenapiHttpError` | HTTP-статус и данные ответа в `data` |
+| `GraphqlHttpError` | HTTP-статус и тело ответа в `body` |
+| `GraphqlResponseError` | Ошибки выполнения GraphQL в `errors` и частичные данные ответа в `data` |
+
+При обновлении существующих клиентов смотрите [инструкцию по переходу](docs/migration.ru.md).
 
 ## Разработка
 
@@ -127,6 +264,13 @@ npm ci
 npm run verify
 ```
 
+| Каталог | Содержимое |
+| --- | --- |
+| `src/cli/` | Команда CLI |
+| `src/core/` | Конфигурация, запуск генерации, запись файлов и общие утилиты |
+| `src/openapi/` | Генератор OpenAPI и код отправки запросов |
+| `src/graphql/` | Генератор GraphQL и код отправки запросов |
+
 ## Лицензия
 
 [MIT](LICENSE)

package/dist/{cli.js → cli/index.js}

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { readFile } from 'node:fs/promises';
-import { dirname, isAbsolute, resolve } from 'node:path';
+import { dirname, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { generate, validateCodegenConfig } from './generate.js';
-import { isUrl } from './path-utils.js';
+import { validateCodegenConfig } from '../core/config.js';
+import { generate } from '../core/generate.js';
+import { resolvePath, resolveSchema } from '../core/paths.js';
 const help = `Usage: react-codegen <codegen.config.js>
 
 Generate configured OpenAPI and GraphQL clients.
@@ -12,19 +13,13 @@ Options:
   -h, --help     Show this help message
   -v, --version  Show version
 `;
-function resolvePath(value, directory) {
-    return isAbsolute(value) ? value : resolve(directory, value);
-}
-function resolveSchema(value, directory) {
-    return isUrl(value) ? value : resolvePath(value, directory);
-}
 async function main(args) {
     if (args.includes('--help') || args.includes('-h')) {
         process.stdout.write(help);
         return;
     }
     if (args.includes('--version') || args.includes('-v')) {
-        const packageJson = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+        const packageJson = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8'));
         process.stdout.write(`${packageJson.version}\n`);
         return;
     }
@@ -68,4 +63,4 @@ catch (error) {
     process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
     process.exitCode = 1;
 }
-//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9D,MAAM,IAAI,GAAG;;;;;;;CAOZ,CAAC;AAEF,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAC;QAC9H,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,OAAO,IAAI,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAW,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAA0B,CAAC;IAC7F,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,SAAS,CAAC,GAAG,UAAU,iDAAiD,CAAC,CAAC;IACtF,CAAC;IACD,qBAAqB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC;IAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAkB;QAC5B,GAAG,YAAY;QACf,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI;YAC1B,OAAO,EAAE;gBACP,GAAG,YAAY,CAAC,OAAO;gBACvB,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;gBAC7D,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;aAC5D;SACF,CAAC;QACF,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI;YAC1B,OAAO,EAAE;gBACP,GAAG,YAAY,CAAC,OAAO;gBACvB,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;gBAC7D,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;gBACjE,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;aAC5D;SACF,CAAC;KACH,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,IAAI,CAAC,CAAC;AACtF,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/auth.d.ts

@@ -0,0 +1,7 @@
+export type TokenStorage = 'localStorage' | 'sessionStorage' | 'cookie' | 'none';
+export interface AuthConfig {
+    storage: TokenStorage;
+    key?: string;
+    scheme?: string | false;
+    credentials?: RequestCredentials;
+}

package/dist/core/auth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/core/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":""}

package/dist/core/config.d.ts

@@ -0,0 +1,2 @@
+import type { CodegenConfig } from './types.js';
+export declare function validateCodegenConfig(value: unknown): asserts value is CodegenConfig;

package/dist/core/config.js

@@ -0,0 +1,67 @@
+import { resolve } from 'node:path';
+export function validateCodegenConfig(value) {
+    const config = value;
+    if (config === null || typeof config !== 'object' || Array.isArray(config)) {
+        throw new TypeError('Codegen config must be an object.');
+    }
+    const keys = Object.keys(config);
+    if (keys.some((key) => key !== 'auth' && key !== 'openapi' && key !== 'graphql')) {
+        throw new Error(`Unknown codegen config section: ${keys.find((key) => key !== 'auth' && key !== 'openapi' && key !== 'graphql')}`);
+    }
+    if (!config.openapi && !config.graphql) {
+        throw new Error('Codegen config must contain an openapi or graphql section.');
+    }
+    const validateAuth = (auth, location) => {
+        if (!auth || typeof auth !== 'object' || Array.isArray(auth))
+            throw new TypeError(`${location} must be an object.`);
+        const allowedAuthKeys = ['storage', 'key', 'scheme', 'credentials'];
+        const unknownKey = Object.keys(auth).find((key) => !allowedAuthKeys.includes(key));
+        if (unknownKey)
+            throw new Error(`Unknown ${location} option: ${unknownKey}`);
+        if (!['localStorage', 'sessionStorage', 'cookie', 'none'].includes(auth.storage)) {
+            throw new TypeError(`${location}.storage must be localStorage, sessionStorage, cookie, or none.`);
+        }
+        if (auth.storage !== 'none' && (typeof auth.key !== 'string' || !auth.key.trim())) {
+            throw new TypeError(`${location}.key must be a non-empty string unless storage is "none".`);
+        }
+        if (auth.key !== undefined && (typeof auth.key !== 'string' || !auth.key.trim())) {
+            throw new TypeError(`${location}.key must be a non-empty string.`);
+        }
+        if (auth.scheme !== undefined && auth.scheme !== false && (typeof auth.scheme !== 'string' || !auth.scheme.trim())) {
+            throw new TypeError(`${location}.scheme must be a non-empty string or false.`);
+        }
+        if (auth.credentials !== undefined && !['omit', 'same-origin', 'include'].includes(auth.credentials)) {
+            throw new TypeError(`${location}.credentials must be omit, same-origin, or include.`);
+        }
+    };
+    if (config.auth !== undefined)
+        validateAuth(config.auth, 'config.auth');
+    for (const [kind, section] of Object.entries({ openapi: config.openapi, graphql: config.graphql })) {
+        if (section === undefined)
+            continue;
+        if (!section || typeof section !== 'object' || Array.isArray(section)) {
+            throw new TypeError(`config.${kind} must be an object.`);
+        }
+        const expectedKeys = kind === 'openapi' ? ['schema', 'output', 'baseUrl', 'auth'] : ['schema', 'documents', 'output', 'endpoint', 'auth'];
+        for (const key of Object.keys(section)) {
+            if (!expectedKeys.includes(key))
+                throw new Error(`Unknown config.${kind} option: ${key}`);
+        }
+        for (const key of expectedKeys) {
+            const value = section[key];
+            if ((key === 'baseUrl' || key === 'endpoint' || key === 'auth') && value === undefined)
+                continue;
+            if (key === 'auth') {
+                validateAuth(value, `config.${kind}.auth`);
+                continue;
+            }
+            if (typeof value !== 'string' || !value.trim())
+                throw new TypeError(`config.${kind}.${key} must be a non-empty string.`);
+        }
+    }
+    const outputs = [config.openapi?.output, config.graphql?.output].filter((value) => Boolean(value));
+    if (new Set(outputs.map((value) => resolve(value))).size !== outputs.length) {
+        throw new Error('OpenAPI and GraphQL outputs must use different files.');
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/{generate.d.ts → core/generate.d.ts}

@@ -1,4 +1,3 @@
 import type { CodegenConfig, CodegenResult } from './types.js';
 /** Generate configured OpenAPI and GraphQL clients into one TypeScript file per enabled section. */
 export declare function generate(config: CodegenConfig): Promise<CodegenResult>;
-export declare function validateCodegenConfig(config: unknown): asserts config is CodegenConfig;

package/dist/core/generate.js

@@ -0,0 +1,47 @@
+import { generateGraphqlSource } from '../graphql/generate.js';
+import { generateOpenapiSource } from '../openapi/generate.js';
+import { validateCodegenConfig } from './config.js';
+import { publishOutputs } from './output.js';
+import { resolvePath, resolveSchema } from './paths.js';
+async function generateOpenapi(config, auth, cwd) {
+    try {
+        const content = await generateOpenapiSource(resolveSchema(config.schema, cwd), {
+            ...(config.baseUrl ? { baseUrl: config.baseUrl } : {}),
+            ...(auth ? { auth } : {}),
+        });
+        return { path: resolvePath(config.output, cwd), content };
+    }
+    catch (error) {
+        throw new Error(`Could not generate OpenAPI client from ${resolveSchema(config.schema, cwd)}: ${errorMessage(error)}`, {
+            cause: error,
+        });
+    }
+}
+async function generateGraphql(config, auth, cwd) {
+    try {
+        const content = await generateGraphqlSource(resolveSchema(config.schema, cwd), resolvePath(config.documents, cwd), {
+            ...(config.endpoint ? { endpoint: config.endpoint } : {}),
+            ...(auth ? { auth } : {}),
+        });
+        return { path: resolvePath(config.output, cwd), content };
+    }
+    catch (error) {
+        throw new Error(`Could not generate GraphQL client using schema ${resolveSchema(config.schema, cwd)} and documents ${resolvePath(config.documents, cwd)}: ${errorMessage(error)}`, { cause: error });
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Generate configured OpenAPI and GraphQL clients into one TypeScript file per enabled section. */
+export async function generate(config) {
+    validateCodegenConfig(config);
+    const cwd = process.cwd();
+    const generated = [];
+    if (config.openapi)
+        generated.push(await generateOpenapi(config.openapi, config.openapi.auth ?? config.auth, cwd));
+    if (config.graphql)
+        generated.push(await generateGraphql(config.graphql, config.graphql.auth ?? config.auth, cwd));
+    publishOutputs(generated);
+    return { outputs: generated.map(({ path }) => path) };
+}
+//# sourceMappingURL=generate.js.map

package/dist/core/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/core/generate.ts"],"names":[],"mappings":"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"}

package/dist/core/names.d.ts

@@ -0,0 +1,5 @@
+export declare class Names {
+    private readonly used;
+    reserve(name: string, location: string): string;
+}
+export declare function comment(value: unknown): string;

package/dist/core/names.js

@@ -0,0 +1,16 @@
+export class Names {
+    used = new Map();
+    reserve(name, location) {
+        const previous = this.used.get(name);
+        if (previous !== undefined)
+            throw new Error(`Generated name "${name}" collides between ${previous} and ${location}. Rename one of these definitions.`);
+        this.used.set(name, location);
+        return name;
+    }
+}
+export function comment(value) {
+    if (typeof value !== 'string' || !value.trim())
+        return '';
+    return `/** ${value.replaceAll('*/', '* /').replace(/\r?\n/g, '\n * ')} */\n`;
+}
+//# sourceMappingURL=names.js.map

package/dist/core/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/core/names.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IACC,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,OAAO,CAAC,IAAY,EAAE,QAAgB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,SAAS;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,sBAAsB,QAAQ,QAAQ,QAAQ,oCAAoC,CAAC,CAAC;QAC7H,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1D,OAAO,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC;AAChF,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,5 @@
+export interface GeneratedOutput {
+    path: string;
+    content: string;
+}
+export declare function publishOutputs(outputs: GeneratedOutput[]): void;