@devlearning/swagger-generator 1.1.21 → 1.1.23

package/README.md

@@ -1,277 +1,277 @@
-# Swagger API Generator
-
-Generatore automatico di client API e modelli per **Angular**, **Next.js** e **Flutter/Dart** da specifiche Swagger/OpenAPI.
-
-[![npm version](https://img.shields.io/npm/v/@devlearning/swagger-generator.svg)](https://www.npmjs.com/package/@devlearning/swagger-generator)
-[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
-
-## 🎯 Caratteristiche
-
-- ✅ **Generazione automatica** di modelli e API da Swagger JSON
-- 🎨 **Multi-framework**: Angular, Next.js, Flutter/Dart
-- 🔒 **Type-safe**: Tipizzazione forte per TypeScript e Dart
-- 📦 **Zero dipendenze** nei file generati (configurabile)
-- 🚀 **CLI semplice** da usare
-- 🔄 **Validazione** del documento Swagger prima della generazione
-- 📝 **Logging strutturato** per debugging
-
-## 📦 Installazione
-
-```bash
-npm install @devlearning/swagger-generator --save-dev
-```
-
-## 🚀 Utilizzo
-
-### Da linea di comando
-
-```bash
-npx swgen --url <swagger-url> --output <output-dir> --target <angular|next|flutter> [opzioni]
-```
-
-### Esempi
-
-#### Angular
-```bash
-npx swgen \
-  --url http://localhost:5000/swagger/v1/swagger.json \
-  --output src/app/core/autogen \
-  --target angular \
-  --dateTimeLibrary moment
-```
-
-#### Next.js
-```bash
-npx swgen \
-  --url https://api.example.com/swagger.json \
-  --output src/lib/api \
-  --target next \
-  --dateTimeLibrary date-fns
-```
-
-#### Flutter/Dart
-```bash
-npx swgen \
-  --url http://localhost:5000/swagger/v1/swagger.json \
-  --output lib/core/api \
-  --target flutter \
-  --package my_app_name
-```
-
-### Opzioni
-
-| Opzione | Alias | Descrizione | Obbligatorio | Default |
-|---------|-------|-------------|--------------|---------|
-| `--url` | `-u` | URL del file swagger.json | ✅ | - |
-| `--output` | `-o` | Directory di output | ✅ | - |
-| `--target` | `-t` | Framework target (`angular`, `next`, `flutter`) | ✅ | - |
-| `--dateTimeLibrary` | `-d` | Libreria date (`moment`, `date-fns`) | ❌ | `date-fns` |
-| `--package` | `-p` | Nome package (solo Dart/Flutter) | ❌ | - |
-| `--api-client-name` | `-a` | Nome classe API unificata | ❌ | - |
-
-### 🆕 API Client Unificata
-
-Di default, il generatore crea classi API separate raggruppate per tag Swagger. Con l'opzione `--api-client-name`, puoi generare una **singola classe unificata** contenente tutti i metodi API.
-
-#### Esempio: Flutter con classe unificata
-
-```bash
-npx swgen \
-  --url http://localhost:5000/swagger/v1/swagger.json \
-  --output lib/core/api \
-  --target flutter \
-  --package my_app \
-  --api-client-name ApiClient
-```
-
-Genera:
-```dart
-// lib/core/api/api_client.dart
-class ApiClient {
-  // Tutti i metodi API in una singola classe
-  Future<User> getUser(String id) async { ... }
-  Future<List<Product>> getProducts() async { ... }
-  Future<void> createOrder(Order order) async { ... }
-  // ...
-}
-```
-
-#### Senza --api-client-name (comportamento predefinito)
-
-Genera classi separate per tag:
-```dart
-// lib/core/api/users_api.dart
-class UsersApi { ... }
-
-// lib/core/api/products_api.dart  
-class ProductsApi { ... }
-
-// lib/core/api/orders_api.dart
-class OrdersApi { ... }
-```
-
-#### Quando usare la classe unificata?
-
-- ✅ Progetti piccoli/medi con pochi endpoint
-- ✅ Quando preferisci un singolo punto di accesso alle API
-- ✅ Per semplificare la dependency injection
-
-#### Quando usare classi separate?
-
-- ✅ Progetti grandi con molti endpoint
-- ✅ Quando vuoi separare le responsabilità per dominio
-- ✅ Per team diversi che lavorano su moduli diversi
-
-## 📁 Struttura File Generati
-
-### Angular
-```
-output/
-├── models/
-│   ├── user.model.ts
-│   ├── product.model.ts
-│   └── ...
-└── api/
-    ├── user.api.ts
-    ├── product.api.ts
-    └── ...
-```
-
-### Next.js
-```
-output/
-├── models/
-│   ├── user.ts
-│   ├── product.ts
-│   └── ...
-└── api/
-    ├── user-api.ts
-    ├── product-api.ts
-    └── ...
-```
-
-### Flutter/Dart
-```
-lib/output/
-├── user/
-│   ├── models/
-│   │   └── user.dart
-│   └── api/
-│       └── user_api.dart
-└── product/
-    ├── models/
-    │   └── product.dart
-    └── api/
-        └── product_api.dart
-```
-
-## 🔧 Integrazione nel Progetto
-
-### Angular
-
-1. Crea un service wrapper:
-
-```typescript
-import { Injectable } from '@angular/core';
-import { HttpClient } from '@angular/common/http';
-import { environment } from '@env/environment';
-
-@Injectable({ providedIn: 'root' })
-export class ApiService {
-  constructor(private http: HttpClient) {}
-  
-  // I tuoi metodi personalizzati qui
-}
-```
-
-2. Usa i modelli generati:
-
-```typescript
-import { User } from './autogen/models/user.model';
-import { UserApi } from './autogen/api/user.api';
-```
-
-### Next.js
-
-```typescript
-import { getUsers } from '@/lib/api/user-api';
-import { User } from '@/lib/api/models/user';
-
-export async function UsersPage() {
-  const users = await getUsers();
-  // ...
-}
-```
-
-### Flutter/Dart
-
-```dart
-import 'package:my_app/core/api/user/api/user_api.dart';
-import 'package:my_app/core/api/user/models/user.dart';
-
-final userApi = UserApi();
-final users = await userApi.getUsers();
-```
-
-## 🐛 Risoluzione Problemi
-
-### Errore: "Swagger validation failed"
-Il documento Swagger non è valido. Verifica:
-- Presenza di `openApi` version
-- Presenza di `paths` object
-- Struttura corretta delle definizioni
-
-### Errore: "Cannot parse null data"
-L'API restituisce null per un tipo primitivo. Verifica che il backend ritorni sempre un valore valido.
-
-### Tipi primitivi non funzionano (Dart)
-✅ **RISOLTO** - Ora il generatore gestisce correttamente String, int, bool, double con conversioni automatiche.
-
-## 🛠️ Sviluppo
-
-```bash
-# Clone repository
-git clone <repo-url>
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Test local
-npm run debug-angular
-npm run debug-nextjs
-npm run debug-flutter
-```
-
-## 📝 Script NPM
-
-| Script | Descrizione |
-|--------|-------------|
-| `npm run build` | Compila TypeScript e copia templates |
-| `npm run debug-angular` | Test con target Angular |
-| `npm run debug-nextjs` | Test con target Next.js |
-| `npm run debug-flutter` | Test con target Flutter |
-| `npm run deploy` | Pubblica su npm |
-
-## 🤝 Contribuire
-
-Contributi benvenuti! Per favore:
-1. Fai fork del progetto
-2. Crea un branch per la tua feature (`git checkout -b feature/amazing-feature`)
-3. Commit dei cambiamenti (`git commit -m 'Add amazing feature'`)
-4. Push del branch (`git push origin feature/amazing-feature`)
-5. Apri una Pull Request
-
-## 📄 Licenza
-
-ISC License - vedi file LICENSE per dettagli
-
-## 🙏 Crediti
-
-Sviluppato da DeVLearninG Team
-
----
-
-**Note**: Questo tool è in sviluppo attivo. Per bug o feature request, apri una issue su GitHub.
+# Swagger API Generator
+
+Generatore automatico di client API e modelli per **Angular**, **Next.js** e **Flutter/Dart** da specifiche Swagger/OpenAPI.
+
+[![npm version](https://img.shields.io/npm/v/@devlearning/swagger-generator.svg)](https://www.npmjs.com/package/@devlearning/swagger-generator)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+
+## 🎯 Caratteristiche
+
+- ✅ **Generazione automatica** di modelli e API da Swagger JSON
+- 🎨 **Multi-framework**: Angular, Next.js, Flutter/Dart
+- 🔒 **Type-safe**: Tipizzazione forte per TypeScript e Dart
+- 📦 **Zero dipendenze** nei file generati (configurabile)
+- 🚀 **CLI semplice** da usare
+- 🔄 **Validazione** del documento Swagger prima della generazione
+- 📝 **Logging strutturato** per debugging
+
+## 📦 Installazione
+
+```bash
+npm install @devlearning/swagger-generator --save-dev
+```
+
+## 🚀 Utilizzo
+
+### Da linea di comando
+
+```bash
+npx swgen --url <swagger-url> --output <output-dir> --target <angular|next|flutter> [opzioni]
+```
+
+### Esempi
+
+#### Angular
+```bash
+npx swgen \
+  --url http://localhost:5000/swagger/v1/swagger.json \
+  --output src/app/core/autogen \
+  --target angular \
+  --dateTimeLibrary moment
+```
+
+#### Next.js
+```bash
+npx swgen \
+  --url https://api.example.com/swagger.json \
+  --output src/lib/api \
+  --target next \
+  --dateTimeLibrary date-fns
+```
+
+#### Flutter/Dart
+```bash
+npx swgen \
+  --url http://localhost:5000/swagger/v1/swagger.json \
+  --output lib/core/api \
+  --target flutter \
+  --package my_app_name
+```
+
+### Opzioni
+
+| Opzione | Alias | Descrizione | Obbligatorio | Default |
+|---------|-------|-------------|--------------|---------|
+| `--url` | `-u` | URL del file swagger.json | ✅ | - |
+| `--output` | `-o` | Directory di output | ✅ | - |
+| `--target` | `-t` | Framework target (`angular`, `next`, `flutter`) | ✅ | - |
+| `--dateTimeLibrary` | `-d` | Libreria date (`moment`, `date-fns`) | ❌ | `date-fns` |
+| `--package` | `-p` | Nome package (solo Dart/Flutter) | ❌ | - |
+| `--api-client-name` | `-a` | Nome classe API unificata | ❌ | - |
+
+### 🆕 API Client Unificata
+
+Di default, il generatore crea classi API separate raggruppate per tag Swagger. Con l'opzione `--api-client-name`, puoi generare una **singola classe unificata** contenente tutti i metodi API.
+
+#### Esempio: Flutter con classe unificata
+
+```bash
+npx swgen \
+  --url http://localhost:5000/swagger/v1/swagger.json \
+  --output lib/core/api \
+  --target flutter \
+  --package my_app \
+  --api-client-name ApiClient
+```
+
+Genera:
+```dart
+// lib/core/api/api_client.dart
+class ApiClient {
+  // Tutti i metodi API in una singola classe
+  Future<User> getUser(String id) async { ... }
+  Future<List<Product>> getProducts() async { ... }
+  Future<void> createOrder(Order order) async { ... }
+  // ...
+}
+```
+
+#### Senza --api-client-name (comportamento predefinito)
+
+Genera classi separate per tag:
+```dart
+// lib/core/api/users_api.dart
+class UsersApi { ... }
+
+// lib/core/api/products_api.dart  
+class ProductsApi { ... }
+
+// lib/core/api/orders_api.dart
+class OrdersApi { ... }
+```
+
+#### Quando usare la classe unificata?
+
+- ✅ Progetti piccoli/medi con pochi endpoint
+- ✅ Quando preferisci un singolo punto di accesso alle API
+- ✅ Per semplificare la dependency injection
+
+#### Quando usare classi separate?
+
+- ✅ Progetti grandi con molti endpoint
+- ✅ Quando vuoi separare le responsabilità per dominio
+- ✅ Per team diversi che lavorano su moduli diversi
+
+## 📁 Struttura File Generati
+
+### Angular
+```
+output/
+├── models/
+│   ├── user.model.ts
+│   ├── product.model.ts
+│   └── ...
+└── api/
+    ├── user.api.ts
+    ├── product.api.ts
+    └── ...
+```
+
+### Next.js
+```
+output/
+├── models/
+│   ├── user.ts
+│   ├── product.ts
+│   └── ...
+└── api/
+    ├── user-api.ts
+    ├── product-api.ts
+    └── ...
+```
+
+### Flutter/Dart
+```
+lib/output/
+├── user/
+│   ├── models/
+│   │   └── user.dart
+│   └── api/
+│       └── user_api.dart
+└── product/
+    ├── models/
+    │   └── product.dart
+    └── api/
+        └── product_api.dart
+```
+
+## 🔧 Integrazione nel Progetto
+
+### Angular
+
+1. Crea un service wrapper:
+
+```typescript
+import { Injectable } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { environment } from '@env/environment';
+
+@Injectable({ providedIn: 'root' })
+export class ApiService {
+  constructor(private http: HttpClient) {}
+  
+  // I tuoi metodi personalizzati qui
+}
+```
+
+2. Usa i modelli generati:
+
+```typescript
+import { User } from './autogen/models/user.model';
+import { UserApi } from './autogen/api/user.api';
+```
+
+### Next.js
+
+```typescript
+import { getUsers } from '@/lib/api/user-api';
+import { User } from '@/lib/api/models/user';
+
+export async function UsersPage() {
+  const users = await getUsers();
+  // ...
+}
+```
+
+### Flutter/Dart
+
+```dart
+import 'package:my_app/core/api/user/api/user_api.dart';
+import 'package:my_app/core/api/user/models/user.dart';
+
+final userApi = UserApi();
+final users = await userApi.getUsers();
+```
+
+## 🐛 Risoluzione Problemi
+
+### Errore: "Swagger validation failed"
+Il documento Swagger non è valido. Verifica:
+- Presenza di `openApi` version
+- Presenza di `paths` object
+- Struttura corretta delle definizioni
+
+### Errore: "Cannot parse null data"
+L'API restituisce null per un tipo primitivo. Verifica che il backend ritorni sempre un valore valido.
+
+### Tipi primitivi non funzionano (Dart)
+✅ **RISOLTO** - Ora il generatore gestisce correttamente String, int, bool, double con conversioni automatiche.
+
+## 🛠️ Sviluppo
+
+```bash
+# Clone repository
+git clone <repo-url>
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test local
+npm run debug-angular
+npm run debug-nextjs
+npm run debug-flutter
+```
+
+## 📝 Script NPM
+
+| Script | Descrizione |
+|--------|-------------|
+| `npm run build` | Compila TypeScript e copia templates |
+| `npm run debug-angular` | Test con target Angular |
+| `npm run debug-nextjs` | Test con target Next.js |
+| `npm run debug-flutter` | Test con target Flutter |
+| `npm run deploy` | Pubblica su npm |
+
+## 🤝 Contribuire
+
+Contributi benvenuti! Per favore:
+1. Fai fork del progetto
+2. Crea un branch per la tua feature (`git checkout -b feature/amazing-feature`)
+3. Commit dei cambiamenti (`git commit -m 'Add amazing feature'`)
+4. Push del branch (`git push origin feature/amazing-feature`)
+5. Apri una Pull Request
+
+## 📄 Licenza
+
+ISC License - vedi file LICENSE per dettagli
+
+## 🙏 Crediti
+
+Sviluppato da DeVLearninG Team
+
+---
+
+**Note**: Questo tool è in sviluppo attivo. Per bug o feature request, apri una issue su GitHub.

package/dist/api.constants.d.ts

@@ -1,2 +1,2 @@
-export declare const API_PRE = "import { HttpClient } from '@angular/common/http';\nimport { Observable, catchError, map } from 'rxjs';\nimport * as Models from './model.autogenerated';\nimport { HttpHeaders } from \"@angular/common/http\";\n\nexport const httpOptions = {\n  headers: new HttpHeaders({ 'Content-Type': 'application/json' }),\n};\n\nexport const httpOptionsMultipart = {};\n\nexport abstract class ApiAutogeneratedService {\n  constructor(\n    public _http: HttpClient,\n    public _baseUrl: string,\n  ) { }\n\n  protected abstract _momentToString(moment: moment.Moment): string;\n  protected abstract _handleRequest<T>(request: T): T;\n  protected abstract _handleMultipart<T>(request: T): FormData;\n  protected abstract _handleResponse<T>(response: T): T;\n  protected abstract _handleError(error: any, obs: any): Observable<never>;\n";
+export declare const API_PRE = "import { HttpClient } from '@angular/common/http';\nimport { Observable, catchError, map } from 'rxjs';\nimport * as Models from './model.autogenerated';\nimport { HttpHeaders } from \"@angular/common/http\";\n\nexport const httpOptions = {\n  headers: new HttpHeaders({ 'Content-Type': 'application/json' }),\n};\n\nexport const httpOptionsMultipart = {};\n\nexport abstract class ApiAutogeneratedService {\n  constructor(\n    public _http: HttpClient,\n    public _baseUrl: string,\n  ) { }\n\n  protected abstract _momentToString(moment: moment.Moment): string;\n  protected abstract _handleRequest<T>(request: T): T;\n  protected abstract _handleMultipart<T>(request: T): FormData;\n  protected abstract _handleResponse<T>(response: T): T;\n  protected abstract _handleError(error: any, obs: any, skipErrorHandling: boolean): Observable<never>;\n";
 export declare const API_POST = "}";

package/dist/api.constants.js

@@ -1,24 +1,24 @@
-export const API_PRE = `import { HttpClient } from '@angular/common/http';
-import { Observable, catchError, map } from 'rxjs';
-import * as Models from './model.autogenerated';
-import { HttpHeaders } from "@angular/common/http";
-
-export const httpOptions = {
-  headers: new HttpHeaders({ 'Content-Type': 'application/json' }),
-};
-
-export const httpOptionsMultipart = {};
-
-export abstract class ApiAutogeneratedService {
-  constructor(
-    public _http: HttpClient,
-    public _baseUrl: string,
-  ) { }
-
-  protected abstract _momentToString(moment: moment.Moment): string;
-  protected abstract _handleRequest<T>(request: T): T;
-  protected abstract _handleMultipart<T>(request: T): FormData;
-  protected abstract _handleResponse<T>(response: T): T;
-  protected abstract _handleError(error: any, obs: any): Observable<never>;
+export const API_PRE = `import { HttpClient } from '@angular/common/http';
+import { Observable, catchError, map } from 'rxjs';
+import * as Models from './model.autogenerated';
+import { HttpHeaders } from "@angular/common/http";
+
+export const httpOptions = {
+  headers: new HttpHeaders({ 'Content-Type': 'application/json' }),
+};
+
+export const httpOptionsMultipart = {};
+
+export abstract class ApiAutogeneratedService {
+  constructor(
+    public _http: HttpClient,
+    public _baseUrl: string,
+  ) { }
+
+  protected abstract _momentToString(moment: moment.Moment): string;
+  protected abstract _handleRequest<T>(request: T): T;
+  protected abstract _handleMultipart<T>(request: T): FormData;
+  protected abstract _handleResponse<T>(response: T): T;
+  protected abstract _handleError(error: any, obs: any, skipErrorHandling: boolean): Observable<never>;
 `;
 export const API_POST = `}`;