@devlearning/swagger-generator 1.0.5 → 1.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/package.json +37 -0
- package/dist/src/api.constants.js +24 -0
- package/dist/src/generator-old.js +369 -0
- package/dist/src/generator.js +425 -0
- package/dist/src/generators-writers/angular/api-angular-writer.js +113 -0
- package/dist/src/generators-writers/angular/constants.js +28 -0
- package/dist/src/generators-writers/angular/model-angular-writer.js +42 -0
- package/dist/src/generators-writers/nextjs/api-nextjs-writer.js +127 -0
- package/dist/src/generators-writers/nextjs/constants.js +5 -0
- package/dist/src/generators-writers/nextjs/model-nextjs-writer.js +41 -0
- package/dist/src/generators-writers/utils.js +20 -0
- package/dist/src/index.js +24 -0
- package/dist/src/model.constants.js +1 -0
- package/dist/src/models/api-dto.js +1 -0
- package/dist/src/models/enum-value-dto.js +1 -0
- package/dist/src/models/model-dto.js +1 -0
- package/dist/src/models/parameter-dto.js +1 -0
- package/dist/src/models/property-dto.js +1 -0
- package/dist/src/models/swagger/swagger-component-property.js +1 -0
- package/dist/src/models/swagger/swagger-component.js +1 -0
- package/dist/src/models/swagger/swagger-content.js +1 -0
- package/dist/src/models/swagger/swagger-info.js +1 -0
- package/dist/src/models/swagger/swagger-method.js +1 -0
- package/dist/src/models/swagger/swagger-schema.js +1 -0
- package/dist/src/models/swagger/swagger.js +1 -0
- package/dist/src/models/type-dto.js +1 -0
- package/dist/src/swagger-downloader.js +9 -0
- package/package.json +1 -1
- package/src/generator.ts +3 -0
- package/tsconfig.json +1 -0
- package/autogeneration/output/api.autogenerated.ts +0 -50
- package/autogeneration/output/model.autogenerated.ts +0 -10
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import { API_PRE } from './constants.js';
|
|
3
|
+
import { Utils } from '../utils.js';
|
|
4
|
+
export class ApiNextJsWriter {
|
|
5
|
+
_outputDirectory;
|
|
6
|
+
constructor(_outputDirectory) {
|
|
7
|
+
this._outputDirectory = _outputDirectory;
|
|
8
|
+
}
|
|
9
|
+
write(apis) {
|
|
10
|
+
let apiString = '';
|
|
11
|
+
apis.forEach(api => {
|
|
12
|
+
apiString += this._apiString(api);
|
|
13
|
+
});
|
|
14
|
+
this._writeFile(apiString);
|
|
15
|
+
}
|
|
16
|
+
_apiString(api) {
|
|
17
|
+
let apiNameNormalized = Utils.toCamelCase(Utils.getApiNameNormalized(api.name));
|
|
18
|
+
let parametersString = this._parameters(api);
|
|
19
|
+
let queryParametersPreparation = this._queryParametersPreparation(api);
|
|
20
|
+
let requestPreparation = this._requestPreparation(api);
|
|
21
|
+
let queryParameters = this._queryParameters(api);
|
|
22
|
+
let returnTypeString = this._returnType(api);
|
|
23
|
+
let haveRequest = api.haveRequest;
|
|
24
|
+
let method = api.method.toLowerCase();
|
|
25
|
+
let httpOptions = api.isMultiPart ? 'httpOptionsMultiPart' : 'httpOptions';
|
|
26
|
+
let preparation = `${queryParametersPreparation}
|
|
27
|
+
${requestPreparation}`.trim();
|
|
28
|
+
preparation = preparation.length > 0 ? ` ${preparation}\n ` : '';
|
|
29
|
+
//\`\${API_BASE_URL}
|
|
30
|
+
let apiString = `
|
|
31
|
+
export const ${apiNameNormalized} = async (${parametersString}): Promise<${returnTypeString}> => {
|
|
32
|
+
${preparation}const response = await axios.${method}<${returnTypeString}>(\`${api.url}${queryParameters}\`${haveRequest ? ', wrappedRequest' : ''});
|
|
33
|
+
return response.data;
|
|
34
|
+
}
|
|
35
|
+
`;
|
|
36
|
+
return apiString;
|
|
37
|
+
}
|
|
38
|
+
_parameters(api) {
|
|
39
|
+
let parametersString = '';
|
|
40
|
+
api.parameters.forEach(parameter => {
|
|
41
|
+
parametersString += `${parameter.name}${parameter.nullable ? '?' : ''}: ${!parameter.isNativeType ? 'Models.' : ''}${parameter.typeName}, `;
|
|
42
|
+
});
|
|
43
|
+
if (api.parameters.length > 0)
|
|
44
|
+
parametersString = parametersString.substring(0, parametersString.length - 2);
|
|
45
|
+
return parametersString;
|
|
46
|
+
}
|
|
47
|
+
_returnType(api) {
|
|
48
|
+
return api.returnType ? `${!api.returnType.isNativeType ? 'Models.' : ''}${api.returnType.typeName}` : 'any';
|
|
49
|
+
}
|
|
50
|
+
_queryParametersPreparation(api) {
|
|
51
|
+
let queryParametersPreparation = '';
|
|
52
|
+
api.parameters.forEach(parameter => {
|
|
53
|
+
if (parameter.isQuery) {
|
|
54
|
+
queryParametersPreparation += this._queryParametersPreparationStatement(parameter);
|
|
55
|
+
}
|
|
56
|
+
});
|
|
57
|
+
return `${queryParametersPreparation}`;
|
|
58
|
+
}
|
|
59
|
+
_queryParametersPreparationStatement(parameter) {
|
|
60
|
+
if (parameter.nullable) {
|
|
61
|
+
if (Utils.isDate(parameter.swaggerParameter?.schema)) {
|
|
62
|
+
return ` const ${parameter.name}Param: string = ${parameter.name} != null && ${parameter.name} !== undefined && isValid(${parameter.name}) ? encodeURIComponent(dateToZulu(${parameter.name})) : '';
|
|
63
|
+
`;
|
|
64
|
+
}
|
|
65
|
+
else {
|
|
66
|
+
return ` const ${parameter.name}Param: string = ${parameter.name} != null && ${parameter.name} !== undefined ? encodeURIComponent('' + ${parameter.name}) : '';
|
|
67
|
+
`;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
else {
|
|
71
|
+
if (Utils.isDate(parameter.swaggerParameter?.schema)) {
|
|
72
|
+
return ` const ${parameter.name}Param: string = encodeURIComponent(dateToZulu(${parameter.name}));
|
|
73
|
+
`;
|
|
74
|
+
}
|
|
75
|
+
else {
|
|
76
|
+
return ` const ${parameter.name}Param: string = encodeURIComponent('' + ${parameter.name});
|
|
77
|
+
`;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
_queryParameters(api) {
|
|
82
|
+
let queryParameters = '';
|
|
83
|
+
api.parameters.forEach(parameter => {
|
|
84
|
+
if (parameter.isQuery) {
|
|
85
|
+
queryParameters += this._queryParametersStatement(parameter);
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
if (queryParameters.length > 0) {
|
|
89
|
+
queryParameters = '?' + queryParameters.substring(0, queryParameters.length - 1);
|
|
90
|
+
}
|
|
91
|
+
return queryParameters;
|
|
92
|
+
}
|
|
93
|
+
_queryParametersStatement(parameter) {
|
|
94
|
+
if (parameter.swaggerParameter == null)
|
|
95
|
+
return '';
|
|
96
|
+
if (!parameter.isQuery)
|
|
97
|
+
return '';
|
|
98
|
+
return `${parameter.name}=\${${parameter.name}Param}&`;
|
|
99
|
+
// if (parameter.isEnum) {
|
|
100
|
+
// return `${parameter.name}=\${` + parameter.name + `Param}&`;
|
|
101
|
+
// } else {
|
|
102
|
+
// return `${parameter.name}=\${` + parameter.name + `}&`;
|
|
103
|
+
// }
|
|
104
|
+
// if (parameter.swaggerParameter.schema.$ref != null) {
|
|
105
|
+
// if (this.isEnum(parameter.schema.$ref) != null) {
|
|
106
|
+
// parameters += `${this.toFirstLetterLowercase(parameter.name)}=\${` + this.toFirstLetterLowercase(parameter.name) + `Param}&`;;
|
|
107
|
+
// } else {
|
|
108
|
+
// throw new Error("retrieveQueryParameters unmanaged parameter.schema.$ref");
|
|
109
|
+
// }
|
|
110
|
+
// } else {
|
|
111
|
+
// parameters += `${this.toFirstLetterLowercase(parameter.name)}=\${` + this.toFirstLetterLowercase(parameter.name) + `Param}&`;
|
|
112
|
+
// }
|
|
113
|
+
// let paramName = Utils.toFirstLetterLowercase(parameter.name);
|
|
114
|
+
// return `${parameter.swaggerParameter?.name}=\${${paramName}Param}&`;
|
|
115
|
+
}
|
|
116
|
+
_requestPreparation(api) {
|
|
117
|
+
if (!api.haveRequest) {
|
|
118
|
+
return ``;
|
|
119
|
+
}
|
|
120
|
+
return ` const wrappedRequest = handleRequest(request);
|
|
121
|
+
`;
|
|
122
|
+
}
|
|
123
|
+
_writeFile(apis) {
|
|
124
|
+
fs.writeFileSync(this._outputDirectory + "/api.autogenerated.ts", `${API_PRE}
|
|
125
|
+
${apis}`, { flag: 'w' });
|
|
126
|
+
}
|
|
127
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
export class ModelNextJsWriter {
|
|
3
|
+
_outputDirectory;
|
|
4
|
+
constructor(_outputDirectory) {
|
|
5
|
+
this._outputDirectory = _outputDirectory;
|
|
6
|
+
}
|
|
7
|
+
write(models) {
|
|
8
|
+
let modelString = '';
|
|
9
|
+
models.forEach(model => {
|
|
10
|
+
modelString += this._modelString(model);
|
|
11
|
+
});
|
|
12
|
+
this._writeFile(modelString);
|
|
13
|
+
}
|
|
14
|
+
_modelString(model) {
|
|
15
|
+
let modelString = `
|
|
16
|
+
export ${model.modelType} ${model.name} {
|
|
17
|
+
${this._properties(model)}${this._enumValues(model)}
|
|
18
|
+
}
|
|
19
|
+
`;
|
|
20
|
+
return modelString;
|
|
21
|
+
}
|
|
22
|
+
_properties(model) {
|
|
23
|
+
let propertiesString = '';
|
|
24
|
+
model.properties.forEach(property => {
|
|
25
|
+
propertiesString += ` ${property.name}${property.nullable ? '?' : ''}: ${property.typeName};\n`;
|
|
26
|
+
});
|
|
27
|
+
return propertiesString.trimEnd();
|
|
28
|
+
}
|
|
29
|
+
_enumValues(model) {
|
|
30
|
+
let enumValuesString = '';
|
|
31
|
+
model.enumValues.forEach(enumValue => {
|
|
32
|
+
enumValuesString += ` ${enumValue.name} = ${enumValue.value},\n`;
|
|
33
|
+
});
|
|
34
|
+
return enumValuesString.trimEnd();
|
|
35
|
+
}
|
|
36
|
+
_writeFile(models) {
|
|
37
|
+
fs.writeFileSync(this._outputDirectory + "/model.autogenerated.ts", `
|
|
38
|
+
${models}
|
|
39
|
+
`, { flag: 'w' });
|
|
40
|
+
}
|
|
41
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export class Utils {
|
|
2
|
+
static getApiNameNormalized(apiName) {
|
|
3
|
+
let normalizedApiName = apiName.replace('/api/v{version}/', '').replaceAll('/', '_');
|
|
4
|
+
if (normalizedApiName.charAt(0) == '_') {
|
|
5
|
+
normalizedApiName = normalizedApiName.slice(1);
|
|
6
|
+
}
|
|
7
|
+
return this.toFirstLetterLowercase(normalizedApiName);
|
|
8
|
+
}
|
|
9
|
+
static toFirstLetterLowercase(value) {
|
|
10
|
+
return value.charAt(0).toLowerCase() + value.slice(1);
|
|
11
|
+
}
|
|
12
|
+
static toCamelCase(input) {
|
|
13
|
+
return input.replace(/_([a-zA-Z])/g, (_, letter) => letter.toUpperCase());
|
|
14
|
+
}
|
|
15
|
+
static isDate(schema) {
|
|
16
|
+
if (!schema)
|
|
17
|
+
return false;
|
|
18
|
+
return schema.type == 'string' && schema.format == 'date-time';
|
|
19
|
+
}
|
|
20
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { Generator } from './generator.js';
|
|
3
|
+
import { SwaggerDownloader } from './swagger-downloader.js';
|
|
4
|
+
var args = process.argv.slice(2);
|
|
5
|
+
if (args.length !== 4) {
|
|
6
|
+
console.log("Warning: Requires 3 arguments");
|
|
7
|
+
console.log("node index.js [swaggerJsonUrl] [outputDirectory] [angular|next] [moment|date-fns]");
|
|
8
|
+
process.exit();
|
|
9
|
+
}
|
|
10
|
+
const swaggerJsonUrl = args[0];
|
|
11
|
+
const outputDirectory = args[1];
|
|
12
|
+
const outputFormat = args[2] == 'next' ? 'next' : 'angular';
|
|
13
|
+
const dateLib = args[3] == 'moment' ? 'moment' : 'date-fns';
|
|
14
|
+
//const excludedModels = ['Type', 'MethodBase', 'Assembly', 'MethodInfo']
|
|
15
|
+
// const apiUrl = args[0]//"http://localhost:5208";
|
|
16
|
+
// const version = args[1]; //"1";
|
|
17
|
+
// const swaggerJsonUrl = `${apiUrl}/swagger/v${version}/swagger.json`;
|
|
18
|
+
const swaggerDownloader = new SwaggerDownloader();
|
|
19
|
+
swaggerDownloader.download(new URL(swaggerJsonUrl))
|
|
20
|
+
.then(swaggerDoc => {
|
|
21
|
+
return new Generator(swaggerDoc, outputDirectory, outputFormat, dateLib);
|
|
22
|
+
})
|
|
23
|
+
.then(generator => { generator.generate(); });
|
|
24
|
+
// require('./index.js')({swaggerDownloader});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
package/package.json
CHANGED
package/src/generator.ts
CHANGED
|
@@ -15,6 +15,7 @@ import { ModelNextJsWriter } from './generators-writers/nextjs/model-nextjs-writ
|
|
|
15
15
|
import { ModelAngularWriter } from './generators-writers/angular/model-angular-writer.js';
|
|
16
16
|
import { PropertyDto } from './models/property-dto.js';
|
|
17
17
|
import { EnumValueDto } from './models/enum-value-dto.js';
|
|
18
|
+
import pkg from '../package.json' assert { type: 'json' };
|
|
18
19
|
|
|
19
20
|
const contentTypeApplicationJson = 'application/json';
|
|
20
21
|
const contentTypeMultipartFormData = 'multipart/form-data';
|
|
@@ -52,6 +53,8 @@ export class Generator {
|
|
|
52
53
|
}
|
|
53
54
|
|
|
54
55
|
generate() {
|
|
56
|
+
console.info(`%c[Swagger API Generator] Version ${pkg.version}`, 'color: #4CAF50; font-weight: bold;');
|
|
57
|
+
|
|
55
58
|
console.info('%c[Swagger API Generator] %cStarting to parse Swagger JSON file...', 'color: #4CAF50; font-weight: bold;', 'color: #2196F3;');
|
|
56
59
|
|
|
57
60
|
this.computeApi();
|
package/tsconfig.json
CHANGED
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
import { HttpClient } from '@angular/common/http';
|
|
2
|
-
import { Observable, catchError, map } from 'rxjs';
|
|
3
|
-
import * as Models from './model.autogenerated';
|
|
4
|
-
import { HttpHeaders } from "@angular/common/http";
|
|
5
|
-
|
|
6
|
-
export const httpOptions = {
|
|
7
|
-
headers: new HttpHeaders({ 'Content-Type': 'application/json' }),
|
|
8
|
-
};
|
|
9
|
-
|
|
10
|
-
export const httpOptionsMultipart = {};
|
|
11
|
-
|
|
12
|
-
export abstract class ApiAutogeneratedService {
|
|
13
|
-
constructor(
|
|
14
|
-
public _http: HttpClient,
|
|
15
|
-
public _baseUrl: string,
|
|
16
|
-
) { }
|
|
17
|
-
|
|
18
|
-
protected abstract _momentToString(moment: moment.Moment): string;
|
|
19
|
-
protected abstract _handleRequest<T>(request: T): T;
|
|
20
|
-
protected abstract _handleMultipart<T>(request: T): FormData;
|
|
21
|
-
protected abstract _handleResponse<T>(response: T): T;
|
|
22
|
-
protected abstract _handleError(error: any, obs: any): Observable<never>;
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
public catalog_Product_Read(idProduct?: number): Observable<Models.Product> {
|
|
26
|
-
let idProductParam: string = idProduct != null && idProduct != undefined ? encodeURIComponent('' + idProduct) : '';
|
|
27
|
-
return this._http.get<Models.Product>(`${this._baseUrl}/catalog/Product/Read?idProduct=${idProductParam}`, httpOptions)
|
|
28
|
-
.pipe(
|
|
29
|
-
map(x => this._handleResponse(x)),
|
|
30
|
-
catchError((err, obs) => this._handleError(err, <Observable<any>>obs))
|
|
31
|
-
);
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
public catalog_Product_List(): Observable<Models.Product[]> {
|
|
35
|
-
return this._http.get<Models.Product[]>(`${this._baseUrl}/catalog/Product/List`, httpOptions)
|
|
36
|
-
.pipe(
|
|
37
|
-
map(x => this._handleResponse(x)),
|
|
38
|
-
catchError((err, obs) => this._handleError(err, <Observable<any>>obs))
|
|
39
|
-
);
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
public tenant_Tenant(): Observable<string> {
|
|
43
|
-
return this._http.get<string>(`${this._baseUrl}/tenant/Tenant`, httpOptions)
|
|
44
|
-
.pipe(
|
|
45
|
-
map(x => this._handleResponse(x)),
|
|
46
|
-
catchError((err, obs) => this._handleError(err, <Observable<any>>obs))
|
|
47
|
-
);
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
}
|