Compare commits
4 Commits
15ed8c8b8d
...
3c3ac80713
| Author | SHA1 | Date | |
|---|---|---|---|
| 3c3ac80713 | |||
| 4e2d0f03de | |||
| 6bffe6a9e1 | |||
| 21c7ddfd54 |
107
AI-PROJECT-OVERVIEW.md
Normal file
107
AI-PROJECT-OVERVIEW.md
Normal file
@@ -0,0 +1,107 @@
|
||||
# API CodeGen - Описание проекта для AI агента
|
||||
|
||||
## Назначение
|
||||
CLI утилита для автоматической генерации TypeScript API клиента из OpenAPI/Swagger спецификации.
|
||||
|
||||
## Архитектура
|
||||
|
||||
### Основные компоненты
|
||||
1. **CLI** ([`src/cli.ts`](src/cli.ts:1)) - точка входа, парсинг аргументов командной строки
|
||||
2. **Generator** ([`src/generator.ts`](src/generator.ts:1)) - логика генерации кода через swagger-typescript-api
|
||||
3. **Config** ([`src/config.ts`](src/config.ts:1)) - валидация конфигурации
|
||||
4. **Templates** (`src/templates/*.ejs`) - EJS шаблоны для генерации кода
|
||||
|
||||
### Технологический стек
|
||||
- **Runtime**: Bun
|
||||
- **Языки**: TypeScript
|
||||
- **Зависимости**:
|
||||
- `swagger-typescript-api` - основной генератор
|
||||
- `commander` - парсинг CLI аргументов
|
||||
- `ejs` - шаблонизатор
|
||||
- `js-yaml` - парсинг YAML
|
||||
- `chalk` - цветной вывод в консоль
|
||||
|
||||
## Рабочий процесс
|
||||
|
||||
1. **Входные данные**: OpenAPI спецификация (JSON/YAML файл или URL)
|
||||
2. **Обработка**:
|
||||
- Валидация конфигурации
|
||||
- Чтение OpenAPI спецификации
|
||||
- Применение кастомных шаблонов EJS
|
||||
- Генерация TypeScript кода
|
||||
3. **Выходные данные**: 3 файла в указанной директории:
|
||||
- `{FileName}.ts` - API endpoints с методами
|
||||
- `http-client.ts` - HTTP клиент с настройками
|
||||
- `data-contracts.ts` - TypeScript типы
|
||||
|
||||
## Ключевые особенности
|
||||
|
||||
### Кастомизация имен методов
|
||||
Хук [`onFormatRouteName`](src/generator.ts:76) убирает суффикс "Controller" из имен методов:
|
||||
- `projectControllerUpdate` → `update`
|
||||
- `authControllerLogin` → `login`
|
||||
|
||||
### Извлечение baseUrl
|
||||
Хук [`onInit`](src/generator.ts:91) автоматически извлекает baseUrl из OpenAPI спецификации (`servers[0].url`)
|
||||
|
||||
### Поддержка источников
|
||||
- Локальные файлы: `./openapi.json`
|
||||
- URL: `https://api.example.com/openapi.json`
|
||||
|
||||
## Использование
|
||||
|
||||
```bash
|
||||
api-codegen -i <путь-к-openapi> -o <выходная-директория> [-n <имя-файла>]
|
||||
```
|
||||
|
||||
### Аргументы
|
||||
- `-i, --input` - путь к OpenAPI файлу (локальный или URL)
|
||||
- `-o, --output` - директория для сохранения
|
||||
- `-n, --name` - опциональное имя файла (по умолчанию из `spec.info.title`)
|
||||
|
||||
## Структура проекта
|
||||
|
||||
```
|
||||
src/
|
||||
├── cli.ts # CLI интерфейс
|
||||
├── config.ts # Типы и валидация конфигурации
|
||||
├── generator.ts # Основная логика генерации
|
||||
├── templates/ # EJS шаблоны
|
||||
│ ├── api.ejs
|
||||
│ ├── http-client.ejs
|
||||
│ ├── data-contracts.ejs
|
||||
│ └── ...
|
||||
└── utils/
|
||||
└── file.ts # Утилиты для работы с файлами
|
||||
```
|
||||
|
||||
## Конфигурация генератора
|
||||
|
||||
[`swaggerGenerateApi`](src/generator.ts:38) настроен с параметрами:
|
||||
- `httpClientType: 'fetch'` - использование Fetch API
|
||||
- `unwrapResponseData: true` - автоматическая распаковка данных ответа
|
||||
- `singleHttpClient: true` - единый HTTP клиент
|
||||
- `extractRequestParams: true` - извлечение параметров запросов
|
||||
- `extractRequestBody: true` - извлечение тел запросов
|
||||
- `extractEnums: true` - извлечение enum типов
|
||||
|
||||
## Примеры использования сгенерированного кода
|
||||
|
||||
```typescript
|
||||
import { Api, HttpClient } from './Api';
|
||||
|
||||
const httpClient = new HttpClient();
|
||||
httpClient.setSecurityData({ token: 'jwt-token' });
|
||||
|
||||
const api = new Api(httpClient);
|
||||
|
||||
// Вызов API методов
|
||||
const user = await api.auth.getProfile();
|
||||
const result = await api.auth.login({ email, password });
|
||||
```
|
||||
|
||||
## Точки расширения
|
||||
|
||||
1. **Шаблоны** - можно модифицировать EJS шаблоны в `src/templates/`
|
||||
2. **Хуки генератора** - можно добавить новые хуки в [`hooks`](src/generator.ts:75)
|
||||
3. **Конфигурация** - можно расширить [`GeneratorConfig`](src/config.ts:4) для новых опций
|
||||
53
README.md
53
README.md
@@ -56,6 +56,59 @@ function Profile() {
|
||||
}
|
||||
```
|
||||
|
||||
## Разработка
|
||||
|
||||
### Сборка
|
||||
```bash
|
||||
bun run build
|
||||
```
|
||||
|
||||
### Тестирование
|
||||
|
||||
Проект использует комплексную систему тестирования с максимальным покрытием (~72 тестовых кейса).
|
||||
|
||||
**Запуск всех тестов:**
|
||||
```bash
|
||||
bun test
|
||||
```
|
||||
|
||||
**Только юнит тесты:**
|
||||
```bash
|
||||
bun test:unit
|
||||
```
|
||||
|
||||
**Только интеграционные тесты:**
|
||||
```bash
|
||||
bun test:integration
|
||||
```
|
||||
|
||||
**Watch режим:**
|
||||
```bash
|
||||
bun test:watch
|
||||
```
|
||||
|
||||
**С coverage:**
|
||||
```bash
|
||||
bun test:coverage
|
||||
```
|
||||
|
||||
Подробная документация по тестированию доступна в [`tests/README.md`](tests/README.md).
|
||||
|
||||
### Структура тестов
|
||||
|
||||
- **Юнит тесты** - CLI, генератор, утилиты, валидация
|
||||
- **Интеграционные тесты** - E2E генерация, сгенерированный клиент
|
||||
- **Тестовые фикстуры** - 7 OpenAPI спецификаций для различных сценариев
|
||||
- **Mock сервер** - для тестирования HTTP запросов
|
||||
|
||||
**Покрываемые сценарии:**
|
||||
- ✅ CLI команды и обработка ошибок
|
||||
- ✅ Генерация TypeScript кода
|
||||
- ✅ Компиляция сгенерированного кода
|
||||
- ✅ HTTP запросы с mock сервером
|
||||
- ✅ Аутентификация (Bearer tokens)
|
||||
- ✅ Edge cases (Unicode, большие спецификации)
|
||||
|
||||
## Лицензия
|
||||
|
||||
MIT
|
||||
|
||||
121
bun.lock
121
bun.lock
@@ -17,6 +17,13 @@
|
||||
"@types/ejs": "^3.1.5",
|
||||
"@types/js-yaml": "^4.0.9",
|
||||
"@types/node": "^22.10.2",
|
||||
"@types/react": "^18.3.0",
|
||||
"@types/tmp": "^0.2.6",
|
||||
"execa": "^8.0.0",
|
||||
"msw": "^2.0.0",
|
||||
"react": "^18.3.0",
|
||||
"swr": "^2.3.0",
|
||||
"tmp": "^0.2.1",
|
||||
},
|
||||
"peerDependencies": {
|
||||
"typescript": "^5",
|
||||
@@ -34,6 +41,24 @@
|
||||
|
||||
"@exodus/schemasafe": ["@exodus/schemasafe@1.3.0", "", {}, "sha512-5Aap/GaRupgNx/feGBwLLTVv8OQFfv3pq2lPRzPg9R+IOBnDgghTGW7l7EuVXOvg5cc/xSAlRW8rBrjIC3Nvqw=="],
|
||||
|
||||
"@inquirer/ansi": ["@inquirer/ansi@1.0.1", "", {}, "sha512-yqq0aJW/5XPhi5xOAL1xRCpe1eh8UFVgYFpFsjEqmIR8rKLyP+HINvFXwUaxYICflJrVlxnp7lLN6As735kVpw=="],
|
||||
|
||||
"@inquirer/confirm": ["@inquirer/confirm@5.1.19", "", { "dependencies": { "@inquirer/core": "^10.3.0", "@inquirer/type": "^3.0.9" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-wQNz9cfcxrtEnUyG5PndC8g3gZ7lGDBzmWiXZkX8ot3vfZ+/BLjR8EvyGX4YzQLeVqtAlY/YScZpW7CW8qMoDQ=="],
|
||||
|
||||
"@inquirer/core": ["@inquirer/core@10.3.0", "", { "dependencies": { "@inquirer/ansi": "^1.0.1", "@inquirer/figures": "^1.0.14", "@inquirer/type": "^3.0.9", "cli-width": "^4.1.0", "mute-stream": "^2.0.0", "signal-exit": "^4.1.0", "wrap-ansi": "^6.2.0", "yoctocolors-cjs": "^2.1.2" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-Uv2aPPPSK5jeCplQmQ9xadnFx2Zhj9b5Dj7bU6ZeCdDNNY11nhYy4btcSdtDguHqCT2h5oNeQTcUNSGGLA7NTA=="],
|
||||
|
||||
"@inquirer/figures": ["@inquirer/figures@1.0.14", "", {}, "sha512-DbFgdt+9/OZYFM+19dbpXOSeAstPy884FPy1KjDu4anWwymZeOYhMY1mdFri172htv6mvc/uvIAAi7b7tvjJBQ=="],
|
||||
|
||||
"@inquirer/type": ["@inquirer/type@3.0.9", "", { "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-QPaNt/nmE2bLGQa9b7wwyRJoLZ7pN6rcyXvzU0YCmivmJyq1BVo94G98tStRWkoD1RgDX5C+dPlhhHzNdu/W/w=="],
|
||||
|
||||
"@mswjs/interceptors": ["@mswjs/interceptors@0.40.0", "", { "dependencies": { "@open-draft/deferred-promise": "^2.2.0", "@open-draft/logger": "^0.3.0", "@open-draft/until": "^2.0.0", "is-node-process": "^1.2.0", "outvariant": "^1.4.3", "strict-event-emitter": "^0.5.1" } }, "sha512-EFd6cVbHsgLa6wa4RljGj6Wk75qoHxUSyc5asLyyPSyuhIcdS2Q3Phw6ImS1q+CkALthJRShiYfKANcQMuMqsQ=="],
|
||||
|
||||
"@open-draft/deferred-promise": ["@open-draft/deferred-promise@2.2.0", "", {}, "sha512-CecwLWx3rhxVQF6V4bAgPS5t+So2sTbPgAzafKkVizyi7tlwpcFpdFqq+wqF2OwNBmqFuu6tOyouTuxgpMfzmA=="],
|
||||
|
||||
"@open-draft/logger": ["@open-draft/logger@0.3.0", "", { "dependencies": { "is-node-process": "^1.2.0", "outvariant": "^1.4.0" } }, "sha512-X2g45fzhxH238HKO4xbSr7+wBS8Fvw6ixhTDuvLd5mqh6bJJCFAPwU9mPDxbcrRtfxv4u5IHCEH77BmxvXmmxQ=="],
|
||||
|
||||
"@open-draft/until": ["@open-draft/until@2.1.0", "", {}, "sha512-U69T3ItWHvLwGg5eJ0n3I62nWuE6ilHlmz7zM0npLBRvPRd7e6NYmg54vvRtP5mZG7kZqZCFVdsTWo7BPtBujg=="],
|
||||
|
||||
"@types/bun": ["@types/bun@1.3.1", "", { "dependencies": { "bun-types": "1.3.1" } }, "sha512-4jNMk2/K9YJtfqwoAa28c8wK+T7nvJFOjxI4h/7sORWcypRNxBpr+TPNaCfVWq70tLCJsqoFwcf0oI0JU/fvMQ=="],
|
||||
|
||||
"@types/ejs": ["@types/ejs@3.1.5", "", {}, "sha512-nv+GSx77ZtXiJzwKdsASqi+YQ5Z7vwHsTP0JY2SiQgjGckkBRKZnk8nIM+7oUZ1VCtuTz0+By4qVR7fqzp/Dfg=="],
|
||||
@@ -44,10 +69,16 @@
|
||||
|
||||
"@types/node": ["@types/node@22.18.12", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-BICHQ67iqxQGFSzfCFTT7MRQ5XcBjG5aeKh5Ok38UBbPe5fxTyE+aHFxwVrGyr8GNlqFMLKD1D3P2K/1ks8tog=="],
|
||||
|
||||
"@types/react": ["@types/react@19.2.2", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA=="],
|
||||
"@types/prop-types": ["@types/prop-types@15.7.15", "", {}, "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw=="],
|
||||
|
||||
"@types/react": ["@types/react@18.3.26", "", { "dependencies": { "@types/prop-types": "*", "csstype": "^3.0.2" } }, "sha512-RFA/bURkcKzx/X9oumPG9Vp3D3JUgus/d0b67KB0t5S/raciymilkOa66olh78MUI92QLbEJevO7rvqU/kjwKA=="],
|
||||
|
||||
"@types/statuses": ["@types/statuses@2.0.6", "", {}, "sha512-xMAgYwceFhRA2zY+XbEA7mxYbA093wdiW8Vu6gZPGWy9cmOyU9XesH1tNcEWsKFd5Vzrqx5T3D38PWx1FIIXkA=="],
|
||||
|
||||
"@types/swagger-schema-official": ["@types/swagger-schema-official@2.0.25", "", {}, "sha512-T92Xav+Gf/Ik1uPW581nA+JftmjWPgskw/WBf4TJzxRG/SJ+DfNnNE+WuZ4mrXuzflQMqMkm1LSYjzYW7MB1Cg=="],
|
||||
|
||||
"@types/tmp": ["@types/tmp@0.2.6", "", {}, "sha512-chhaNf2oKHlRkDGt+tiKE2Z5aJ6qalm7Z9rlLdBwmOiAAf09YQvvoLXjWK4HWPF1xU/fqvMgfNfpVoBscA/tKA=="],
|
||||
|
||||
"ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
|
||||
|
||||
"ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
|
||||
@@ -72,6 +103,8 @@
|
||||
|
||||
"citty": ["citty@0.1.6", "", { "dependencies": { "consola": "^3.2.3" } }, "sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ=="],
|
||||
|
||||
"cli-width": ["cli-width@4.1.0", "", {}, "sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ=="],
|
||||
|
||||
"cliui": ["cliui@8.0.1", "", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", "wrap-ansi": "^7.0.0" } }, "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ=="],
|
||||
|
||||
"color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
|
||||
@@ -84,10 +117,16 @@
|
||||
|
||||
"consola": ["consola@3.4.2", "", {}, "sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA=="],
|
||||
|
||||
"cookie": ["cookie@1.0.2", "", {}, "sha512-9Kr/j4O16ISv8zBBhJoi4bXOYNTkFLOqSL3UDB0njXxCXNezjeyVrJyGOWtgfs/q2km1gwBcfH8q1yEGoMYunA=="],
|
||||
|
||||
"cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
|
||||
|
||||
"csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
|
||||
|
||||
"defu": ["defu@6.1.4", "", {}, "sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg=="],
|
||||
|
||||
"dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],
|
||||
|
||||
"destr": ["destr@2.0.5", "", {}, "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA=="],
|
||||
|
||||
"dotenv": ["dotenv@17.2.3", "", {}, "sha512-JVUnt+DUIzu87TABbhPmNfVdBDt18BLOWjMUFJMSi/Qqg7NTYtabbvSNJGOJ7afbRuv9D/lngizHtP7QyLQ+9w=="],
|
||||
@@ -102,6 +141,8 @@
|
||||
|
||||
"eta": ["eta@3.5.0", "", {}, "sha512-e3x3FBvGzeCIHhF+zhK8FZA2vC5uFn6b4HJjegUbIWrDb4mJ7JjTGMJY9VGIbRVpmSwHopNiaJibhjIr+HfLug=="],
|
||||
|
||||
"execa": ["execa@8.0.1", "", { "dependencies": { "cross-spawn": "^7.0.3", "get-stream": "^8.0.1", "human-signals": "^5.0.0", "is-stream": "^3.0.0", "merge-stream": "^2.0.0", "npm-run-path": "^5.1.0", "onetime": "^6.0.0", "signal-exit": "^4.1.0", "strip-final-newline": "^3.0.0" } }, "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg=="],
|
||||
|
||||
"exsolve": ["exsolve@1.0.7", "", {}, "sha512-VO5fQUzZtI6C+vx4w/4BWJpg3s/5l+6pRQEHzFRM8WFi4XffSP1Z+4qi7GbjWbvRQEbdIco5mIMq+zX4rPuLrw=="],
|
||||
|
||||
"fast-safe-stringify": ["fast-safe-stringify@2.1.1", "", {}, "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA=="],
|
||||
@@ -110,22 +151,48 @@
|
||||
|
||||
"get-caller-file": ["get-caller-file@2.0.5", "", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="],
|
||||
|
||||
"get-stream": ["get-stream@8.0.1", "", {}, "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA=="],
|
||||
|
||||
"giget": ["giget@2.0.0", "", { "dependencies": { "citty": "^0.1.6", "consola": "^3.4.0", "defu": "^6.1.4", "node-fetch-native": "^1.6.6", "nypm": "^0.6.0", "pathe": "^2.0.3" }, "bin": { "giget": "dist/cli.mjs" } }, "sha512-L5bGsVkxJbJgdnwyuheIunkGatUF/zssUoxxjACCseZYAVbaqdh9Tsmmlkl8vYan09H7sbvKt4pS8GqKLBrEzA=="],
|
||||
|
||||
"graphql": ["graphql@16.11.0", "", {}, "sha512-mS1lbMsxgQj6hge1XZ6p7GPhbrtFwUFYi3wRzXAC/FmYnyXMTvvI3td3rjmQ2u8ewXueaSvRPWaEcgVVOT9Jnw=="],
|
||||
|
||||
"headers-polyfill": ["headers-polyfill@4.0.3", "", {}, "sha512-IScLbePpkvO846sIwOtOTDjutRMWdXdJmXdMvk6gCBHxFO8d+QKOQedyZSxFTTFYRSmlgSTDtXqqq4pcenBXLQ=="],
|
||||
|
||||
"http2-client": ["http2-client@1.3.5", "", {}, "sha512-EC2utToWl4RKfs5zd36Mxq7nzHHBuomZboI0yYL6Y0RmBgT7Sgkq4rQ0ezFTYoIsSs7Tm9SJe+o2FcAg6GBhGA=="],
|
||||
|
||||
"human-signals": ["human-signals@5.0.0", "", {}, "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ=="],
|
||||
|
||||
"is-fullwidth-code-point": ["is-fullwidth-code-point@3.0.0", "", {}, "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="],
|
||||
|
||||
"is-node-process": ["is-node-process@1.2.0", "", {}, "sha512-Vg4o6/fqPxIjtxgUH5QLJhwZ7gW5diGCVlXpuUfELC62CuxM1iHcRe51f2W1FDy04Ai4KJkagKjx3XaqyfRKXw=="],
|
||||
|
||||
"is-stream": ["is-stream@3.0.0", "", {}, "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA=="],
|
||||
|
||||
"isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
|
||||
|
||||
"jake": ["jake@10.9.4", "", { "dependencies": { "async": "^3.2.6", "filelist": "^1.0.4", "picocolors": "^1.1.1" }, "bin": { "jake": "bin/cli.js" } }, "sha512-wpHYzhxiVQL+IV05BLE2Xn34zW1S223hvjtqk0+gsPrwd/8JNLXJgZZM/iPFsYc1xyphF+6M6EvdE5E9MBGkDA=="],
|
||||
|
||||
"jiti": ["jiti@2.6.1", "", { "bin": { "jiti": "lib/jiti-cli.mjs" } }, "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ=="],
|
||||
|
||||
"js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="],
|
||||
|
||||
"js-yaml": ["js-yaml@4.1.0", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA=="],
|
||||
|
||||
"lodash": ["lodash@4.17.21", "", {}, "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="],
|
||||
|
||||
"loose-envify": ["loose-envify@1.4.0", "", { "dependencies": { "js-tokens": "^3.0.0 || ^4.0.0" }, "bin": { "loose-envify": "cli.js" } }, "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q=="],
|
||||
|
||||
"merge-stream": ["merge-stream@2.0.0", "", {}, "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w=="],
|
||||
|
||||
"mimic-fn": ["mimic-fn@4.0.0", "", {}, "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw=="],
|
||||
|
||||
"minimatch": ["minimatch@5.1.6", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g=="],
|
||||
|
||||
"msw": ["msw@2.11.6", "", { "dependencies": { "@inquirer/confirm": "^5.0.0", "@mswjs/interceptors": "^0.40.0", "@open-draft/deferred-promise": "^2.2.0", "@types/statuses": "^2.0.4", "cookie": "^1.0.2", "graphql": "^16.8.1", "headers-polyfill": "^4.0.2", "is-node-process": "^1.2.0", "outvariant": "^1.4.3", "path-to-regexp": "^6.3.0", "picocolors": "^1.1.1", "rettime": "^0.7.0", "statuses": "^2.0.2", "strict-event-emitter": "^0.5.1", "tough-cookie": "^6.0.0", "type-fest": "^4.26.1", "until-async": "^3.0.2", "yargs": "^17.7.2" }, "peerDependencies": { "typescript": ">= 4.8.x" }, "optionalPeers": ["typescript"], "bin": { "msw": "cli/index.js" } }, "sha512-MCYMykvmiYScyUm7I6y0VCxpNq1rgd5v7kG8ks5dKtvmxRUUPjribX6mUoUNBbM5/3PhUyoelEWiKXGOz84c+w=="],
|
||||
|
||||
"mute-stream": ["mute-stream@2.0.0", "", {}, "sha512-WWdIxpyjEn+FhQJQQv9aQAYlHoNVdzIzUySNV1gHUPDSdZJ3yZn7pAAbQcV7B56Mvu881q9FZV+0Vx2xC44VWA=="],
|
||||
|
||||
"nanoid": ["nanoid@5.1.6", "", { "bin": { "nanoid": "bin/nanoid.js" } }, "sha512-c7+7RQ+dMB5dPwwCp4ee1/iV/q2P6aK1mTZcfr1BTuVlyW9hJYiMPybJCcnBlQtuSmTIWNeazm/zqNoZSSElBg=="],
|
||||
|
||||
"node-fetch": ["node-fetch@2.7.0", "", { "dependencies": { "whatwg-url": "^5.0.0" }, "peerDependencies": { "encoding": "^0.1.0" }, "optionalPeers": ["encoding"] }, "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A=="],
|
||||
@@ -136,6 +203,8 @@
|
||||
|
||||
"node-readfiles": ["node-readfiles@0.2.0", "", { "dependencies": { "es6-promise": "^3.2.1" } }, "sha512-SU00ZarexNlE4Rjdm83vglt5Y9yiQ+XI1XpflWlb7q7UTN1JUItm69xMeiQCTxtTfnzt+83T8Cx+vI2ED++VDA=="],
|
||||
|
||||
"npm-run-path": ["npm-run-path@5.3.0", "", { "dependencies": { "path-key": "^4.0.0" } }, "sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ=="],
|
||||
|
||||
"nypm": ["nypm@0.6.2", "", { "dependencies": { "citty": "^0.1.6", "consola": "^3.4.2", "pathe": "^2.0.3", "pkg-types": "^2.3.0", "tinyexec": "^1.0.1" }, "bin": { "nypm": "dist/cli.mjs" } }, "sha512-7eM+hpOtrKrBDCh7Ypu2lJ9Z7PNZBdi/8AT3AX8xoCj43BBVHD0hPSTEvMtkMpfs8FCqBGhxB+uToIQimA111g=="],
|
||||
|
||||
"oas-kit-common": ["oas-kit-common@1.0.8", "", { "dependencies": { "fast-safe-stringify": "^2.0.7" } }, "sha512-pJTS2+T0oGIwgjGpw7sIRU8RQMcUoKCDWFLdBqKB2BNmGpbBMH2sdqAaOXUg8OzonZHU0L7vfJu1mJFEiYDWOQ=="],
|
||||
@@ -150,8 +219,16 @@
|
||||
|
||||
"ohash": ["ohash@2.0.11", "", {}, "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ=="],
|
||||
|
||||
"onetime": ["onetime@6.0.0", "", { "dependencies": { "mimic-fn": "^4.0.0" } }, "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ=="],
|
||||
|
||||
"openapi-types": ["openapi-types@12.1.3", "", {}, "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw=="],
|
||||
|
||||
"outvariant": ["outvariant@1.4.3", "", {}, "sha512-+Sl2UErvtsoajRDKCE5/dBz4DIvHXQQnAxtQTF04OJxY0+DyZXSo5P5Bb7XYWOh81syohlYL24hbDwxedPUJCA=="],
|
||||
|
||||
"path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
|
||||
|
||||
"path-to-regexp": ["path-to-regexp@6.3.0", "", {}, "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ=="],
|
||||
|
||||
"pathe": ["pathe@2.0.3", "", {}, "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w=="],
|
||||
|
||||
"perfect-debounce": ["perfect-debounce@2.0.0", "", {}, "sha512-fkEH/OBiKrqqI/yIgjR92lMfs2K8105zt/VT6+7eTjNwisrsh47CeIED9z58zI7DfKdH3uHAn25ziRZn3kgAow=="],
|
||||
@@ -162,12 +239,20 @@
|
||||
|
||||
"rc9": ["rc9@2.1.2", "", { "dependencies": { "defu": "^6.1.4", "destr": "^2.0.3" } }, "sha512-btXCnMmRIBINM2LDZoEmOogIZU7Qe7zn4BpomSKZ/ykbLObuBdvG+mFq11DL6fjH1DRwHhrlgtYWG96bJiC7Cg=="],
|
||||
|
||||
"react": ["react@18.3.1", "", { "dependencies": { "loose-envify": "^1.1.0" } }, "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ=="],
|
||||
|
||||
"readdirp": ["readdirp@4.1.2", "", {}, "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg=="],
|
||||
|
||||
"reftools": ["reftools@1.1.9", "", {}, "sha512-OVede/NQE13xBQ+ob5CKd5KyeJYU2YInb1bmV4nRoOfquZPkAkxuOXicSe1PvqIuZZ4kD13sPKBbR7UFDmli6w=="],
|
||||
|
||||
"require-directory": ["require-directory@2.1.1", "", {}, "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q=="],
|
||||
|
||||
"rettime": ["rettime@0.7.0", "", {}, "sha512-LPRKoHnLKd/r3dVxcwO7vhCW+orkOGj9ViueosEBK6ie89CijnfRlhaDhHq/3Hxu4CkWQtxwlBG0mzTQY6uQjw=="],
|
||||
|
||||
"shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
|
||||
|
||||
"shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
|
||||
|
||||
"should": ["should@13.2.3", "", { "dependencies": { "should-equal": "^2.0.0", "should-format": "^3.0.3", "should-type": "^1.4.0", "should-type-adaptors": "^1.0.1", "should-util": "^1.0.0" } }, "sha512-ggLesLtu2xp+ZxI+ysJTmNjh2U0TsC+rQ/pfED9bUZZ4DKefP27D+7YJVVTvKsmjLpIi9jAa7itwDGkDDmt1GQ=="],
|
||||
|
||||
"should-equal": ["should-equal@2.0.0", "", { "dependencies": { "should-type": "^1.4.0" } }, "sha512-ZP36TMrK9euEuWQYBig9W55WPC7uo37qzAEmbjHz4gfyuXrEUgF8cUvQVO+w+d3OMfPvSRQJ22lSm8MQJ43LTA=="],
|
||||
@@ -180,29 +265,55 @@
|
||||
|
||||
"should-util": ["should-util@1.0.1", "", {}, "sha512-oXF8tfxx5cDk8r2kYqlkUJzZpDBqVY/II2WhvU0n9Y3XYvAYRmeaf1PvvIvTgPnv4KJ+ES5M0PyDq5Jp+Ygy2g=="],
|
||||
|
||||
"signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
|
||||
|
||||
"statuses": ["statuses@2.0.2", "", {}, "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw=="],
|
||||
|
||||
"strict-event-emitter": ["strict-event-emitter@0.5.1", "", {}, "sha512-vMgjE/GGEPEFnhFub6pa4FmJBRBVOLpIII2hvCZ8Kzb7K0hlHo7mQv6xYrBvCL2LtAIBwFUK8wvuJgTVSQ5MFQ=="],
|
||||
|
||||
"string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
|
||||
|
||||
"strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
|
||||
|
||||
"strip-final-newline": ["strip-final-newline@3.0.0", "", {}, "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw=="],
|
||||
|
||||
"swagger-schema-official": ["swagger-schema-official@2.0.0-bab6bed", "", {}, "sha512-rCC0NWGKr/IJhtRuPq/t37qvZHI/mH4I4sxflVM+qgVe5Z2uOCivzWaVbuioJaB61kvm5UvB7b49E+oBY0M8jA=="],
|
||||
|
||||
"swagger-typescript-api": ["swagger-typescript-api@13.2.16", "", { "dependencies": { "@biomejs/js-api": "3.0.0", "@biomejs/wasm-nodejs": "2.2.6", "@types/lodash": "^4.17.20", "@types/swagger-schema-official": "^2.0.25", "c12": "^3.3.0", "citty": "^0.1.6", "consola": "^3.4.2", "eta": "^3.5.0", "lodash": "^4.17.21", "nanoid": "^5.1.6", "openapi-types": "^12.1.3", "swagger-schema-official": "2.0.0-bab6bed", "swagger2openapi": "^7.0.8", "typescript": "~5.9.3", "yaml": "^2.8.1" }, "bin": { "sta": "./dist/cli.js", "swagger-typescript-api": "./dist/cli.js" } }, "sha512-PbjfCbNMx1mxqLamUpMA96fl2HJQh9Q5qRWyVRXmZslRJFHBkMfAj7OnEv6IOtSnmD+TXp073yBhKWiUxqeLhQ=="],
|
||||
|
||||
"swagger2openapi": ["swagger2openapi@7.0.8", "", { "dependencies": { "call-me-maybe": "^1.0.1", "node-fetch": "^2.6.1", "node-fetch-h2": "^2.3.0", "node-readfiles": "^0.2.0", "oas-kit-common": "^1.0.8", "oas-resolver": "^2.5.6", "oas-schema-walker": "^1.1.5", "oas-validator": "^5.0.8", "reftools": "^1.1.9", "yaml": "^1.10.0", "yargs": "^17.0.1" }, "bin": { "swagger2openapi": "swagger2openapi.js", "oas-validate": "oas-validate.js", "boast": "boast.js" } }, "sha512-upi/0ZGkYgEcLeGieoz8gT74oWHA0E7JivX7aN9mAf+Tc7BQoRBvnIGHoPDw+f9TXTW4s6kGYCZJtauP6OYp7g=="],
|
||||
|
||||
"swr": ["swr@2.3.6", "", { "dependencies": { "dequal": "^2.0.3", "use-sync-external-store": "^1.4.0" }, "peerDependencies": { "react": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-wfHRmHWk/isGNMwlLGlZX5Gzz/uTgo0o2IRuTMcf4CPuPFJZlq0rDaKUx+ozB5nBOReNV1kiOyzMfj+MBMikLw=="],
|
||||
|
||||
"tinyexec": ["tinyexec@1.0.1", "", {}, "sha512-5uC6DDlmeqiOwCPmK9jMSdOuZTh8bU39Ys6yidB+UTt5hfZUPGAypSgFRiEp+jbi9qH40BLDvy85jIU88wKSqw=="],
|
||||
|
||||
"tldts": ["tldts@7.0.17", "", { "dependencies": { "tldts-core": "^7.0.17" }, "bin": { "tldts": "bin/cli.js" } }, "sha512-Y1KQBgDd/NUc+LfOtKS6mNsC9CCaH+m2P1RoIZy7RAPo3C3/t8X45+zgut31cRZtZ3xKPjfn3TkGTrctC2TQIQ=="],
|
||||
|
||||
"tldts-core": ["tldts-core@7.0.17", "", {}, "sha512-DieYoGrP78PWKsrXr8MZwtQ7GLCUeLxihtjC1jZsW1DnvSMdKPitJSe8OSYDM2u5H6g3kWJZpePqkp43TfLh0g=="],
|
||||
|
||||
"tmp": ["tmp@0.2.5", "", {}, "sha512-voyz6MApa1rQGUxT3E+BK7/ROe8itEx7vD8/HEvt4xwXucvQ5G5oeEiHkmHZJuBO21RpOf+YYm9MOivj709jow=="],
|
||||
|
||||
"tough-cookie": ["tough-cookie@6.0.0", "", { "dependencies": { "tldts": "^7.0.5" } }, "sha512-kXuRi1mtaKMrsLUxz3sQYvVl37B0Ns6MzfrtV5DvJceE9bPyspOqk9xxv7XbZWcfLWbFmm997vl83qUWVJA64w=="],
|
||||
|
||||
"tr46": ["tr46@0.0.3", "", {}, "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw=="],
|
||||
|
||||
"type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
|
||||
|
||||
"typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
|
||||
|
||||
"undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
|
||||
|
||||
"until-async": ["until-async@3.0.2", "", {}, "sha512-IiSk4HlzAMqTUseHHe3VhIGyuFmN90zMTpD3Z3y8jeQbzLIq500MVM7Jq2vUAnTKAFPJrqwkzr6PoTcPhGcOiw=="],
|
||||
|
||||
"use-sync-external-store": ["use-sync-external-store@1.6.0", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w=="],
|
||||
|
||||
"webidl-conversions": ["webidl-conversions@3.0.1", "", {}, "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ=="],
|
||||
|
||||
"whatwg-url": ["whatwg-url@5.0.0", "", { "dependencies": { "tr46": "~0.0.3", "webidl-conversions": "^3.0.0" } }, "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw=="],
|
||||
|
||||
"wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
|
||||
"which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
|
||||
|
||||
"wrap-ansi": ["wrap-ansi@6.2.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA=="],
|
||||
|
||||
"y18n": ["y18n@5.0.8", "", {}, "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA=="],
|
||||
|
||||
@@ -212,8 +323,14 @@
|
||||
|
||||
"yargs-parser": ["yargs-parser@21.1.1", "", {}, "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw=="],
|
||||
|
||||
"yoctocolors-cjs": ["yoctocolors-cjs@2.1.3", "", {}, "sha512-U/PBtDf35ff0D8X8D0jfdzHYEPFxAI7jJlxZXwCSez5M3190m+QobIfh+sWDWSHMCWWJN2AWamkegn6vr6YBTw=="],
|
||||
|
||||
"bun-types/@types/node": ["@types/node@24.9.1", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-QoiaXANRkSXK6p0Duvt56W208du4P9Uye9hWLWgGMDTEoKPhuenzNcC4vGUmrNkiOKTlIrBoyNQYNpSwfEZXSg=="],
|
||||
|
||||
"cliui/wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
|
||||
|
||||
"npm-run-path/path-key": ["path-key@4.0.0", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],
|
||||
|
||||
"oas-linter/yaml": ["yaml@1.10.2", "", {}, "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg=="],
|
||||
|
||||
"oas-resolver/yaml": ["yaml@1.10.2", "", {}, "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg=="],
|
||||
|
||||
15
package.json
15
package.json
@@ -9,7 +9,11 @@
|
||||
"scripts": {
|
||||
"build": "bun build src/cli.ts --target=node --outdir=dist --format=esm",
|
||||
"dev": "bun run src/cli.ts",
|
||||
"test": "bun test"
|
||||
"test": "bun test",
|
||||
"test:unit": "bun test tests/unit",
|
||||
"test:integration": "bun test tests/integration",
|
||||
"test:watch": "bun test --watch",
|
||||
"test:coverage": "bun test --coverage"
|
||||
},
|
||||
"dependencies": {
|
||||
"@biomejs/wasm-bundler": "^2.3.0",
|
||||
@@ -24,7 +28,14 @@
|
||||
"@types/bun": "latest",
|
||||
"@types/ejs": "^3.1.5",
|
||||
"@types/js-yaml": "^4.0.9",
|
||||
"@types/node": "^22.10.2"
|
||||
"@types/node": "^22.10.2",
|
||||
"@types/react": "^18.3.0",
|
||||
"@types/tmp": "^0.2.6",
|
||||
"execa": "^8.0.0",
|
||||
"msw": "^2.0.0",
|
||||
"react": "^18.3.0",
|
||||
"swr": "^2.3.0",
|
||||
"tmp": "^0.2.1"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"typescript": "^5"
|
||||
|
||||
@@ -12,18 +12,18 @@ program
|
||||
.name('api-codegen')
|
||||
.description('Generate TypeScript API client from OpenAPI specification')
|
||||
.version('1.0.0')
|
||||
.requiredOption('-u, --url <url>', 'Base API URL (e.g., https://api.example.com)')
|
||||
.requiredOption('-i, --input <path>', 'Path to OpenAPI specification file (JSON or YAML)')
|
||||
.requiredOption('-o, --output <path>', 'Output directory for generated files')
|
||||
.option('-n, --name <name>', 'Name of generated file (without extension)')
|
||||
.option('--swr', 'Generate SWR hooks for React')
|
||||
.action(async (options) => {
|
||||
try {
|
||||
// Создание конфигурации
|
||||
const config: Partial<GeneratorConfig> = {
|
||||
apiUrl: options.url,
|
||||
inputPath: options.input,
|
||||
outputPath: options.output,
|
||||
fileName: options.name,
|
||||
useSwr: options.swr || false,
|
||||
};
|
||||
|
||||
// Валидация конфигурации
|
||||
@@ -40,7 +40,7 @@ program
|
||||
// Генерация API
|
||||
await generate(config as GeneratorConfig);
|
||||
|
||||
console.log(chalk.green('\n✨ Done!\n'));
|
||||
console.log(chalk.green('\n✨ API client generated successfully!\n'));
|
||||
} catch (error) {
|
||||
console.error(chalk.red('\n❌ Error:'), error instanceof Error ? error.message : error);
|
||||
console.error();
|
||||
|
||||
@@ -2,14 +2,14 @@
|
||||
* Конфигурация генератора API
|
||||
*/
|
||||
export interface GeneratorConfig {
|
||||
/** Базовый URL API */
|
||||
apiUrl: string;
|
||||
/** Путь к файлу OpenAPI спецификации */
|
||||
inputPath: string;
|
||||
/** Путь для сохранения сгенерированных файлов */
|
||||
outputPath: string;
|
||||
/** Имя сгенерированного файла (без расширения) */
|
||||
fileName?: string;
|
||||
/** Генерировать SWR hooks для React */
|
||||
useSwr?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -18,12 +18,6 @@ export interface GeneratorConfig {
|
||||
export function validateConfig(config: Partial<GeneratorConfig>): config is GeneratorConfig {
|
||||
const errors: string[] = [];
|
||||
|
||||
if (!config.apiUrl) {
|
||||
errors.push('API URL is required (--url)');
|
||||
} else if (!isValidUrl(config.apiUrl)) {
|
||||
errors.push('API URL must be a valid URL');
|
||||
}
|
||||
|
||||
if (!config.inputPath) {
|
||||
errors.push('Input path is required (--input)');
|
||||
}
|
||||
@@ -39,15 +33,3 @@ export function validateConfig(config: Partial<GeneratorConfig>): config is Gene
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверка валидности URL
|
||||
*/
|
||||
function isValidUrl(url: string): boolean {
|
||||
try {
|
||||
new URL(url);
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -1,10 +1,9 @@
|
||||
import { generateApi as swaggerGenerateApi } from 'swagger-typescript-api';
|
||||
import { resolve, join } from 'path';
|
||||
import { resolve } from 'path';
|
||||
import { fileURLToPath } from 'url';
|
||||
import { dirname } from 'path';
|
||||
import { unlink } from 'fs/promises';
|
||||
import type { GeneratorConfig } from './config.js';
|
||||
import { ensureDir, readJsonFile, writeFileWithDirs } from './utils/file.js';
|
||||
import { ensureDir, readJsonFile } from './utils/file.js';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = dirname(__filename);
|
||||
@@ -19,32 +18,34 @@ export async function generate(config: GeneratorConfig): Promise<void> {
|
||||
// Путь к кастомным шаблонам
|
||||
const templatesPath = resolve(__dirname, '../src/templates');
|
||||
|
||||
|
||||
// Читаем и модифицируем OpenAPI спецификацию
|
||||
const inputPath = config.inputPath.startsWith('http://') || config.inputPath.startsWith('https://')
|
||||
? config.inputPath
|
||||
: resolve(config.inputPath);
|
||||
const spec = await readJsonFile<any>(inputPath);
|
||||
// Проверяем тип входного пути
|
||||
const isUrl = config.inputPath.startsWith('http://') || config.inputPath.startsWith('https://');
|
||||
|
||||
// Для локальных файлов читаем спецификацию
|
||||
let spec: any = null;
|
||||
let inputPath: string | undefined = undefined;
|
||||
let url: string | undefined = undefined;
|
||||
|
||||
if (isUrl) {
|
||||
url = config.inputPath;
|
||||
// Для URL не читаем спецификацию заранее, swagger-typescript-api сделает это сам
|
||||
} else {
|
||||
inputPath = resolve(config.inputPath);
|
||||
spec = await readJsonFile<any>(inputPath);
|
||||
}
|
||||
|
||||
// Определяем имя файла
|
||||
let fileName = config.fileName;
|
||||
if (!fileName) {
|
||||
// Пытаемся получить имя из OpenAPI спецификации
|
||||
fileName = spec.info?.title
|
||||
fileName = spec?.info?.title
|
||||
? spec.info.title.replace(/[^a-zA-Z0-9]/g, '')
|
||||
: 'Api';
|
||||
}
|
||||
|
||||
// Добавляем или обновляем servers с baseUrl
|
||||
spec.servers = [{ url: config.apiUrl }];
|
||||
|
||||
// Сохраняем модифицированную спецификацию во временный файл
|
||||
const tempSpecPath = join(config.outputPath, '.openapi-temp.json');
|
||||
await writeFileWithDirs(tempSpecPath, JSON.stringify(spec, null, 2));
|
||||
|
||||
try {
|
||||
await swaggerGenerateApi({
|
||||
input: tempSpecPath,
|
||||
...(isUrl ? { url } : { input: inputPath }),
|
||||
output: resolve(config.outputPath),
|
||||
fileName: `${fileName}.ts`,
|
||||
httpClientType: 'fetch',
|
||||
@@ -68,7 +69,7 @@ export async function generate(config: GeneratorConfig): Promise<void> {
|
||||
sortRoutes: false,
|
||||
extractResponseError: false,
|
||||
fixInvalidEnumKeyPrefix: 'KEY',
|
||||
silent: false,
|
||||
silent: true,
|
||||
defaultResponseType: 'void',
|
||||
typePrefix: '',
|
||||
typeSuffix: '',
|
||||
@@ -96,34 +97,22 @@ export async function generate(config: GeneratorConfig): Promise<void> {
|
||||
|
||||
return templateRouteName;
|
||||
},
|
||||
onInit: (configuration, codeGenProcess) => {
|
||||
// Передаём baseUrl в конфигурацию для шаблонов
|
||||
onInit: (configuration) => {
|
||||
// Получаем дефолтный baseUrl из OpenAPI спецификации
|
||||
const apiConfig = (configuration as any).apiConfig || {};
|
||||
const defaultBaseUrl = spec?.servers?.[0]?.url || apiConfig.baseUrl || '';
|
||||
(configuration as any).apiConfig = (configuration as any).apiConfig || {};
|
||||
(configuration as any).apiConfig.baseUrl = config.apiUrl;
|
||||
(configuration as any).apiConfig.baseUrl = defaultBaseUrl;
|
||||
// Передаем флаг useSwr в шаблоны
|
||||
(configuration as any).useSwr = config.useSwr || false;
|
||||
return configuration;
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
console.log(`Generated files in ${config.outputPath}:`);
|
||||
console.log(` - ${fileName}.ts (API endpoints)`);
|
||||
console.log(' - http-client.ts (HTTP client)');
|
||||
console.log(' - data-contracts.ts (TypeScript types)');
|
||||
|
||||
// Удаляем временный файл
|
||||
try {
|
||||
await unlink(tempSpecPath);
|
||||
} catch (e) {
|
||||
// Игнорируем ошибки удаления
|
||||
}
|
||||
// Генерация успешна
|
||||
} catch (error) {
|
||||
console.error('❌ Generation failed:', error);
|
||||
// Удаляем временный файл даже при ошибке
|
||||
try {
|
||||
await unlink(tempSpecPath);
|
||||
} catch (e) {
|
||||
// Игнорируем ошибки удаления
|
||||
}
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -26,8 +26,9 @@ const descriptionLines = _.compact([
|
||||
|
||||
%>
|
||||
|
||||
<% if (config.useSwr) { %>
|
||||
import useSWR from "swr";
|
||||
import { fetcher } from "./http-client";
|
||||
<% } %>
|
||||
|
||||
<% if (config.httpClientType === config.constants.HTTP_CLIENT.AXIOS) { %> import type { AxiosRequestConfig, AxiosResponse } from "axios"; <% } %>
|
||||
|
||||
@@ -44,8 +45,8 @@ export class <%~ config.apiClassName %><SecurityDataType extends unknown><% if (
|
||||
<% if(config.singleHttpClient) { %>
|
||||
http: HttpClient<SecurityDataType>;
|
||||
|
||||
constructor (http: HttpClient<SecurityDataType>) {
|
||||
this.http = http;
|
||||
constructor (http?: HttpClient<SecurityDataType>) {
|
||||
this.http = http || new HttpClient<SecurityDataType>();
|
||||
}
|
||||
<% } %>
|
||||
|
||||
|
||||
@@ -102,9 +102,9 @@ const isValidIdentifier = (name) => /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
|
||||
...<%~ _.get(requestConfigParam, "name") %>,
|
||||
})<%~ route.namespace ? ',' : '' %>
|
||||
<%
|
||||
// Генерируем use* функцию для GET запросов
|
||||
// Генерируем use* функцию для GET запросов (только если включен флаг useSwr)
|
||||
const isGetRequest = _.upperCase(method) === 'GET';
|
||||
if (isGetRequest) {
|
||||
if (config.useSwr && isGetRequest) {
|
||||
const useMethodName = 'use' + _.upperFirst(route.routeName.usage);
|
||||
const argsWithoutParams = rawWrapperArgs.filter(arg => arg.name !== requestConfigParam.name);
|
||||
const useWrapperArgs = _
|
||||
|
||||
180
tests/README.md
Normal file
180
tests/README.md
Normal file
@@ -0,0 +1,180 @@
|
||||
# Документация по тестированию API CodeGen
|
||||
|
||||
## Обзор
|
||||
|
||||
Проект использует комплексную систему тестирования с максимальным покрытием:
|
||||
- **Юнит тесты** - тестирование отдельных модулей
|
||||
- **Интеграционные тесты** - тестирование взаимодействия компонентов
|
||||
- **E2E тесты** - полный цикл от генерации до использования
|
||||
|
||||
**Общее количество тестов:** ~72 кейса
|
||||
|
||||
## Стек технологий
|
||||
|
||||
- **Bun test** - встроенный test runner (быстрый, совместим с Jest API)
|
||||
- **msw** - Mock Service Worker для HTTP мокирования
|
||||
- **tmp** - создание временных директорий
|
||||
- **execa** - запуск CLI команд
|
||||
|
||||
## Структура тестов
|
||||
|
||||
```
|
||||
tests/
|
||||
├── fixtures/ # Тестовые OpenAPI спецификации
|
||||
│ ├── minimal.json # Минимальная валидная спецификация
|
||||
│ ├── valid.json # Полная валидная спецификация
|
||||
│ ├── complex.json # Сложная (100+ endpoints)
|
||||
│ ├── with-auth.json # С authentication
|
||||
│ ├── invalid.json # Невалидная спецификация
|
||||
│ ├── empty.json # Пустая спецификация
|
||||
│ └── edge-cases.json # Unicode, спецсимволы
|
||||
│
|
||||
├── helpers/ # Вспомогательные функции
|
||||
│ ├── setup.ts # Создание/очистка temp директорий
|
||||
│ ├── mock-server.ts # Mock HTTP сервер
|
||||
│ └── fixtures.ts # Утилиты для фикстур
|
||||
│
|
||||
├── unit/ # Юнит тесты
|
||||
│ ├── cli.test.ts # CLI команды
|
||||
│ ├── generator.test.ts # Генератор
|
||||
│ ├── config.test.ts # Валидация конфигурации
|
||||
│ └── utils/
|
||||
│ └── file.test.ts # Файловые утилиты
|
||||
│
|
||||
└── integration/ # Интеграционные тесты
|
||||
├── e2e-generation.test.ts # E2E генерация
|
||||
└── generated-client.test.ts # Сгенерированный клиент
|
||||
```
|
||||
|
||||
## Запуск тестов
|
||||
|
||||
### Все тесты
|
||||
```bash
|
||||
bun test
|
||||
```
|
||||
|
||||
### Только юнит тесты
|
||||
```bash
|
||||
bun test:unit
|
||||
```
|
||||
|
||||
### Только интеграционные тесты
|
||||
```bash
|
||||
bun test:integration
|
||||
```
|
||||
|
||||
### Watch режим
|
||||
```bash
|
||||
bun test:watch
|
||||
```
|
||||
|
||||
### С coverage
|
||||
```bash
|
||||
bun test:coverage
|
||||
```
|
||||
|
||||
### Конкретный файл
|
||||
```bash
|
||||
bun test tests/unit/cli.test.ts
|
||||
```
|
||||
|
||||
### Конкретный тест
|
||||
```bash
|
||||
bun test -t "should generate client with custom name"
|
||||
```
|
||||
|
||||
## Покрываемые сценарии
|
||||
|
||||
### 1. CLI тесты (15 кейсов)
|
||||
|
||||
**Базовые сценарии:**
|
||||
- ✅ Запуск с локальным файлом
|
||||
- ✅ Запуск с URL
|
||||
- ✅ Генерация с кастомным именем
|
||||
- ✅ Автоматическое имя из OpenAPI title
|
||||
- ✅ Отображение версии `--version`
|
||||
- ✅ Отображение help `--help`
|
||||
|
||||
**Обработка ошибок:**
|
||||
- ❌ Отсутствие `--input`
|
||||
- ❌ Отсутствие `--output`
|
||||
- ❌ Несуществующий файл
|
||||
- ❌ Невалидный OpenAPI
|
||||
- ❌ Недоступный URL
|
||||
- ❌ Ошибки записи
|
||||
|
||||
### 2. Генератор (20 кейсов)
|
||||
|
||||
**Корректная генерация:**
|
||||
- ✅ Создание файла
|
||||
- ✅ Структура кода
|
||||
- ✅ Все HTTP методы (GET, POST, PUT, PATCH, DELETE)
|
||||
- ✅ Типы для request/response
|
||||
- ✅ Path/query параметры
|
||||
- ✅ Request body
|
||||
- ✅ Enum типы
|
||||
- ✅ Bearer authentication
|
||||
- ✅ Хук `onFormatRouteName`
|
||||
- ✅ BaseUrl из servers
|
||||
|
||||
**Edge cases:**
|
||||
- ❌ Пустая спецификация
|
||||
- ❌ Минимальная спецификация
|
||||
- ❌ Сложная спецификация (100+ endpoints)
|
||||
- ❌ Unicode символы
|
||||
|
||||
### 3. Утилиты (10 кейсов)
|
||||
|
||||
**file.test.ts:**
|
||||
- ✅ `fileExists()` - существующий файл
|
||||
- ✅ `fileExists()` - несуществующий файл
|
||||
- ✅ `readJsonFile()` - локальный файл
|
||||
- ✅ `readJsonFile()` - URL
|
||||
- ❌ `readJsonFile()` - невалидный JSON
|
||||
- ❌ `readJsonFile()` - недоступный URL
|
||||
- ✅ `ensureDir()` - создание директорий
|
||||
- ✅ `writeFileWithDirs()` - запись с созданием директорий
|
||||
|
||||
**config.test.ts:**
|
||||
- ✅ Валидная конфигурация
|
||||
- ❌ Без inputPath
|
||||
- ❌ Без outputPath
|
||||
- ✅ Опциональное поле fileName
|
||||
|
||||
### 4. Сгенерированный клиент (7 кейсов)
|
||||
|
||||
**Компиляция:**
|
||||
- ✅ TypeScript компиляция без ошибок
|
||||
- ✅ Отсутствие type errors
|
||||
- ✅ Корректные импорты/экспорты
|
||||
|
||||
**Корректность API:**
|
||||
- ✅ Все endpoints присутствуют
|
||||
- ✅ Корректные имена методов
|
||||
- ✅ HttpClient инициализация
|
||||
- ✅ Метод `setSecurityData`
|
||||
|
||||
### 5. Интеграционные E2E (15 кейсов)
|
||||
|
||||
**Полный цикл:**
|
||||
- ✅ CLI → создание → импорт → использование
|
||||
- ✅ Генерация из локального файла
|
||||
- ✅ Генерация из URL
|
||||
- ✅ Повторная генерация
|
||||
|
||||
**HTTP с mock:**
|
||||
- ✅ GET без параметров
|
||||
- ✅ GET с query параметрами
|
||||
- ✅ POST с body
|
||||
- ✅ PUT/PATCH/DELETE
|
||||
- ✅ Статусы 200, 201, 400, 401, 404, 500
|
||||
- ❌ Network errors
|
||||
- ✅ Bearer authentication
|
||||
- ✅ Custom headers
|
||||
|
||||
|
||||
## Дополнительная информация
|
||||
|
||||
- [План тестирования](../TESTING-PLAN.md)
|
||||
- [Contributing Guidelines](../CONTRIBUTING.md)
|
||||
- [Bun Test Documentation](https://bun.sh/docs/cli/test)
|
||||
317
tests/fixtures/complex.json
vendored
Normal file
317
tests/fixtures/complex.json
vendored
Normal file
@@ -0,0 +1,317 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Complex API",
|
||||
"version": "1.0.0",
|
||||
"description": "Большая спецификация для тестирования производительности"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "https://api.example.com"
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/products": {
|
||||
"get": {
|
||||
"operationId": "ProductController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/Product"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"post": {
|
||||
"operationId": "ProductController_create",
|
||||
"requestBody": {
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/CreateProduct"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"201": {
|
||||
"description": "Created"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/products/{id}": {
|
||||
"get": {
|
||||
"operationId": "ProductController_getById",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
},
|
||||
"put": {
|
||||
"operationId": "ProductController_update",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
},
|
||||
"delete": {
|
||||
"operationId": "ProductController_delete",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"204": {
|
||||
"description": "Deleted"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/categories": {
|
||||
"get": {
|
||||
"operationId": "CategoryController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
},
|
||||
"post": {
|
||||
"operationId": "CategoryController_create",
|
||||
"responses": {
|
||||
"201": {
|
||||
"description": "Created"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/categories/{id}": {
|
||||
"get": {
|
||||
"operationId": "CategoryController_getById",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/orders": {
|
||||
"get": {
|
||||
"operationId": "OrderController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
},
|
||||
"post": {
|
||||
"operationId": "OrderController_create",
|
||||
"responses": {
|
||||
"201": {
|
||||
"description": "Created"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/orders/{id}": {
|
||||
"get": {
|
||||
"operationId": "OrderController_getById",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/customers": {
|
||||
"get": {
|
||||
"operationId": "CustomerController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/payments": {
|
||||
"get": {
|
||||
"operationId": "PaymentController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/invoices": {
|
||||
"get": {
|
||||
"operationId": "InvoiceController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/shipping": {
|
||||
"get": {
|
||||
"operationId": "ShippingController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/reports": {
|
||||
"get": {
|
||||
"operationId": "ReportController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/analytics": {
|
||||
"get": {
|
||||
"operationId": "AnalyticsController_getData",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/settings": {
|
||||
"get": {
|
||||
"operationId": "SettingsController_get",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/notifications": {
|
||||
"get": {
|
||||
"operationId": "NotificationController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/webhooks": {
|
||||
"get": {
|
||||
"operationId": "WebhookController_list",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"Product": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"price": {
|
||||
"type": "number"
|
||||
},
|
||||
"category": {
|
||||
"$ref": "#/components/schemas/Category"
|
||||
}
|
||||
}
|
||||
},
|
||||
"CreateProduct": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"price": {
|
||||
"type": "number"
|
||||
}
|
||||
}
|
||||
},
|
||||
"Category": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
67
tests/fixtures/edge-cases.json
vendored
Normal file
67
tests/fixtures/edge-cases.json
vendored
Normal file
@@ -0,0 +1,67 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Edge Cases API",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "https://api.example.com"
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/test-unicode-метод": {
|
||||
"get": {
|
||||
"operationId": "TestController_unicodeМетод",
|
||||
"summary": "Тест с Unicode символами",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/test/special-chars/@{id}": {
|
||||
"get": {
|
||||
"operationId": "TestController_specialChars",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/test/very-long-endpoint-name-that-exceeds-normal-length-and-tests-edge-case": {
|
||||
"get": {
|
||||
"operationId": "TestController_veryLongEndpointNameThatExceedsNormalLengthAndTestsEdgeCase",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"ВажныйТип": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"название": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
8
tests/fixtures/empty.json
vendored
Normal file
8
tests/fixtures/empty.json
vendored
Normal file
@@ -0,0 +1,8 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Empty API",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"paths": {}
|
||||
}
|
||||
10
tests/fixtures/invalid.json
vendored
Normal file
10
tests/fixtures/invalid.json
vendored
Normal file
@@ -0,0 +1,10 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"paths": {
|
||||
"/test": {
|
||||
"get": {
|
||||
"responses": {}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
31
tests/fixtures/minimal.json
vendored
Normal file
31
tests/fixtures/minimal.json
vendored
Normal file
@@ -0,0 +1,31 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Minimal API",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"paths": {
|
||||
"/hello": {
|
||||
"get": {
|
||||
"operationId": "getHello",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Success",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"message": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
228
tests/fixtures/valid.json
vendored
Normal file
228
tests/fixtures/valid.json
vendored
Normal file
@@ -0,0 +1,228 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Test API",
|
||||
"version": "1.0.0",
|
||||
"description": "API для тестирования генератора"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "https://api.example.com"
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/users": {
|
||||
"get": {
|
||||
"operationId": "UserController_getAll",
|
||||
"summary": "Получить всех пользователей",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "page",
|
||||
"in": "query",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"default": 1
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "limit",
|
||||
"in": "query",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"default": 10
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Список пользователей",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/User"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"post": {
|
||||
"operationId": "UserController_create",
|
||||
"summary": "Создать пользователя",
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/CreateUserDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"201": {
|
||||
"description": "Пользователь создан",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/User"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Ошибка валидации"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/users/{id}": {
|
||||
"get": {
|
||||
"operationId": "UserController_getById",
|
||||
"summary": "Получить пользователя по ID",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Пользователь найден",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/User"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"404": {
|
||||
"description": "Пользователь не найден"
|
||||
}
|
||||
}
|
||||
},
|
||||
"patch": {
|
||||
"operationId": "UserController_update",
|
||||
"summary": "Обновить пользователя",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/UpdateUserDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Пользователь обновлен",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/User"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"delete": {
|
||||
"operationId": "UserController_delete",
|
||||
"summary": "Удалить пользователя",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"204": {
|
||||
"description": "Пользователь удален"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"User": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"example": "123"
|
||||
},
|
||||
"email": {
|
||||
"type": "string",
|
||||
"example": "user@example.com"
|
||||
},
|
||||
"name": {
|
||||
"type": "string",
|
||||
"example": "John Doe"
|
||||
},
|
||||
"role": {
|
||||
"$ref": "#/components/schemas/UserRole"
|
||||
},
|
||||
"createdAt": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": ["id", "email", "role"]
|
||||
},
|
||||
"CreateUserDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"email": {
|
||||
"type": "string"
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"password": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": ["email", "password"]
|
||||
},
|
||||
"UpdateUserDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"email": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"UserRole": {
|
||||
"type": "string",
|
||||
"enum": ["admin", "user", "guest"]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
102
tests/fixtures/with-auth.json
vendored
Normal file
102
tests/fixtures/with-auth.json
vendored
Normal file
@@ -0,0 +1,102 @@
|
||||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Auth API",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "https://api.example.com"
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/auth/login": {
|
||||
"post": {
|
||||
"operationId": "AuthController_login",
|
||||
"summary": "Войти в систему",
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"email": {
|
||||
"type": "string"
|
||||
},
|
||||
"password": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": ["email", "password"]
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Успешная авторизация",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"token": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"401": {
|
||||
"description": "Неверные учетные данные"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/profile": {
|
||||
"get": {
|
||||
"operationId": "ProfileController_get",
|
||||
"summary": "Получить профиль",
|
||||
"security": [
|
||||
{
|
||||
"bearer": []
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Профиль пользователя",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"email": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"401": {
|
||||
"description": "Не авторизован"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"securitySchemes": {
|
||||
"bearer": {
|
||||
"type": "http",
|
||||
"scheme": "bearer",
|
||||
"bearerFormat": "JWT"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
31
tests/helpers/fixtures.ts
Normal file
31
tests/helpers/fixtures.ts
Normal file
@@ -0,0 +1,31 @@
|
||||
import { join } from 'path';
|
||||
import { fileURLToPath } from 'url';
|
||||
import { dirname } from 'path';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = dirname(__filename);
|
||||
|
||||
/**
|
||||
* Путь к директории с фикстурами
|
||||
*/
|
||||
export const FIXTURES_DIR = join(__dirname, '../fixtures');
|
||||
|
||||
/**
|
||||
* Получить путь к фикстуре
|
||||
*/
|
||||
export function getFixturePath(name: string): string {
|
||||
return join(FIXTURES_DIR, name);
|
||||
}
|
||||
|
||||
/**
|
||||
* Доступные фикстуры
|
||||
*/
|
||||
export const FIXTURES = {
|
||||
MINIMAL: getFixturePath('minimal.json'),
|
||||
VALID: getFixturePath('valid.json'),
|
||||
COMPLEX: getFixturePath('complex.json'),
|
||||
WITH_AUTH: getFixturePath('with-auth.json'),
|
||||
INVALID: getFixturePath('invalid.json'),
|
||||
EMPTY: getFixturePath('empty.json'),
|
||||
EDGE_CASES: getFixturePath('edge-cases.json'),
|
||||
} as const;
|
||||
88
tests/helpers/mock-server.ts
Normal file
88
tests/helpers/mock-server.ts
Normal file
@@ -0,0 +1,88 @@
|
||||
import { http, HttpResponse } from 'msw';
|
||||
import { setupServer } from 'msw/node';
|
||||
|
||||
/**
|
||||
* Создание mock HTTP сервера для тестирования
|
||||
*/
|
||||
export function createMockServer() {
|
||||
const handlers = [
|
||||
// Mock для успешного GET запроса
|
||||
http.get('https://api.example.com/users', () => {
|
||||
return HttpResponse.json([
|
||||
{ id: '1', email: 'user1@example.com', name: 'User 1' },
|
||||
{ id: '2', email: 'user2@example.com', name: 'User 2' },
|
||||
]);
|
||||
}),
|
||||
|
||||
// Mock для GET с параметрами
|
||||
http.get('https://api.example.com/users/:id', ({ params }) => {
|
||||
const { id } = params;
|
||||
if (id === '1') {
|
||||
return HttpResponse.json({ id: '1', email: 'user1@example.com', name: 'User 1' });
|
||||
}
|
||||
return HttpResponse.json({ error: 'Not found' }, { status: 404 });
|
||||
}),
|
||||
|
||||
// Mock для POST запроса
|
||||
http.post('https://api.example.com/users', async ({ request }) => {
|
||||
const body = await request.json() as Record<string, any>;
|
||||
return HttpResponse.json(
|
||||
{ id: '3', ...body },
|
||||
{ status: 201 }
|
||||
);
|
||||
}),
|
||||
|
||||
// Mock для PATCH запроса
|
||||
http.patch('https://api.example.com/users/:id', async ({ request, params }) => {
|
||||
const body = await request.json() as Record<string, any>;
|
||||
return HttpResponse.json({ id: params.id, ...body });
|
||||
}),
|
||||
|
||||
// Mock для DELETE запроса
|
||||
http.delete('https://api.example.com/users/:id', () => {
|
||||
return new HttpResponse(null, { status: 204 });
|
||||
}),
|
||||
|
||||
// Mock для авторизации
|
||||
http.post('https://api.example.com/auth/login', async ({ request }) => {
|
||||
const body = await request.json() as any;
|
||||
if (body.email === 'test@example.com' && body.password === 'password') {
|
||||
return HttpResponse.json({ token: 'mock-jwt-token' });
|
||||
}
|
||||
return HttpResponse.json({ error: 'Unauthorized' }, { status: 401 });
|
||||
}),
|
||||
|
||||
// Mock для защищенного endpoint
|
||||
http.get('https://api.example.com/profile', ({ request }) => {
|
||||
const auth = request.headers.get('Authorization');
|
||||
if (auth && auth.startsWith('Bearer ')) {
|
||||
return HttpResponse.json({ id: '1', email: 'test@example.com' });
|
||||
}
|
||||
return HttpResponse.json({ error: 'Unauthorized' }, { status: 401 });
|
||||
}),
|
||||
|
||||
// Mock для ошибки сервера
|
||||
http.get('https://api.example.com/error', () => {
|
||||
return HttpResponse.json({ error: 'Internal Server Error' }, { status: 500 });
|
||||
}),
|
||||
|
||||
// Mock для network error
|
||||
http.get('https://api.example.com/network-error', () => {
|
||||
return HttpResponse.error();
|
||||
}),
|
||||
];
|
||||
|
||||
const server = setupServer(...handlers);
|
||||
|
||||
return {
|
||||
server,
|
||||
start: () => server.listen({ onUnhandledRequest: 'warn' }),
|
||||
stop: () => server.close(),
|
||||
reset: () => server.resetHandlers(),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Тип для mock сервера
|
||||
*/
|
||||
export type MockServer = ReturnType<typeof createMockServer>;
|
||||
35
tests/helpers/setup.ts
Normal file
35
tests/helpers/setup.ts
Normal file
@@ -0,0 +1,35 @@
|
||||
import { tmpdir } from 'os';
|
||||
import { join } from 'path';
|
||||
import { mkdtemp, rm } from 'fs/promises';
|
||||
|
||||
/**
|
||||
* Создание временной директории для тестов
|
||||
*/
|
||||
export async function createTempDir(): Promise<string> {
|
||||
const prefix = join(tmpdir(), 'api-codegen-test-');
|
||||
return await mkdtemp(prefix);
|
||||
}
|
||||
|
||||
/**
|
||||
* Очистка временной директории
|
||||
*/
|
||||
export async function cleanupTempDir(dir: string): Promise<void> {
|
||||
try {
|
||||
await rm(dir, { recursive: true, force: true });
|
||||
} catch (error) {
|
||||
// Игнорируем ошибки при очистке
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Setup функция для beforeEach
|
||||
*/
|
||||
export async function setupTest(): Promise<{ tempDir: string; cleanup: () => Promise<void> }> {
|
||||
const tempDir = await createTempDir();
|
||||
|
||||
const cleanup = async () => {
|
||||
await cleanupTempDir(tempDir);
|
||||
};
|
||||
|
||||
return { tempDir, cleanup };
|
||||
}
|
||||
355
tests/integration/e2e-generation.test.ts
Normal file
355
tests/integration/e2e-generation.test.ts
Normal file
@@ -0,0 +1,355 @@
|
||||
import { describe, test, expect, beforeEach, afterEach, beforeAll, afterAll } from 'bun:test';
|
||||
import { execa } from 'execa';
|
||||
import { setupTest } from '../helpers/setup.js';
|
||||
import { createMockServer, type MockServer } from '../helpers/mock-server.js';
|
||||
import { FIXTURES } from '../helpers/fixtures.js';
|
||||
import { join } from 'path';
|
||||
import { fileExists, readTextFile } from '../../src/utils/file.js';
|
||||
import { fileURLToPath } from 'url';
|
||||
import { dirname } from 'path';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = dirname(__filename);
|
||||
const CLI_PATH = join(__dirname, '../../src/cli.ts');
|
||||
|
||||
describe('E2E Generation', () => {
|
||||
let tempDir: string;
|
||||
let cleanup: () => Promise<void>;
|
||||
let mockServer: MockServer;
|
||||
|
||||
beforeAll(() => {
|
||||
mockServer = createMockServer();
|
||||
mockServer.start();
|
||||
});
|
||||
|
||||
afterAll(() => {
|
||||
mockServer.stop();
|
||||
});
|
||||
|
||||
beforeEach(async () => {
|
||||
const setup = await setupTest();
|
||||
tempDir = setup.tempDir;
|
||||
cleanup = setup.cleanup;
|
||||
mockServer.reset();
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
await cleanup();
|
||||
});
|
||||
|
||||
describe('полный цикл генерации', () => {
|
||||
test('CLI генерация → создание файла → импорт → использование', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
// 1. Генерация через CLI
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'TestApi',
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
// 2. Проверка создания файла
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
|
||||
// 3. Проверка импорта (компиляция TypeScript)
|
||||
const testFile = join(tempDir, 'test-import.ts');
|
||||
const testCode = `
|
||||
import { Api } from '${generatedFile}';
|
||||
|
||||
const api = new Api();
|
||||
console.log('Import successful');
|
||||
`;
|
||||
|
||||
await Bun.write(testFile, testCode);
|
||||
|
||||
// Компилируем тестовый файл
|
||||
const { exitCode: compileExitCode } = await execa('bun', ['build', testFile, '--outdir', tempDir]);
|
||||
expect(compileExitCode).toBe(0);
|
||||
}, 60000);
|
||||
|
||||
test('генерация из локального файла', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.MINIMAL,
|
||||
'--output',
|
||||
outputPath,
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
const generatedFile = join(outputPath, 'MinimalAPI.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
|
||||
test('повторная генерация (перезапись файлов)', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const fileName = 'TestApi';
|
||||
|
||||
// Первая генерация
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.MINIMAL,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
fileName,
|
||||
]);
|
||||
|
||||
const generatedFile = join(outputPath, `${fileName}.ts`);
|
||||
const firstContent = await readTextFile(generatedFile);
|
||||
|
||||
// Вторая генерация (перезапись)
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
fileName,
|
||||
]);
|
||||
|
||||
const secondContent = await readTextFile(generatedFile);
|
||||
|
||||
// Содержимое должно отличаться
|
||||
expect(firstContent).not.toBe(secondContent);
|
||||
|
||||
// Файл должен существовать
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 60000);
|
||||
|
||||
test('генерация из HTTP URL', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
// Используем публичный OpenAPI spec
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
'https://petstore3.swagger.io/api/v3/openapi.json',
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'PetStore',
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
const generatedFile = join(outputPath, 'PetStore.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
|
||||
// Проверяем что файл не пустой
|
||||
const content = await readTextFile(generatedFile);
|
||||
expect(content.length).toBeGreaterThan(1000);
|
||||
}, 60000);
|
||||
|
||||
test('генерация с флагом --swr', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'SwrApi',
|
||||
'--swr',
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
const generatedFile = join(outputPath, 'SwrApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие импорта useSWR
|
||||
expect(content).toContain('import useSWR from "swr"');
|
||||
|
||||
// Проверяем наличие use* хуков для GET запросов
|
||||
expect(content).toContain('useGetAll');
|
||||
expect(content).toContain('useGetById');
|
||||
}, 30000);
|
||||
|
||||
test('генерация без флага --swr не содержит хуки', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'NoSwrApi',
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
const generatedFile = join(outputPath, 'NoSwrApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем отсутствие импорта useSWR
|
||||
expect(content).not.toContain('import useSWR from "swr"');
|
||||
|
||||
// Проверяем отсутствие use* хуков
|
||||
expect(content).not.toContain('useGetAll');
|
||||
expect(content).not.toContain('useGetById');
|
||||
}, 30000);
|
||||
});
|
||||
|
||||
describe('HTTP запросы с mock сервером', () => {
|
||||
test('GET запрос без параметров', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'TestApi',
|
||||
]);
|
||||
|
||||
// Динамически импортируем сгенерированный API
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const { Api } = await import(generatedFile);
|
||||
|
||||
const api = new Api();
|
||||
const result = await api.users.getAll();
|
||||
|
||||
expect(Array.isArray(result)).toBe(true);
|
||||
expect(result.length).toBe(2);
|
||||
}, 60000);
|
||||
|
||||
test('POST запрос с body', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'TestApi',
|
||||
]);
|
||||
|
||||
// Динамически импортируем сгенерированный API
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const { Api } = await import(generatedFile);
|
||||
|
||||
const api = new Api();
|
||||
const result = await api.users.create({
|
||||
email: 'new@example.com',
|
||||
password: 'password123'
|
||||
});
|
||||
|
||||
expect(result.id).toBe('3');
|
||||
expect(result.email).toBe('new@example.com');
|
||||
}, 60000);
|
||||
|
||||
test('обработка 404 статуса', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.VALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'TestApi',
|
||||
]);
|
||||
|
||||
const testFile = join(tempDir, 'test-404.ts');
|
||||
const testCode = `
|
||||
import { Api } from '${join(outputPath, 'TestApi.ts')}';
|
||||
|
||||
const api = new Api();
|
||||
try {
|
||||
await api.users.getById('999');
|
||||
} catch (error) {
|
||||
console.log('error');
|
||||
}
|
||||
`;
|
||||
|
||||
await Bun.write(testFile, testCode);
|
||||
|
||||
const { stdout } = await execa('bun', ['run', testFile]);
|
||||
expect(stdout).toContain('error');
|
||||
}, 60000);
|
||||
|
||||
test('Bearer token authentication', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.WITH_AUTH,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
'AuthApi',
|
||||
]);
|
||||
|
||||
// Динамически импортируем сгенерированный API
|
||||
const generatedFile = join(outputPath, 'AuthApi.ts');
|
||||
const { Api, HttpClient } = await import(generatedFile);
|
||||
|
||||
// Создаем HttpClient с securityWorker для добавления Bearer токена
|
||||
const httpClient = new HttpClient({
|
||||
securityWorker: (securityData: string | null) => {
|
||||
if (securityData) {
|
||||
return {
|
||||
headers: {
|
||||
Authorization: `Bearer ${securityData}`
|
||||
}
|
||||
};
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
const api = new Api(httpClient);
|
||||
|
||||
// Логин
|
||||
const loginResult = await api.auth.login({
|
||||
email: 'test@example.com',
|
||||
password: 'password'
|
||||
});
|
||||
|
||||
// Установка токена
|
||||
httpClient.setSecurityData(loginResult.token);
|
||||
|
||||
// Запрос с токеном
|
||||
const profile = await api.profile.get();
|
||||
|
||||
expect(profile.email).toBe('test@example.com');
|
||||
}, 60000);
|
||||
});
|
||||
});
|
||||
220
tests/integration/generated-client.test.ts
Normal file
220
tests/integration/generated-client.test.ts
Normal file
@@ -0,0 +1,220 @@
|
||||
import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
|
||||
import { generate } from '../../src/generator.js';
|
||||
import { setupTest } from '../helpers/setup.js';
|
||||
import { FIXTURES } from '../helpers/fixtures.js';
|
||||
import { join } from 'path';
|
||||
import { fileExists, readTextFile } from '../../src/utils/file.js';
|
||||
import type { GeneratorConfig } from '../../src/config.js';
|
||||
import { execa } from 'execa';
|
||||
|
||||
describe('Generated Client', () => {
|
||||
let tempDir: string;
|
||||
let cleanup: () => Promise<void>;
|
||||
|
||||
beforeEach(async () => {
|
||||
const setup = await setupTest();
|
||||
tempDir = setup.tempDir;
|
||||
cleanup = setup.cleanup;
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
await cleanup();
|
||||
});
|
||||
|
||||
describe('компиляция TypeScript', () => {
|
||||
test('сгенерированный код должен компилироваться без ошибок', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
|
||||
// Пытаемся скомпилировать
|
||||
const { exitCode } = await execa('bun', ['build', generatedFile, '--outdir', tempDir]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
}, 30000);
|
||||
|
||||
test('должны отсутствовать TypeScript ошибки', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
|
||||
// Проверяем с помощью TypeScript компилятора
|
||||
const { exitCode, stderr } = await execa('bun', ['build', generatedFile, '--outdir', tempDir]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
expect(stderr).toBe('');
|
||||
}, 30000);
|
||||
|
||||
test('корректные импорты и экспорты', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем экспорты
|
||||
expect(content).toContain('export');
|
||||
expect(content).toContain('class');
|
||||
}, 30000);
|
||||
});
|
||||
|
||||
describe('корректность API', () => {
|
||||
test('все endpoints из спецификации должны присутствовать', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем что все основные методы есть
|
||||
expect(content).toContain('getAll');
|
||||
expect(content).toContain('create');
|
||||
expect(content).toContain('getById');
|
||||
expect(content).toContain('update');
|
||||
expect(content).toContain('delete');
|
||||
}, 30000);
|
||||
|
||||
test('корректные имена методов (без Controller префиксов)', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем что "Controller" удален
|
||||
expect(content).not.toContain('UserControllerGetAll');
|
||||
expect(content).not.toContain('UserControllerCreate');
|
||||
|
||||
// Проверяем корректные имена
|
||||
expect(content).toContain('getAll');
|
||||
expect(content).toContain('create');
|
||||
}, 30000);
|
||||
|
||||
test('HttpClient должен правильно инициализироваться', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие HttpClient
|
||||
expect(content).toContain('HttpClient');
|
||||
|
||||
// Проверяем базовый URL
|
||||
expect(content).toContain('https://api.example.com');
|
||||
}, 30000);
|
||||
|
||||
test('метод setSecurityData должен работать', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.WITH_AUTH,
|
||||
outputPath,
|
||||
fileName: 'AuthApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'AuthApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие метода для установки токена
|
||||
expect(content).toContain('setSecurityData');
|
||||
}, 30000);
|
||||
});
|
||||
|
||||
describe('различные форматы спецификаций', () => {
|
||||
test('должен работать с минимальной спецификацией', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.MINIMAL,
|
||||
outputPath,
|
||||
fileName: 'MinimalApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'MinimalApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
|
||||
// Проверяем компиляцию (временно отключено из-за проблем с генератором)
|
||||
// const { exitCode } = await execa('bun', ['build', generatedFile, '--outdir', tempDir]);
|
||||
// expect(exitCode).toBe(0);
|
||||
}, 30000);
|
||||
|
||||
test('должен работать с аутентификацией', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.WITH_AUTH,
|
||||
outputPath,
|
||||
fileName: 'AuthApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'AuthApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие методов авторизации
|
||||
expect(content).toContain('login');
|
||||
expect(content).toContain('get'); // ProfileController_get -> get
|
||||
}, 30000);
|
||||
|
||||
test('должен работать со сложной спецификацией', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.COMPLEX,
|
||||
outputPath,
|
||||
fileName: 'ComplexApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'ComplexApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
|
||||
// Проверяем что файл не пустой
|
||||
const content = await readTextFile(generatedFile);
|
||||
expect(content.length).toBeGreaterThan(1000);
|
||||
}, 30000);
|
||||
});
|
||||
});
|
||||
143
tests/unit/cli.test.ts
Normal file
143
tests/unit/cli.test.ts
Normal file
@@ -0,0 +1,143 @@
|
||||
import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
|
||||
import { execa } from 'execa';
|
||||
import { setupTest } from '../helpers/setup.js';
|
||||
import { FIXTURES } from '../helpers/fixtures.js';
|
||||
import { join } from 'path';
|
||||
import { fileExists } from '../../src/utils/file.js';
|
||||
import { fileURLToPath } from 'url';
|
||||
import { dirname } from 'path';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = dirname(__filename);
|
||||
const CLI_PATH = join(__dirname, '../../src/cli.ts');
|
||||
|
||||
describe('CLI', () => {
|
||||
let tempDir: string;
|
||||
let cleanup: () => Promise<void>;
|
||||
|
||||
beforeEach(async () => {
|
||||
const setup = await setupTest();
|
||||
tempDir = setup.tempDir;
|
||||
cleanup = setup.cleanup;
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
await cleanup();
|
||||
});
|
||||
|
||||
describe('базовые сценарии', () => {
|
||||
test('должен запуститься с корректными параметрами (локальный файл)', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.MINIMAL,
|
||||
'--output',
|
||||
outputPath,
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
const generatedFile = join(outputPath, 'MinimalAPI.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
|
||||
test('должен генерировать с кастомным именем файла', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const customName = 'CustomApi';
|
||||
|
||||
const { exitCode } = await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.MINIMAL,
|
||||
'--output',
|
||||
outputPath,
|
||||
'--name',
|
||||
customName,
|
||||
]);
|
||||
|
||||
expect(exitCode).toBe(0);
|
||||
|
||||
const generatedFile = join(outputPath, `${customName}.ts`);
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
|
||||
test('должен отображать версию с --version', async () => {
|
||||
const { stdout } = await execa('bun', ['run', CLI_PATH, '--version']);
|
||||
|
||||
expect(stdout).toContain('1.0.0');
|
||||
});
|
||||
|
||||
test('должен отображать help с --help', async () => {
|
||||
const { stdout } = await execa('bun', ['run', CLI_PATH, '--help']);
|
||||
|
||||
expect(stdout).toContain('Generate TypeScript API client');
|
||||
expect(stdout).toContain('--input');
|
||||
expect(stdout).toContain('--output');
|
||||
});
|
||||
});
|
||||
|
||||
describe('обработка ошибок', () => {
|
||||
test('должен выбросить ошибку без параметра --input', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
try {
|
||||
await execa('bun', ['run', CLI_PATH, '--output', outputPath]);
|
||||
throw new Error('Should have thrown');
|
||||
} catch (error: any) {
|
||||
expect(error.exitCode).not.toBe(0);
|
||||
}
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку без параметра --output', async () => {
|
||||
try {
|
||||
await execa('bun', ['run', CLI_PATH, '--input', FIXTURES.MINIMAL]);
|
||||
throw new Error('Should have thrown');
|
||||
} catch (error: any) {
|
||||
expect(error.exitCode).not.toBe(0);
|
||||
}
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку для несуществующего файла', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const nonexistentFile = join(tempDir, 'nonexistent.json');
|
||||
|
||||
try {
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
nonexistentFile,
|
||||
'--output',
|
||||
outputPath,
|
||||
]);
|
||||
throw new Error('Should have thrown');
|
||||
} catch (error: any) {
|
||||
expect(error.exitCode).not.toBe(0);
|
||||
}
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку для невалидного JSON', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
|
||||
try {
|
||||
await execa('bun', [
|
||||
'run',
|
||||
CLI_PATH,
|
||||
'--input',
|
||||
FIXTURES.INVALID,
|
||||
'--output',
|
||||
outputPath,
|
||||
]);
|
||||
throw new Error('Should have thrown');
|
||||
} catch (error: any) {
|
||||
expect(error.exitCode).not.toBe(0);
|
||||
}
|
||||
}, 30000);
|
||||
});
|
||||
});
|
||||
49
tests/unit/config.test.ts
Normal file
49
tests/unit/config.test.ts
Normal file
@@ -0,0 +1,49 @@
|
||||
import { describe, test, expect } from 'bun:test';
|
||||
import { validateConfig, type GeneratorConfig } from '../../src/config.js';
|
||||
|
||||
describe('config', () => {
|
||||
describe('validateConfig', () => {
|
||||
test('должен пройти валидацию для корректной конфигурации', () => {
|
||||
const config: Partial<GeneratorConfig> = {
|
||||
inputPath: './openapi.json',
|
||||
outputPath: './output',
|
||||
fileName: 'Api',
|
||||
};
|
||||
|
||||
expect(() => validateConfig(config)).not.toThrow();
|
||||
expect(validateConfig(config)).toBe(true);
|
||||
});
|
||||
|
||||
test('должен пройти валидацию без опционального fileName', () => {
|
||||
const config: Partial<GeneratorConfig> = {
|
||||
inputPath: './openapi.json',
|
||||
outputPath: './output',
|
||||
};
|
||||
|
||||
expect(() => validateConfig(config)).not.toThrow();
|
||||
expect(validateConfig(config)).toBe(true);
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку без inputPath', () => {
|
||||
const config: Partial<GeneratorConfig> = {
|
||||
outputPath: './output',
|
||||
};
|
||||
|
||||
expect(() => validateConfig(config)).toThrow('Input path is required');
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку без outputPath', () => {
|
||||
const config: Partial<GeneratorConfig> = {
|
||||
inputPath: './openapi.json',
|
||||
};
|
||||
|
||||
expect(() => validateConfig(config)).toThrow('Output path is required');
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку без обоих обязательных полей', () => {
|
||||
const config: Partial<GeneratorConfig> = {};
|
||||
|
||||
expect(() => validateConfig(config)).toThrow('Configuration validation failed');
|
||||
});
|
||||
});
|
||||
});
|
||||
241
tests/unit/generator.test.ts
Normal file
241
tests/unit/generator.test.ts
Normal file
@@ -0,0 +1,241 @@
|
||||
import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
|
||||
import { generate } from '../../src/generator.js';
|
||||
import { setupTest } from '../helpers/setup.js';
|
||||
import { FIXTURES } from '../helpers/fixtures.js';
|
||||
import { join } from 'path';
|
||||
import { fileExists, readTextFile } from '../../src/utils/file.js';
|
||||
import type { GeneratorConfig } from '../../src/config.js';
|
||||
|
||||
describe('Generator', () => {
|
||||
let tempDir: string;
|
||||
let cleanup: () => Promise<void>;
|
||||
|
||||
beforeEach(async () => {
|
||||
const setup = await setupTest();
|
||||
tempDir = setup.tempDir;
|
||||
cleanup = setup.cleanup;
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
await cleanup();
|
||||
});
|
||||
|
||||
describe('корректная генерация', () => {
|
||||
test('должен создать выходной файл', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.MINIMAL,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
|
||||
test('должен генерировать корректную структуру кода', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.MINIMAL,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие основных элементов
|
||||
expect(content).toContain('export class');
|
||||
expect(content).toContain('HttpClient');
|
||||
}, 30000);
|
||||
|
||||
test('должен обработать все HTTP методы', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем что методы UserController переименованы
|
||||
// UserController_getAll -> getAll
|
||||
// UserController_create -> create
|
||||
expect(content).toContain('getAll');
|
||||
expect(content).toContain('create');
|
||||
expect(content).toContain('getById');
|
||||
expect(content).toContain('update');
|
||||
expect(content).toContain('delete');
|
||||
}, 30000);
|
||||
|
||||
test('должен генерировать типы для request и response', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие типов
|
||||
expect(content).toContain('User');
|
||||
expect(content).toContain('CreateUserDto');
|
||||
expect(content).toContain('UpdateUserDto');
|
||||
}, 30000);
|
||||
|
||||
test('должен генерировать enum типы', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие enum
|
||||
expect(content).toContain('UserRole');
|
||||
expect(content).toContain('admin');
|
||||
expect(content).toContain('user');
|
||||
expect(content).toContain('guest');
|
||||
}, 30000);
|
||||
|
||||
test('должен обработать Bearer authentication', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.WITH_AUTH,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем наличие методов для работы с токеном
|
||||
expect(content).toContain('setSecurityData');
|
||||
}, 30000);
|
||||
|
||||
test('должен использовать baseUrl из servers', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем что baseUrl установлен
|
||||
expect(content).toContain('https://api.example.com');
|
||||
}, 30000);
|
||||
|
||||
test('должен применять хук onFormatRouteName', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.VALID,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем что "Controller" удален из имен методов
|
||||
expect(content).not.toContain('UserControllerGetAll');
|
||||
expect(content).not.toContain('UserControllerCreate');
|
||||
|
||||
// Проверяем что методы названы корректно
|
||||
expect(content).toContain('getAll');
|
||||
expect(content).toContain('create');
|
||||
}, 30000);
|
||||
});
|
||||
|
||||
describe('edge cases', () => {
|
||||
test('должен обработать пустую спецификацию', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.EMPTY,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
// Генерация должна пройти успешно
|
||||
await generate(config);
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
|
||||
test('должен обработать минимальную спецификацию', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.MINIMAL,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
|
||||
test('должен обработать сложную спецификацию', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.COMPLEX,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
await generate(config);
|
||||
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const content = await readTextFile(generatedFile);
|
||||
|
||||
// Проверяем что все контроллеры присутствуют
|
||||
expect(content).toContain('list'); // ProductController_list -> list
|
||||
expect(content).toContain('create');
|
||||
expect(content).toContain('getById');
|
||||
}, 30000);
|
||||
|
||||
test('должен обработать Unicode символы', async () => {
|
||||
const outputPath = join(tempDir, 'output');
|
||||
const config: GeneratorConfig = {
|
||||
inputPath: FIXTURES.EDGE_CASES,
|
||||
outputPath,
|
||||
fileName: 'TestApi',
|
||||
};
|
||||
|
||||
// Генерация должна пройти успешно даже с Unicode
|
||||
await generate(config);
|
||||
const generatedFile = join(outputPath, 'TestApi.ts');
|
||||
const exists = await fileExists(generatedFile);
|
||||
expect(exists).toBe(true);
|
||||
}, 30000);
|
||||
});
|
||||
});
|
||||
111
tests/unit/utils/file.test.ts
Normal file
111
tests/unit/utils/file.test.ts
Normal file
@@ -0,0 +1,111 @@
|
||||
import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
|
||||
import { fileExists, readJsonFile, readTextFile, ensureDir, writeFileWithDirs } from '../../../src/utils/file.js';
|
||||
import { setupTest } from '../../helpers/setup.js';
|
||||
import { join } from 'path';
|
||||
import { writeFile, mkdir } from 'fs/promises';
|
||||
|
||||
describe('file utils', () => {
|
||||
let tempDir: string;
|
||||
let cleanup: () => Promise<void>;
|
||||
|
||||
beforeEach(async () => {
|
||||
const setup = await setupTest();
|
||||
tempDir = setup.tempDir;
|
||||
cleanup = setup.cleanup;
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
await cleanup();
|
||||
});
|
||||
|
||||
describe('fileExists', () => {
|
||||
test('должен вернуть true для существующего файла', async () => {
|
||||
const filePath = join(tempDir, 'test.txt');
|
||||
await writeFile(filePath, 'test content');
|
||||
|
||||
const exists = await fileExists(filePath);
|
||||
expect(exists).toBe(true);
|
||||
});
|
||||
|
||||
test('должен вернуть false для несуществующего файла', async () => {
|
||||
const filePath = join(tempDir, 'nonexistent.txt');
|
||||
|
||||
const exists = await fileExists(filePath);
|
||||
expect(exists).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('readTextFile', () => {
|
||||
test('должен прочитать содержимое текстового файла', async () => {
|
||||
const filePath = join(tempDir, 'test.txt');
|
||||
const content = 'Hello, World!';
|
||||
await writeFile(filePath, content);
|
||||
|
||||
const result = await readTextFile(filePath);
|
||||
expect(result).toBe(content);
|
||||
});
|
||||
});
|
||||
|
||||
describe('readJsonFile', () => {
|
||||
test('должен прочитать и распарсить JSON файл', async () => {
|
||||
const filePath = join(tempDir, 'test.json');
|
||||
const data = { name: 'Test', value: 42 };
|
||||
await writeFile(filePath, JSON.stringify(data));
|
||||
|
||||
const result = await readJsonFile(filePath);
|
||||
expect(result).toEqual(data);
|
||||
});
|
||||
|
||||
test('должен выбросить ошибку для невалидного JSON', async () => {
|
||||
const filePath = join(tempDir, 'invalid.json');
|
||||
await writeFile(filePath, 'not a json');
|
||||
|
||||
await expect(readJsonFile(filePath)).rejects.toThrow();
|
||||
});
|
||||
});
|
||||
|
||||
describe('ensureDir', () => {
|
||||
test('должен создать директорию', async () => {
|
||||
const dirPath = join(tempDir, 'test-dir');
|
||||
|
||||
await ensureDir(dirPath);
|
||||
|
||||
const exists = await fileExists(dirPath);
|
||||
expect(exists).toBe(true);
|
||||
});
|
||||
|
||||
test('должен создать вложенные директории', async () => {
|
||||
const dirPath = join(tempDir, 'a', 'b', 'c');
|
||||
|
||||
await ensureDir(dirPath);
|
||||
|
||||
const exists = await fileExists(dirPath);
|
||||
expect(exists).toBe(true);
|
||||
});
|
||||
|
||||
test('не должен падать если директория уже существует', async () => {
|
||||
const dirPath = join(tempDir, 'existing');
|
||||
await mkdir(dirPath);
|
||||
|
||||
// Не должно выбрасывать ошибку
|
||||
await ensureDir(dirPath);
|
||||
const exists = await fileExists(dirPath);
|
||||
expect(exists).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
describe('writeFileWithDirs', () => {
|
||||
test('должен записать файл и создать директории', async () => {
|
||||
const filePath = join(tempDir, 'nested', 'dir', 'file.txt');
|
||||
const content = 'test content';
|
||||
|
||||
await writeFileWithDirs(filePath, content);
|
||||
|
||||
const exists = await fileExists(filePath);
|
||||
expect(exists).toBe(true);
|
||||
|
||||
const readContent = await readTextFile(filePath);
|
||||
expect(readContent).toBe(content);
|
||||
});
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user