# @gromlab/api-codegen
CLI утилита для генерации TypeScript API клиента из OpenAPI спецификации.
## Использование
```bash
npx @gromlab/api-codegen -i -o [-n ] [--swr]
```
**Аргументы:**
- `-i, --input ` - Путь к OpenAPI файлу (локальный файл или URL)
- `-o, --output ` - Директория для сохранения файлов
- `-n, --name ` - Имя сгенерированного файла (опционально, по умолчанию из `spec.info.title`)
- `--swr` - Генерировать SWR хуки для React
**Примеры:**
```bash
# Локальный файл
npx @gromlab/api-codegen -i ./openapi.json -o ./src/api
# URL на спецификацию
npx @gromlab/api-codegen -i https://httpbin.org/spec.json -o ./src/api
# С кастомным именем файла
npx @gromlab/api-codegen -i ./openapi.json -o ./src/api -n MyApi
# С генерацией SWR хуков
npx @gromlab/api-codegen -i ./openapi.json -o ./src/api --swr
```
## Пример использования сгенерированного кода
```typescript
import { Api, HttpClient } from './src/api/MyApi';
const httpClient = new HttpClient();
httpClient.setSecurityData({ token: 'jwt-token' });
const api = new Api(httpClient);
// GET запрос
const user = await api.auth.getProfile();
// POST запрос
const result = await api.auth.login({ email, password });
```
## Разработка
### Сборка
```bash
bun run build
```
### Тестирование
```bash
# Все тесты
bun test
# Юнит тесты
bun run test:unit
# Интеграционные тесты
bun run test:integration
# Watch режим
bun run test:watch
# С coverage
bun run test:coverage
```
Подробная документация по тестированию в [`tests/README.md`](tests/README.md).
## Лицензия
MIT