@devlearning/swagger-generator 1.1.16 → 1.1.17

package/src/generators-writers/dart/api-dart-writer.ts

@@ -1,304 +1,304 @@
-import fs, { writeFileSync } from 'fs';
-import { ApiDto } from '../../models/api-dto.js';
-import { Utils } from '../utils.js';
-import { ParameterDto } from '../../models/parameter-dto.js';
-import Mustache from 'mustache';
-import { CommandLineArgs } from '../../index.js';
-import { ModelDto } from '../../models/model-dto.js';
-import { TypeDto } from '../../models/type-dto.js';
-import { ImportDefinitionDart } from './models/import-definition-dart.js';
-import { Normalizator } from './normalizator.js';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { logger } from '../../utils/logger.js';
-
-interface ApiDefinitionDart {
-  package: string;
-  outputDirectory: string;
-  filename: string;
-  apiClassName: string;
-  imports: string[];
-  endpoints: EndpointDefinitionDart[];
-}
-
-interface EndpointDefinitionDart {
-  methodName: string;
-  httpMethod: HttpMethodDart;
-  path: string;
-  responseType: string;
-  isResponseNativeType: boolean;
-  haveRequest: boolean;
-  requestType?: string; // solo se haveRequest è true
-  queryParams?: Parameter[],
-  pathParams?: Parameter[],
-  isMultiPart: boolean;
-  multipartFields?: MultipartFieldDefinitionDart[];
-}
-
-interface MultipartFieldDefinitionDart {
-  name: string;
-  isFile: boolean;
-  isArray: boolean;
-  nullable: boolean;
-}
-
-interface Parameter {
-  name: string;
-  type: string; // "string", "int", ecc
-  nullable: boolean;
-}
-
-type HttpMethodDart = 'get' | 'post' | 'put' | 'delete' | 'patch';
-
-
-export class ApiDartWriter {
-  private _commandLineArgs: CommandLineArgs;
-
-  constructor(commandLineArgs: CommandLineArgs) {
-    this._commandLineArgs = commandLineArgs;
-  }
-
-  write(apis: ApiDto[], models: ModelDto[]) {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path.dirname(__filename);
-    const templatePath = path.join(__dirname, 'templates', 'api.mustache');
-    const template = fs.readFileSync(templatePath, 'utf-8');
-    let importDirectory = this._commandLineArgs.outputDirectory;
-    if (importDirectory.startsWith('lib/')) {
-      importDirectory = importDirectory.slice('lib/'.length);
-    }
-
-    // Se è specificato apiClientName, genera una singola classe unificata
-    if (this._commandLineArgs.apiClientName) {
-      this._writeUnifiedApi(apis, models, template, importDirectory);
-    } else {
-      // Altrimenti suddividi per tag come prima
-      this._writeApisByTag(apis, models, template, importDirectory);
-    }
-  }
-
-  private _writeUnifiedApi(apis: ApiDto[], models: ModelDto[], template: string, importDirectory: string) {
-    const apiClassName = this._commandLineArgs.apiClientName!;
-    const filename = Utils.toDartFileName(apiClassName);
-    
-    console.log(`Api: Unified API Client - ${apiClassName}`);
-
-    var apiDefinition = <ApiDefinitionDart>{
-      package: this._commandLineArgs.package,
-      outputDirectory: this._commandLineArgs.outputDirectory,
-      filename: filename,
-      apiClassName: apiClassName,
-    }
-
-    var endpoints = <EndpointDefinitionDart[]>[];
-    var imports = <ImportDefinitionDart[]>[];
-
-    // Processa tutte le API senza raggruppamento
-    for (const api of apis) {
-      const endpointData = this._createEndpoint(api, models, imports, importDirectory);
-      endpoints.push(endpointData.endpoint);
-    }
-
-    apiDefinition.endpoints = endpoints;
-    apiDefinition.imports = imports.map(i => i.import);
-
-    let destinationPath = `${this._commandLineArgs.outputDirectory}/api`;
-
-    Utils.ensureDirectorySync(`${destinationPath}`);
-
-    var result = Mustache.render(template, apiDefinition);
-    writeFileSync(`${destinationPath}/${apiDefinition.filename}.dart`, result, 'utf-8');
-  }
-
-  private _writeApisByTag(apis: ApiDto[], models: ModelDto[], template: string, importDirectory: string) {
-    const grouped = this._groupByTag(apis);
-
-    for (const [tag, apis] of Object.entries(grouped)) {
-      logger.progress(`Generating Dart API: ${tag}`);
-
-      let subPath = '';
-      let filename = '';
-      let apiClassName = '';
-
-      subPath = Utils.toDartFileName(tag);
-      filename = `${Utils.toDartFileName(tag + 'Api')}`;
-      apiClassName = `${Utils.toDartClassName(tag + 'Api')}`;
-
-      var apiDefinition = <ApiDefinitionDart>{
-        package: this._commandLineArgs.package,
-        outputDirectory: this._commandLineArgs.outputDirectory,
-        filename: filename,
-        apiClassName: apiClassName,
-      }
-
-      var endpoints = <EndpointDefinitionDart[]>[];
-      var imports = <ImportDefinitionDart[]>[];
-
-      for (const api of apis) {
-        const endpointData = this._createEndpoint(api, models, imports, importDirectory, tag);
-        endpoints.push(endpointData.endpoint);
-      }
-
-      apiDefinition.endpoints = endpoints;
-      apiDefinition.imports = imports.map(i => i.import);
-
-      let destinationPath = `${this._commandLineArgs.outputDirectory}/${subPath}/api`;
-
-      Utils.ensureDirectorySync(`${destinationPath}`);
-
-      var result = Mustache.render(template, apiDefinition);
-      writeFileSync(`${destinationPath}/${apiDefinition.filename}.dart`, result, 'utf-8');
-    }
-  }
-
-  private _createEndpoint(api: ApiDto, models: ModelDto[], imports: ImportDefinitionDart[], importDirectory: string, tag?: string): { endpoint: EndpointDefinitionDart } {
-    var requestType: string | undefined = undefined;
-    requestType = api.haveRequest ? api.parameters[0]?.typeName || 'void' : undefined;
-    requestType = requestType?.split('.').pop()!
-    requestType = Utils.toDartClassName(requestType);
-
-    var responseType: string = 'void';
-    responseType = api.returnType ? api.returnType.typeName : 'void';
-    responseType = responseType?.split('.').pop()!;
-    if (api.returnType?.isNativeType) {
-      responseType = Normalizator.mapTsTypeToDart(responseType);
-    } else {
-      responseType = Utils.toDartClassName(responseType) ?? responseType;
-    }
-
-    var methodName = Utils.getNormalizedApiPathDart(api.name);
-    if (tag && methodName.startsWith(Utils.toFirstLetterLowercase(tag))) {
-      methodName = methodName.slice(tag.length);
-      methodName = Utils.toFirstLetterLowercase(methodName);
-    }
-
-    // console.debug(`\tAPI - ${apiName} - ${apiMethod}`);
-    if (methodName.toLowerCase().indexOf("productsave") >= 0) {
-      debugger
-    }
-
-    const pathParams: Parameter[] = (api.parameters ?? [])
-      .filter(p => p.name !== 'request' && p.isQuery === false)
-      .map(p => ({
-        name: p.name,
-        type: p.typeName ? Normalizator.mapTsTypeToDart(p.typeName)! : 'String',
-        nullable: false,
-      }));
-
-    // Build a Dart-interpolated path string (e.g. '/x/{id}' -> '/x/$id')
-    const pathExpression = api.url.replace(/\{([^}]+)\}/g, (_, rawName) => {
-      const varName = Utils.toFirstLetterLowercase(rawName);
-      return `\$${varName}`;
-    });
-
-    const endpoint = <EndpointDefinitionDart>{
-      methodName: methodName,
-      httpMethod: api.method.toLowerCase() as HttpMethodDart,
-      path: pathExpression,
-      responseType: responseType,
-      isResponseNativeType: api.returnType ? api.returnType.isNativeType : true,
-      haveRequest: api.haveRequest,
-      requestType: requestType,
-      pathParams,
-      isMultiPart: api.isMultiPart === true,
-    };
-
-    if (api.parameters && api.parameters.length > 0 && !api.haveRequest) {
-      endpoint.queryParams = api.parameters
-        .filter(p => p.isQuery === true)
-        .map(p => ({
-          name: p.name,
-          type: p.typeName ? Normalizator.mapTsTypeToDart(p.typeName)! : 'String',
-          nullable: p.nullable
-        }));
-    }
-
-    if (api.haveRequest && api.parameters[0]?.typeName) {
-      if (imports.findIndex(x => x.type.typeName == api.parameters[0]?.typeName) == -1) {
-        models.forEach(model => {
-          if (model.typeName === api.parameters[0]?.typeName) {
-            const normalizedInfo = Normalizator.getNormalizedInfo(model);
-            const importPath = this._buildImportPath(importDirectory, normalizedInfo.subPath, normalizedInfo.filename);
-            imports.push({
-              type: api.parameters[0],
-              import: `import 'package:${this._commandLineArgs.package}/${importPath}';`
-            });
-          }
-        });
-      }
-    }
-
-    // Multipart: include request model fields so template can build FormData
-    if (endpoint.isMultiPart && api.haveRequest && api.parameters[0]?.typeName) {
-      const requestModelTypeName = api.parameters[0].typeName;
-      const requestModel = models.find(m => m.typeName === requestModelTypeName);
-      if (requestModel) {
-        endpoint.multipartFields = requestModel.properties.map(p => ({
-          name: p.name,
-          isFile: p.typeName === 'File',
-          isArray: p.isArray === true,
-          nullable: p.nullable === true,
-        }));
-      } else {
-        endpoint.multipartFields = [];
-      }
-    }
-
-    if (api.returnType && !api.returnType.isNativeType) {
-      if (imports.findIndex(x => x.type.typeName == api.returnType!.typeName) == -1) {
-        models.forEach(model => {
-          if (model.typeName === api.returnType!.typeName) {
-            const normalizedInfo = Normalizator.getNormalizedInfo(model);
-            const importPath = this._buildImportPath(importDirectory, normalizedInfo.subPath, normalizedInfo.filename);
-            imports.push({
-              type: api.returnType!,
-              import: `import 'package:${this._commandLineArgs.package}/${importPath}';`
-            });
-          }
-        });
-      }
-    }
-
-    return { endpoint };
-  }
-
-  private _buildImportPath(importDirectory: string, subPath: string, filename: string): string {
-    // Rimuove slash iniziali e finali da ogni parte
-    const parts = [importDirectory, subPath]
-      .filter(p => p && p.length > 0)
-      .map(p => p.replace(/^\/+|\/+$/g, ''));
-    
-    // Aggiunge il filename alla fine
-    parts.push(`${filename}.dart`);
-    
-    // Unisce con un singolo slash
-    return parts.join('/');
-  }
-
-  private _toPascalCase(input: string): string {
-    return input
-      .replace(/[_\- ]+/g, ' ')              // sostituisce underscore, dash e spazi con uno spazio singolo
-      .trim()                                // rimuove spazi iniziali/finali
-      .split(' ')                            // divide in parole
-      .map(word =>
-        word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
-      )
-      .join('');
-  }
-
-  private _normalizeApiClassName(input: string): string {
-    return input
-      .replace(/\./g, '');
-  }
-
-  private _groupByTag(apis: ApiDto[]) {
-    const groupedByRole = apis.reduce<Record<string, ApiDto[]>>((acc, api) => {
-      if (!acc[api.tag]) {
-        acc[api.tag] = [];
-      }
-      acc[api.tag].push(api);
-      return acc;
-    }, {});
-    return groupedByRole;
-  }
+import fs, { writeFileSync } from 'fs';
+import { ApiDto } from '../../models/api-dto.js';
+import { Utils } from '../utils.js';
+import { ParameterDto } from '../../models/parameter-dto.js';
+import Mustache from 'mustache';
+import { CommandLineArgs } from '../../index.js';
+import { ModelDto } from '../../models/model-dto.js';
+import { TypeDto } from '../../models/type-dto.js';
+import { ImportDefinitionDart } from './models/import-definition-dart.js';
+import { Normalizator } from './normalizator.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { logger } from '../../utils/logger.js';
+
+interface ApiDefinitionDart {
+  package: string;
+  outputDirectory: string;
+  filename: string;
+  apiClassName: string;
+  imports: string[];
+  endpoints: EndpointDefinitionDart[];
+}
+
+interface EndpointDefinitionDart {
+  methodName: string;
+  httpMethod: HttpMethodDart;
+  path: string;
+  responseType: string;
+  isResponseNativeType: boolean;
+  haveRequest: boolean;
+  requestType?: string; // solo se haveRequest è true
+  queryParams?: Parameter[],
+  pathParams?: Parameter[],
+  isMultiPart: boolean;
+  multipartFields?: MultipartFieldDefinitionDart[];
+}
+
+interface MultipartFieldDefinitionDart {
+  name: string;
+  isFile: boolean;
+  isArray: boolean;
+  nullable: boolean;
+}
+
+interface Parameter {
+  name: string;
+  type: string; // "string", "int", ecc
+  nullable: boolean;
+}
+
+type HttpMethodDart = 'get' | 'post' | 'put' | 'delete' | 'patch';
+
+
+export class ApiDartWriter {
+  private _commandLineArgs: CommandLineArgs;
+
+  constructor(commandLineArgs: CommandLineArgs) {
+    this._commandLineArgs = commandLineArgs;
+  }
+
+  write(apis: ApiDto[], models: ModelDto[]) {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const templatePath = path.join(__dirname, 'templates', 'api.mustache');
+    const template = fs.readFileSync(templatePath, 'utf-8');
+    let importDirectory = this._commandLineArgs.outputDirectory;
+    if (importDirectory.startsWith('lib/')) {
+      importDirectory = importDirectory.slice('lib/'.length);
+    }
+
+    // Se è specificato apiClientName, genera una singola classe unificata
+    if (this._commandLineArgs.apiClientName) {
+      this._writeUnifiedApi(apis, models, template, importDirectory);
+    } else {
+      // Altrimenti suddividi per tag come prima
+      this._writeApisByTag(apis, models, template, importDirectory);
+    }
+  }
+
+  private _writeUnifiedApi(apis: ApiDto[], models: ModelDto[], template: string, importDirectory: string) {
+    const apiClassName = this._commandLineArgs.apiClientName!;
+    const filename = Utils.toDartFileName(apiClassName);
+    
+    console.log(`Api: Unified API Client - ${apiClassName}`);
+
+    var apiDefinition = <ApiDefinitionDart>{
+      package: this._commandLineArgs.package,
+      outputDirectory: this._commandLineArgs.outputDirectory,
+      filename: filename,
+      apiClassName: apiClassName,
+    }
+
+    var endpoints = <EndpointDefinitionDart[]>[];
+    var imports = <ImportDefinitionDart[]>[];
+
+    // Processa tutte le API senza raggruppamento
+    for (const api of apis) {
+      const endpointData = this._createEndpoint(api, models, imports, importDirectory);
+      endpoints.push(endpointData.endpoint);
+    }
+
+    apiDefinition.endpoints = endpoints;
+    apiDefinition.imports = imports.map(i => i.import);
+
+    let destinationPath = `${this._commandLineArgs.outputDirectory}/api`;
+
+    Utils.ensureDirectorySync(`${destinationPath}`);
+
+    var result = Mustache.render(template, apiDefinition);
+    writeFileSync(`${destinationPath}/${apiDefinition.filename}.dart`, result, 'utf-8');
+  }
+
+  private _writeApisByTag(apis: ApiDto[], models: ModelDto[], template: string, importDirectory: string) {
+    const grouped = this._groupByTag(apis);
+
+    for (const [tag, apis] of Object.entries(grouped)) {
+      logger.progress(`Generating Dart API: ${tag}`);
+
+      let subPath = '';
+      let filename = '';
+      let apiClassName = '';
+
+      subPath = Utils.toDartFileName(tag);
+      filename = `${Utils.toDartFileName(tag + 'Api')}`;
+      apiClassName = `${Utils.toDartClassName(tag + 'Api')}`;
+
+      var apiDefinition = <ApiDefinitionDart>{
+        package: this._commandLineArgs.package,
+        outputDirectory: this._commandLineArgs.outputDirectory,
+        filename: filename,
+        apiClassName: apiClassName,
+      }
+
+      var endpoints = <EndpointDefinitionDart[]>[];
+      var imports = <ImportDefinitionDart[]>[];
+
+      for (const api of apis) {
+        const endpointData = this._createEndpoint(api, models, imports, importDirectory, tag);
+        endpoints.push(endpointData.endpoint);
+      }
+
+      apiDefinition.endpoints = endpoints;
+      apiDefinition.imports = imports.map(i => i.import);
+
+      let destinationPath = `${this._commandLineArgs.outputDirectory}/${subPath}/api`;
+
+      Utils.ensureDirectorySync(`${destinationPath}`);
+
+      var result = Mustache.render(template, apiDefinition);
+      writeFileSync(`${destinationPath}/${apiDefinition.filename}.dart`, result, 'utf-8');
+    }
+  }
+
+  private _createEndpoint(api: ApiDto, models: ModelDto[], imports: ImportDefinitionDart[], importDirectory: string, tag?: string): { endpoint: EndpointDefinitionDart } {
+    var requestType: string | undefined = undefined;
+    requestType = api.haveRequest ? api.parameters[0]?.typeName || 'void' : undefined;
+    requestType = requestType?.split('.').pop()!
+    requestType = Utils.toDartClassName(requestType);
+
+    var responseType: string = 'void';
+    responseType = api.returnType ? api.returnType.typeName : 'void';
+    responseType = responseType?.split('.').pop()!;
+    if (api.returnType?.isNativeType) {
+      responseType = Normalizator.mapTsTypeToDart(responseType);
+    } else {
+      responseType = Utils.toDartClassName(responseType) ?? responseType;
+    }
+
+    var methodName = Utils.getNormalizedApiPathDart(api.name);
+    if (tag && methodName.startsWith(Utils.toFirstLetterLowercase(tag))) {
+      methodName = methodName.slice(tag.length);
+      methodName = Utils.toFirstLetterLowercase(methodName);
+    }
+
+    // console.debug(`\tAPI - ${apiName} - ${apiMethod}`);
+    if (methodName.toLowerCase().indexOf("productsave") >= 0) {
+      debugger
+    }
+
+    const pathParams: Parameter[] = (api.parameters ?? [])
+      .filter(p => p.name !== 'request' && p.isQuery === false)
+      .map(p => ({
+        name: p.name,
+        type: p.typeName ? Normalizator.mapTsTypeToDart(p.typeName)! : 'String',
+        nullable: false,
+      }));
+
+    // Build a Dart-interpolated path string (e.g. '/x/{id}' -> '/x/$id')
+    const pathExpression = api.url.replace(/\{([^}]+)\}/g, (_, rawName) => {
+      const varName = Utils.toFirstLetterLowercase(rawName);
+      return `\$${varName}`;
+    });
+
+    const endpoint = <EndpointDefinitionDart>{
+      methodName: methodName,
+      httpMethod: api.method.toLowerCase() as HttpMethodDart,
+      path: pathExpression,
+      responseType: responseType,
+      isResponseNativeType: api.returnType ? api.returnType.isNativeType : true,
+      haveRequest: api.haveRequest,
+      requestType: requestType,
+      pathParams,
+      isMultiPart: api.isMultiPart === true,
+    };
+
+    if (api.parameters && api.parameters.length > 0 && !api.haveRequest) {
+      endpoint.queryParams = api.parameters
+        .filter(p => p.isQuery === true)
+        .map(p => ({
+          name: p.name,
+          type: p.typeName ? Normalizator.mapTsTypeToDart(p.typeName)! : 'String',
+          nullable: p.nullable
+        }));
+    }
+
+    if (api.haveRequest && api.parameters[0]?.typeName) {
+      if (imports.findIndex(x => x.type.typeName == api.parameters[0]?.typeName) == -1) {
+        models.forEach(model => {
+          if (model.typeName === api.parameters[0]?.typeName) {
+            const normalizedInfo = Normalizator.getNormalizedInfo(model);
+            const importPath = this._buildImportPath(importDirectory, normalizedInfo.subPath, normalizedInfo.filename);
+            imports.push({
+              type: api.parameters[0],
+              import: `import 'package:${this._commandLineArgs.package}/${importPath}';`
+            });
+          }
+        });
+      }
+    }
+
+    // Multipart: include request model fields so template can build FormData
+    if (endpoint.isMultiPart && api.haveRequest && api.parameters[0]?.typeName) {
+      const requestModelTypeName = api.parameters[0].typeName;
+      const requestModel = models.find(m => m.typeName === requestModelTypeName);
+      if (requestModel) {
+        endpoint.multipartFields = requestModel.properties.map(p => ({
+          name: p.name,
+          isFile: p.typeName === 'File',
+          isArray: p.isArray === true,
+          nullable: p.nullable === true,
+        }));
+      } else {
+        endpoint.multipartFields = [];
+      }
+    }
+
+    if (api.returnType && !api.returnType.isNativeType) {
+      if (imports.findIndex(x => x.type.typeName == api.returnType!.typeName) == -1) {
+        models.forEach(model => {
+          if (model.typeName === api.returnType!.typeName) {
+            const normalizedInfo = Normalizator.getNormalizedInfo(model);
+            const importPath = this._buildImportPath(importDirectory, normalizedInfo.subPath, normalizedInfo.filename);
+            imports.push({
+              type: api.returnType!,
+              import: `import 'package:${this._commandLineArgs.package}/${importPath}';`
+            });
+          }
+        });
+      }
+    }
+
+    return { endpoint };
+  }
+
+  private _buildImportPath(importDirectory: string, subPath: string, filename: string): string {
+    // Rimuove slash iniziali e finali da ogni parte
+    const parts = [importDirectory, subPath]
+      .filter(p => p && p.length > 0)
+      .map(p => p.replace(/^\/+|\/+$/g, ''));
+    
+    // Aggiunge il filename alla fine
+    parts.push(`${filename}.dart`);
+    
+    // Unisce con un singolo slash
+    return parts.join('/');
+  }
+
+  private _toPascalCase(input: string): string {
+    return input
+      .replace(/[_\- ]+/g, ' ')              // sostituisce underscore, dash e spazi con uno spazio singolo
+      .trim()                                // rimuove spazi iniziali/finali
+      .split(' ')                            // divide in parole
+      .map(word =>
+        word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+      )
+      .join('');
+  }
+
+  private _normalizeApiClassName(input: string): string {
+    return input
+      .replace(/\./g, '');
+  }
+
+  private _groupByTag(apis: ApiDto[]) {
+    const groupedByRole = apis.reduce<Record<string, ApiDto[]>>((acc, api) => {
+      if (!acc[api.tag]) {
+        acc[api.tag] = [];
+      }
+      acc[api.tag].push(api);
+      return acc;
+    }, {});
+    return groupedByRole;
+  }
 }