@nestia/sdk 1.0.0 → 1.0.2
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/assets/config/nestia.config.ts +70 -70
- package/lib/INestiaConfig.d.ts +28 -9
- package/lib/analyses/ControllerAnalyzer.js +21 -1
- package/lib/analyses/ControllerAnalyzer.js.map +1 -1
- package/lib/executable/internal/NestiaSdkConfig.js +168 -14
- package/lib/executable/internal/NestiaSdkConfig.js.map +1 -1
- package/lib/executable/sdk.js +16 -16
- package/lib/generates/FunctionGenerator.js +35 -15
- package/lib/generates/FunctionGenerator.js.map +1 -1
- package/lib/generates/SwaggerGenerator.d.ts +1 -1
- package/lib/generates/SwaggerGenerator.js +36 -16
- package/lib/generates/SwaggerGenerator.js.map +1 -1
- package/lib/structures/IRoute.d.ts +8 -0
- package/lib/structures/ISwaggerDocument.d.ts +95 -0
- package/lib/structures/{ISwagger.js → ISwaggerDocument.js} +1 -1
- package/lib/structures/ISwaggerDocument.js.map +1 -0
- package/package.json +3 -3
- package/src/INestiaConfig.ts +147 -120
- package/src/NestiaSdkApplication.ts +183 -183
- package/src/analyses/ControllerAnalyzer.ts +223 -203
- package/src/analyses/GenericAnalyzer.ts +53 -53
- package/src/analyses/ImportAnalyzer.ts +143 -143
- package/src/analyses/PathAnalyzer.ts +58 -58
- package/src/analyses/ReflectAnalyzer.ts +279 -279
- package/src/analyses/SourceFinder.ts +59 -59
- package/src/executable/internal/CommandParser.ts +15 -15
- package/src/executable/internal/NestiaConfigCompilerOptions.ts +18 -18
- package/src/executable/internal/NestiaSdkCommand.ts +174 -174
- package/src/executable/internal/NestiaSdkConfig.ts +35 -35
- package/src/executable/internal/nestia.config.getter.ts +12 -12
- package/src/executable/sdk.ts +74 -74
- package/src/generates/FileGenerator.ts +156 -156
- package/src/generates/FunctionGenerator.ts +322 -287
- package/src/generates/SdkGenerator.ts +50 -50
- package/src/generates/SwaggerGenerator.ts +422 -393
- package/src/index.ts +3 -3
- package/src/module.ts +2 -2
- package/src/structures/IController.ts +27 -27
- package/src/structures/IRoute.ts +33 -29
- package/src/structures/ISwaggerDocument.ts +117 -0
- package/src/structures/ITypeTuple.ts +6 -6
- package/src/structures/MethodType.ts +11 -11
- package/src/structures/ParamCategory.ts +1 -1
- package/src/structures/TypeEntry.ts +22 -22
- package/src/utils/ArrayUtil.ts +26 -26
- package/src/utils/ImportDictionary.ts +56 -56
- package/src/utils/MapUtil.ts +14 -14
- package/src/utils/StripEnums.ts +10 -10
- package/lib/structures/ISwagger.d.ts +0 -48
- package/lib/structures/ISwagger.js.map +0 -1
- package/src/structures/ISwagger.ts +0 -55
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FunctionGenerator.js","sourceRoot":"","sources":["../../src/generates/FunctionGenerator.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAC/C,4CAAyC;AAEzC,qDAAkD;AAKlD,IAAiB,iBAAiB,
|
|
1
|
+
{"version":3,"file":"FunctionGenerator.js","sourceRoot":"","sources":["../../src/generates/FunctionGenerator.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,5 +2,5 @@ import ts from "typescript";
|
|
|
2
2
|
import { INestiaConfig } from "../INestiaConfig";
|
|
3
3
|
import { IRoute } from "../structures/IRoute";
|
|
4
4
|
export declare namespace SwaggerGenerator {
|
|
5
|
-
function generate(checker: ts.TypeChecker, config: INestiaConfig.
|
|
5
|
+
function generate(checker: ts.TypeChecker, config: INestiaConfig.ISwaggerConfig, routeList: IRoute[]): Promise<void>;
|
|
6
6
|
}
|
|
@@ -25,6 +25,7 @@ const MapUtil_1 = require("../utils/MapUtil");
|
|
|
25
25
|
var SwaggerGenerator;
|
|
26
26
|
(function (SwaggerGenerator) {
|
|
27
27
|
function generate(checker, config, routeList) {
|
|
28
|
+
var _a;
|
|
28
29
|
return __awaiter(this, void 0, void 0, function* () {
|
|
29
30
|
// PREPARE ASSETS
|
|
30
31
|
const parsed = path_1.default.parse(config.output);
|
|
@@ -50,10 +51,13 @@ var SwaggerGenerator;
|
|
|
50
51
|
const application = ApplicationProgrammer_1.ApplicationProgrammer.generate(tupleList.map(({ metadata }) => metadata), {
|
|
51
52
|
purpose: "swagger",
|
|
52
53
|
});
|
|
53
|
-
swagger.components = Object.assign(Object.assign({}, (swagger.components
|
|
54
|
+
swagger.components = Object.assign(Object.assign({}, ((_a = swagger.components) !== null && _a !== void 0 ? _a : {})), { schemas: application.components.schemas });
|
|
54
55
|
tupleList.forEach(({ schema }, index) => {
|
|
55
56
|
Object.assign(schema, application.schemas[index]);
|
|
56
57
|
});
|
|
58
|
+
// CONFIGURE SECURITY
|
|
59
|
+
if (config.security)
|
|
60
|
+
fill_security(config.security, swagger);
|
|
57
61
|
// ERASE IJsonComponents.IObject.$id
|
|
58
62
|
for (const obj of Object.values(swagger.components.schemas))
|
|
59
63
|
if (obj.$id)
|
|
@@ -116,17 +120,34 @@ var SwaggerGenerator;
|
|
|
116
120
|
: undefined,
|
|
117
121
|
responses: generate_response_body(checker, collection, tupleList, route),
|
|
118
122
|
description: CommentFactory_1.CommentFactory.generate(route.comments),
|
|
123
|
+
"x-nestia-jsDocTags": route.tags,
|
|
119
124
|
};
|
|
120
125
|
}
|
|
126
|
+
function fill_security(security, swagger) {
|
|
127
|
+
var _a;
|
|
128
|
+
(_a = swagger.security) !== null && _a !== void 0 ? _a : (swagger.security = []);
|
|
129
|
+
swagger.components.securitySchemes = {};
|
|
130
|
+
for (const [key, value] of Object.entries(security)) {
|
|
131
|
+
swagger.security.push(key);
|
|
132
|
+
swagger.components.securitySchemes[key] = emend_security(value);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
function emend_security(input) {
|
|
136
|
+
var _a, _b;
|
|
137
|
+
if (input.type === "apiKey")
|
|
138
|
+
return Object.assign(Object.assign({}, input), { in: (_a = input.in) !== null && _a !== void 0 ? _a : "header", name: (_b = input.name) !== null && _b !== void 0 ? _b : "Authorization" });
|
|
139
|
+
return input;
|
|
140
|
+
}
|
|
121
141
|
/* ---------------------------------------------------------
|
|
122
142
|
REQUEST & RESPONSE
|
|
123
143
|
--------------------------------------------------------- */
|
|
124
144
|
function generate_parameter(checker, collection, tupleList, route, parameter) {
|
|
145
|
+
var _a;
|
|
125
146
|
const schema = generate_schema(checker, collection, tupleList, parameter.type.type);
|
|
126
147
|
if (schema === null)
|
|
127
148
|
throw new Error(`Error on NestiaApplication.sdk(): invalid parameter type on ${route.symbol}#${parameter.name}`);
|
|
128
149
|
return {
|
|
129
|
-
name: parameter.field
|
|
150
|
+
name: (_a = parameter.field) !== null && _a !== void 0 ? _a : parameter.name,
|
|
130
151
|
in: parameter.category === "param" ? "path" : parameter.category,
|
|
131
152
|
description: get_parametric_description(route, "param", parameter.name) ||
|
|
132
153
|
"",
|
|
@@ -135,13 +156,13 @@ var SwaggerGenerator;
|
|
|
135
156
|
};
|
|
136
157
|
}
|
|
137
158
|
function generate_request_body(checker, collection, tupleList, route, parameter) {
|
|
159
|
+
var _a;
|
|
138
160
|
const schema = generate_schema(checker, collection, tupleList, parameter.type.type);
|
|
139
161
|
if (schema === null)
|
|
140
162
|
throw new Error(`Error on NestiaApplication.sdk(): invalid request body type on ${route.symbol}.`);
|
|
141
163
|
return {
|
|
142
164
|
description: warning.get(parameter.encrypted).get("request") +
|
|
143
|
-
(get_parametric_description(route, "param", parameter.name)
|
|
144
|
-
""),
|
|
165
|
+
((_a = get_parametric_description(route, "param", parameter.name)) !== null && _a !== void 0 ? _a : ""),
|
|
145
166
|
content: {
|
|
146
167
|
"application/json": {
|
|
147
168
|
schema,
|
|
@@ -151,15 +172,14 @@ var SwaggerGenerator;
|
|
|
151
172
|
};
|
|
152
173
|
}
|
|
153
174
|
function generate_response_body(checker, collection, tupleList, route) {
|
|
175
|
+
var _a, _b;
|
|
154
176
|
// OUTPUT WITH SUCCESS STATUS
|
|
155
177
|
const status = route.method === "GET" || route.method === "DELETE" ? "200" : "201";
|
|
156
178
|
const schema = generate_schema(checker, collection, tupleList, route.output.type);
|
|
157
179
|
const success = {
|
|
158
180
|
[status]: {
|
|
159
181
|
description: warning.get(route.encrypted).get("response", route.method) +
|
|
160
|
-
(get_parametric_description(route, "return")
|
|
161
|
-
get_parametric_description(route, "returns") ||
|
|
162
|
-
""),
|
|
182
|
+
((_b = (_a = get_parametric_description(route, "return")) !== null && _a !== void 0 ? _a : get_parametric_description(route, "returns")) !== null && _b !== void 0 ? _b : ""),
|
|
163
183
|
content: schema === null || route.output.name === "void"
|
|
164
184
|
? undefined
|
|
165
185
|
: {
|
|
@@ -229,15 +249,15 @@ const warning = new VariadicSingleton_1.VariadicSingleton((encrypted) => {
|
|
|
229
249
|
: `[EncryptedRoute.${method[0].toUpperCase()}.${method
|
|
230
250
|
.substring(1)
|
|
231
251
|
.toLowerCase()}](https://github.com/samchon/@nestia/core#encryptedroute)`;
|
|
232
|
-
return `## Warning
|
|
233
|
-
${summary}
|
|
234
|
-
|
|
235
|
-
The ${type} body data would be encrypted as "AES-128(256) / CBC mode / PKCS#5 Padding / Base64 Encoding", through the ${component} component.
|
|
236
|
-
|
|
237
|
-
Therefore, just utilize this swagger editor only for referencing. If you need to call the real API, using [SDK](https://github.com/samchon/nestia#software-development-kit) would be much better.
|
|
238
|
-
|
|
239
|
-
-----------------
|
|
240
|
-
|
|
252
|
+
return `## Warning
|
|
253
|
+
${summary}
|
|
254
|
+
|
|
255
|
+
The ${type} body data would be encrypted as "AES-128(256) / CBC mode / PKCS#5 Padding / Base64 Encoding", through the ${component} component.
|
|
256
|
+
|
|
257
|
+
Therefore, just utilize this swagger editor only for referencing. If you need to call the real API, using [SDK](https://github.com/samchon/nestia#software-development-kit) would be much better.
|
|
258
|
+
|
|
259
|
+
-----------------
|
|
260
|
+
|
|
241
261
|
`;
|
|
242
262
|
});
|
|
243
263
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SwaggerGenerator.js","sourceRoot":"","sources":["../../src/generates/SwaggerGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAA4B;AAC5B,qDAAkD;AAClD,qEAAkE;AAGlE,uEAAoE;AACpE,+EAA4E;AAC5E,yEAAsE;AAEtE,uFAAoF;AAKpF,8CAA2C;AAE3C,IAAiB,gBAAgB,
|
|
1
|
+
{"version":3,"file":"SwaggerGenerator.js","sourceRoot":"","sources":["../../src/generates/SwaggerGenerator.ts"],"names":[],"mappings":"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"}
|
|
@@ -12,6 +12,14 @@ export interface IRoute {
|
|
|
12
12
|
symbol: string;
|
|
13
13
|
comments: ts.SymbolDisplayPart[];
|
|
14
14
|
tags: ts.JSDocTagInfo[];
|
|
15
|
+
setHeaders: Array<{
|
|
16
|
+
type: "setter";
|
|
17
|
+
source: string;
|
|
18
|
+
target?: string;
|
|
19
|
+
} | {
|
|
20
|
+
type: "assigner";
|
|
21
|
+
source: string;
|
|
22
|
+
}>;
|
|
15
23
|
}
|
|
16
24
|
export declare namespace IRoute {
|
|
17
25
|
interface IParameter {
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { IJsonComponents, IJsonSchema } from "typia";
|
|
2
|
+
import { IJsDocTagInfo } from "typia/lib/metadata/IJsDocTagInfo";
|
|
3
|
+
export interface ISwaggerDocument {
|
|
4
|
+
openapi: "3.0";
|
|
5
|
+
servers: ISwaggerDocument.IServer[];
|
|
6
|
+
info: ISwaggerDocument.IInfo;
|
|
7
|
+
components: ISwaggerDocument.IComponents;
|
|
8
|
+
security?: string[];
|
|
9
|
+
paths: Record<string, ISwaggerDocument.IPath>;
|
|
10
|
+
}
|
|
11
|
+
export declare namespace ISwaggerDocument {
|
|
12
|
+
interface IServer {
|
|
13
|
+
url: string;
|
|
14
|
+
description?: string;
|
|
15
|
+
}
|
|
16
|
+
interface IInfo {
|
|
17
|
+
version: string;
|
|
18
|
+
title: string;
|
|
19
|
+
}
|
|
20
|
+
interface IComponents extends IJsonComponents {
|
|
21
|
+
securitySchemes?: Record<string, ISecurityScheme>;
|
|
22
|
+
}
|
|
23
|
+
type ISecurityScheme = ISecurityScheme.IHttpBasic | ISecurityScheme.IHttpBearer | ISecurityScheme.IApiKey | ISecurityScheme.IOpenId | ISecurityScheme.IOAuth2;
|
|
24
|
+
namespace ISecurityScheme {
|
|
25
|
+
interface IHttpBasic {
|
|
26
|
+
type: "http";
|
|
27
|
+
schema: "basic";
|
|
28
|
+
}
|
|
29
|
+
interface IHttpBearer {
|
|
30
|
+
type: "http";
|
|
31
|
+
scheme: "bearer";
|
|
32
|
+
bearerFormat?: string;
|
|
33
|
+
}
|
|
34
|
+
interface IApiKey {
|
|
35
|
+
type: "apiKey";
|
|
36
|
+
in: "header" | "query" | "cookie";
|
|
37
|
+
name: string;
|
|
38
|
+
}
|
|
39
|
+
interface IOpenId {
|
|
40
|
+
type: "openIdConnect";
|
|
41
|
+
openIdConnectUrl: string;
|
|
42
|
+
}
|
|
43
|
+
interface IOAuth2 {
|
|
44
|
+
type: "oauth2";
|
|
45
|
+
flows: IOAuth2.IFlowSet;
|
|
46
|
+
description?: string;
|
|
47
|
+
}
|
|
48
|
+
namespace IOAuth2 {
|
|
49
|
+
interface IFlowSet {
|
|
50
|
+
authorizationCode?: IFlow;
|
|
51
|
+
implicit?: Omit<IFlow, "tokenUrl">;
|
|
52
|
+
password?: Omit<IFlow, "authorizationUrl">;
|
|
53
|
+
clientCredentials?: Omit<IFlow, "authorizationUrl">;
|
|
54
|
+
}
|
|
55
|
+
interface IFlow {
|
|
56
|
+
authorizationUrl: string;
|
|
57
|
+
tokenUrl: string;
|
|
58
|
+
refreshUrl: string;
|
|
59
|
+
scopes?: Record<string, string>;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
type IPath = Record<string, IRoute>;
|
|
64
|
+
interface IRoute {
|
|
65
|
+
tags: string[];
|
|
66
|
+
parameters: IParameter[];
|
|
67
|
+
requestBody?: IRequestBody;
|
|
68
|
+
responses: IResponseBody;
|
|
69
|
+
summary?: string;
|
|
70
|
+
description: string;
|
|
71
|
+
security?: string[];
|
|
72
|
+
"x-nestia-jsDocTags": IJsDocTagInfo[];
|
|
73
|
+
}
|
|
74
|
+
interface IParameter {
|
|
75
|
+
name: string;
|
|
76
|
+
in: string;
|
|
77
|
+
schema: IJsonSchema;
|
|
78
|
+
required: true;
|
|
79
|
+
description: string;
|
|
80
|
+
}
|
|
81
|
+
interface IRequestBody {
|
|
82
|
+
description: string;
|
|
83
|
+
content: IJsonContent;
|
|
84
|
+
required: true;
|
|
85
|
+
}
|
|
86
|
+
type IResponseBody = Record<string, {
|
|
87
|
+
description: string;
|
|
88
|
+
content?: IJsonContent;
|
|
89
|
+
}>;
|
|
90
|
+
interface IJsonContent {
|
|
91
|
+
"application/json": {
|
|
92
|
+
schema: IJsonSchema;
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ISwaggerDocument.js","sourceRoot":"","sources":["../../src/structures/ISwaggerDocument.ts"],"names":[],"mappings":""}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nestia/sdk",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Nestia SDK and Swagger generator",
|
|
5
5
|
"main": "lib/index.js",
|
|
6
6
|
"typings": "lib/index.d.ts",
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
},
|
|
33
33
|
"homepage": "https://github.com/samchon/nestia",
|
|
34
34
|
"devDependencies": {
|
|
35
|
-
"@nestia/core": "^1.0.
|
|
35
|
+
"@nestia/core": "^1.0.7",
|
|
36
36
|
"@nestia/fetcher": "^1.0.0",
|
|
37
37
|
"@trivago/prettier-plugin-sort-imports": "^4.0.0",
|
|
38
38
|
"@types/cli": "^0.11.21",
|
|
@@ -60,7 +60,7 @@
|
|
|
60
60
|
"tsconfck": "^2.0.1",
|
|
61
61
|
"tsconfig-paths": "^4.1.1",
|
|
62
62
|
"tstl": "^2.5.13",
|
|
63
|
-
"typia": "^3.4.
|
|
63
|
+
"typia": "^3.4.22"
|
|
64
64
|
},
|
|
65
65
|
"files": [
|
|
66
66
|
"assets",
|
package/src/INestiaConfig.ts
CHANGED
|
@@ -1,120 +1,147 @@
|
|
|
1
|
-
import ts from "typescript";
|
|
2
|
-
|
|
3
|
-
import
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
* const
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
* ...
|
|
40
|
-
* }
|
|
41
|
-
*
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
*
|
|
64
|
-
*
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
*
|
|
71
|
-
*
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
76
|
-
*
|
|
77
|
-
*
|
|
78
|
-
*
|
|
79
|
-
*
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
*
|
|
86
|
-
*
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
*
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
*
|
|
116
|
-
*
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
1
|
+
import ts from "typescript";
|
|
2
|
+
|
|
3
|
+
import { ISwaggerDocument } from "./structures/ISwaggerDocument";
|
|
4
|
+
import type { StripEnums } from "./utils/StripEnums";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Definition for the `nestia.config.ts` file.
|
|
8
|
+
*
|
|
9
|
+
* @author Jeongho Nam - https://github.com/samchon
|
|
10
|
+
*/
|
|
11
|
+
export interface INestiaConfig {
|
|
12
|
+
/**
|
|
13
|
+
* List of files or directories containing the NestJS controller classes.
|
|
14
|
+
*/
|
|
15
|
+
input: string | string[] | INestiaConfig.IInput;
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Output directory that SDK would be placed in.
|
|
19
|
+
*
|
|
20
|
+
* If not configured, you can't build the SDK library.
|
|
21
|
+
*/
|
|
22
|
+
output?: string;
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Compiler options for the TypeScript.
|
|
26
|
+
*
|
|
27
|
+
* If you've omitted this property or the assigned property cannot fully cover the
|
|
28
|
+
* `tsconfig.json`, the properties from the `tsconfig.json` would be assigned to here.
|
|
29
|
+
* Otherwise, this property has been configured and it's detailed values are different
|
|
30
|
+
* with the `tsconfig.json`, this property values would be used instead.
|
|
31
|
+
*
|
|
32
|
+
* ```typescript
|
|
33
|
+
* import ts from "typescript";
|
|
34
|
+
*
|
|
35
|
+
* const tsconfig: ts.TsConfig;
|
|
36
|
+
* const nestiaConfig: IConfiguration;
|
|
37
|
+
*
|
|
38
|
+
* const compilerOptions: ts.CompilerOptions = {
|
|
39
|
+
* ...tsconfig.compilerOptions,
|
|
40
|
+
* ...(nestiaConfig.compilerOptions || {})
|
|
41
|
+
* }
|
|
42
|
+
* ```
|
|
43
|
+
*/
|
|
44
|
+
compilerOptions?: StripEnums<ts.CompilerOptions>;
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Whether to assert parameter types or not.
|
|
48
|
+
*
|
|
49
|
+
* If you configure this property to be `true`, all of the function parameters
|
|
50
|
+
* would be checked through [typia](https://github.com/samchon/typia#runtime-validators).
|
|
51
|
+
* This option would make your SDK library slower, but would enahcne the type safety
|
|
52
|
+
* even in the runtime level.
|
|
53
|
+
*
|
|
54
|
+
* @default false
|
|
55
|
+
*/
|
|
56
|
+
assert?: boolean;
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Whether to optimize JSON string conversion 10x faster or not.
|
|
60
|
+
*
|
|
61
|
+
* If you configure this property to be `true`, the SDK library would utilize the
|
|
62
|
+
* [typia](https://github.com/samchon/typia#enhanced-json)
|
|
63
|
+
* and the JSON string conversion speed really be 10x faster.
|
|
64
|
+
*
|
|
65
|
+
* @default false
|
|
66
|
+
*/
|
|
67
|
+
json?: boolean;
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Whether to wrap DTO by primitive type.
|
|
71
|
+
*
|
|
72
|
+
* If you don't configure this property as `false`, all of DTOs in the
|
|
73
|
+
* SDK library would be automatically wrapped by {@link Primitive} type.
|
|
74
|
+
*
|
|
75
|
+
* For refenrece, if a DTO type be capsuled by the {@link Primitive} type,
|
|
76
|
+
* all of methods in the DTO type would be automatically erased. Also, if
|
|
77
|
+
* the DTO has a `toJSON()` method, the DTO type would be automatically
|
|
78
|
+
* converted to return type of the `toJSON()` method.
|
|
79
|
+
*
|
|
80
|
+
* @default true
|
|
81
|
+
*/
|
|
82
|
+
primitive?: boolean;
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Building `swagger.json` is also possible.
|
|
86
|
+
*
|
|
87
|
+
* If not specified, you can't build the `swagger.json`.
|
|
88
|
+
*/
|
|
89
|
+
swagger?: INestiaConfig.ISwaggerConfig;
|
|
90
|
+
}
|
|
91
|
+
export namespace INestiaConfig {
|
|
92
|
+
/**
|
|
93
|
+
* List of files or directories to include or exclude to specifying the NestJS
|
|
94
|
+
* controllers.
|
|
95
|
+
*/
|
|
96
|
+
export interface IInput {
|
|
97
|
+
/**
|
|
98
|
+
* List of files or directories containing the NestJS controller classes.
|
|
99
|
+
*/
|
|
100
|
+
include: string[];
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* List of files or directories to be excluded.
|
|
104
|
+
*/
|
|
105
|
+
exclude?: string[];
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Building `swagger.json` is also possible.
|
|
110
|
+
*/
|
|
111
|
+
export interface ISwaggerConfig {
|
|
112
|
+
/**
|
|
113
|
+
* Output path of the `swagger.json`.
|
|
114
|
+
*
|
|
115
|
+
* If you've configured only directory, the file name would be the `swagger.json`.
|
|
116
|
+
* Otherwise you've configured the full path with file name and extension, the
|
|
117
|
+
* `swagger.json` file would be renamed to it.
|
|
118
|
+
*/
|
|
119
|
+
output: string;
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Security schemes.
|
|
123
|
+
*/
|
|
124
|
+
security?: Record<string, ISwaggerConfig.ISecurityScheme>;
|
|
125
|
+
}
|
|
126
|
+
export namespace ISwaggerConfig {
|
|
127
|
+
export type ISecurityScheme =
|
|
128
|
+
| IApiKey
|
|
129
|
+
| Exclude<
|
|
130
|
+
ISwaggerDocument.ISecurityScheme,
|
|
131
|
+
ISwaggerDocument.ISecurityScheme.IApiKey
|
|
132
|
+
>;
|
|
133
|
+
export interface IApiKey {
|
|
134
|
+
type: "apiKey";
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* @default header
|
|
138
|
+
*/
|
|
139
|
+
in?: "header" | "query" | "cookie";
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* @default Authorization
|
|
143
|
+
*/
|
|
144
|
+
name?: string;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
}
|