@gromlab/api-codegen 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Gromlab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# API CodeGen
+
+CLI утилита для генерации TypeScript API клиента из OpenAPI спецификации.
+
+## Установка
+
+```bash
+bun install
+```
+
+## Использование
+
+```bash
+api-codegen -u <URL> -i <INPUT> -o <OUTPUT> [-n <NAME>]
+```
+
+**Аргументы:**
+- `-u, --url <url>` - Базовый URL API
+- `-i, --input <path>` - Путь к OpenAPI файлу (локальный или URL)
+- `-o, --output <path>` - Директория для сохранения файлов
+- `-n, --name <name>` - Имя сгенерированного файла (опционально)
+
+**Примеры:**
+
+```bash
+# Локальный файл
+api-codegen -u https://api.example.com -i ./openapi.json -o ./src/api
+
+# URL на спецификацию
+api-codegen -u https://api.example.com -i https://petstore.swagger.io/v2/swagger.json -o ./src/api
+
+# С кастомным именем файла
+api-codegen -u https://api.example.com -i ./openapi.json -o ./src/api -n MyApiClient
+```
+
+## Пример использования
+
+```typescript
+import { Api, HttpClient } from './src/api/Api';
+
+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 });
+
+// React + SWR
+function Profile() {
+  const { data } = useSWR('/auth/me', () => api.auth.getProfile());
+  return <div>{data?.email}</div>;
+}
+```
+
+## Разработка
+
+### Сборка
+```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