@nestia/sdk 2.6.3-dev.20240328 → 2.6.4-dev.20240401

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.
Files changed (45) hide show
  1. package/lib/INestiaConfig.d.ts +14 -2
  2. package/lib/executable/internal/NestiaConfigLoader.js +31 -5
  3. package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
  4. package/lib/generates/SwaggerGenerator.d.ts +2 -0
  5. package/lib/generates/SwaggerGenerator.js +19 -3
  6. package/lib/generates/SwaggerGenerator.js.map +1 -1
  7. package/lib/structures/ISwagger.d.ts +5 -28
  8. package/lib/structures/ISwaggerServer.d.ts +15 -0
  9. package/lib/structures/ISwaggerServer.js +3 -0
  10. package/lib/structures/ISwaggerServer.js.map +1 -0
  11. package/lib/structures/ISwaggerTag.d.ts +9 -0
  12. package/lib/structures/ISwaggerTag.js +3 -0
  13. package/lib/structures/ISwaggerTag.js.map +1 -0
  14. package/package.json +3 -3
  15. package/src/INestiaConfig.ts +261 -248
  16. package/src/NestiaSdkApplication.ts +255 -255
  17. package/src/analyses/ExceptionAnalyzer.ts +148 -148
  18. package/src/analyses/ImportAnalyzer.ts +137 -137
  19. package/src/analyses/SecurityAnalyzer.ts +24 -24
  20. package/src/generates/CloneGenerator.ts +62 -62
  21. package/src/generates/E2eGenerator.ts +66 -66
  22. package/src/generates/SdkGenerator.ts +84 -84
  23. package/src/generates/SwaggerGenerator.ts +23 -3
  24. package/src/generates/internal/E2eFileProgrammer.ts +182 -182
  25. package/src/generates/internal/FilePrinter.ts +53 -53
  26. package/src/generates/internal/SdkAliasCollection.ts +152 -152
  27. package/src/generates/internal/SdkCloneProgrammer.ts +155 -155
  28. package/src/generates/internal/SdkFileProgrammer.ts +115 -115
  29. package/src/generates/internal/SdkFunctionProgrammer.ts +298 -298
  30. package/src/generates/internal/SdkImportWizard.ts +55 -55
  31. package/src/generates/internal/SdkNamespaceProgrammer.ts +510 -510
  32. package/src/generates/internal/SdkRouteProgrammer.ts +83 -83
  33. package/src/generates/internal/SdkSimulationProgrammer.ts +365 -365
  34. package/src/generates/internal/SdkTypeProgrammer.ts +385 -385
  35. package/src/generates/internal/SwaggerSchemaGenerator.ts +438 -438
  36. package/src/structures/IController.ts +94 -94
  37. package/src/structures/IRoute.ts +53 -53
  38. package/src/structures/ISwagger.ts +66 -91
  39. package/src/structures/ISwaggerRoute.ts +54 -54
  40. package/src/structures/ISwaggerSecurityScheme.ts +65 -65
  41. package/src/structures/ISwaggerServer.ts +16 -0
  42. package/src/structures/ISwaggerTag.ts +9 -0
  43. package/src/structures/ParamCategory.ts +1 -1
  44. package/src/structures/TypeEntry.ts +22 -22
  45. package/src/utils/StringUtil.ts +6 -6
@@ -1,115 +1,115 @@
1
- import fs from "fs";
2
- import ts from "typescript";
3
-
4
- import { INestiaConfig } from "../../INestiaConfig";
5
- import { IRoute } from "../../structures/IRoute";
6
- import { MapUtil } from "../../utils/MapUtil";
7
- import { FilePrinter } from "./FilePrinter";
8
- import { ImportDictionary } from "./ImportDictionary";
9
- import { SdkRouteDirectory } from "./SdkRouteDirectory";
10
- import { SdkRouteProgrammer } from "./SdkRouteProgrammer";
11
-
12
- export namespace SdkFileProgrammer {
13
- /* ---------------------------------------------------------
14
- CONSTRUCTOR
15
- --------------------------------------------------------- */
16
- export const generate =
17
- (checker: ts.TypeChecker) =>
18
- (config: INestiaConfig) =>
19
- async (routeList: IRoute[]): Promise<void> => {
20
- // CONSTRUCT FOLDER TREE
21
- const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
22
- for (const route of routeList) emplace(root)(route);
23
-
24
- // ITERATE FILES
25
- await iterate(checker)(config)(root)(config.output + "/functional");
26
- };
27
-
28
- const emplace =
29
- (directory: SdkRouteDirectory) =>
30
- (route: IRoute): void => {
31
- // OPEN DIRECTORIES
32
- for (const key of route.accessors.slice(0, -1)) {
33
- directory = MapUtil.take(
34
- directory.children,
35
- key,
36
- () => new SdkRouteDirectory(directory, key),
37
- );
38
- }
39
-
40
- // ADD ROUTE
41
- directory.routes.push(route);
42
- };
43
-
44
- /* ---------------------------------------------------------
45
- FILE ITERATOR
46
- --------------------------------------------------------- */
47
- const iterate =
48
- (checker: ts.TypeChecker) =>
49
- (config: INestiaConfig) =>
50
- (directory: SdkRouteDirectory) =>
51
- async (outDir: string): Promise<void> => {
52
- // CREATE A NEW DIRECTORY
53
- try {
54
- await fs.promises.mkdir(outDir);
55
- } catch {}
56
-
57
- // ITERATE CHILDREN
58
- const statements: ts.Statement[] = [];
59
- for (const [key, value] of directory.children) {
60
- await iterate(checker)(config)(value)(`${outDir}/${key}`);
61
- statements.push(
62
- ts.factory.createExportDeclaration(
63
- undefined,
64
- false,
65
- ts.factory.createNamespaceExport(ts.factory.createIdentifier(key)),
66
- ts.factory.createStringLiteral(`./${key}`),
67
- undefined,
68
- ),
69
- );
70
- }
71
- if (statements.length && directory.routes.length)
72
- statements.push(FilePrinter.enter());
73
-
74
- // ITERATE ROUTES
75
- const importer: ImportDictionary = new ImportDictionary(
76
- `${outDir}/index.ts`,
77
- );
78
- directory.routes.forEach((route, i) => {
79
- if (config.clone !== true)
80
- for (const tuple of route.imports)
81
- for (const instance of tuple[1])
82
- importer.internal({
83
- file: tuple[0],
84
- instance,
85
- type: true,
86
- });
87
- statements.push(
88
- ...SdkRouteProgrammer.generate(checker)(config)(importer)(route),
89
- );
90
- if (i !== directory.routes.length - 1)
91
- statements.push(FilePrinter.enter());
92
- });
93
-
94
- // FINALIZE THE CONTENT
95
- if (directory.routes.length !== 0)
96
- statements.push(
97
- ...importer.toStatements(outDir),
98
- ...(!importer.empty() && statements.length
99
- ? [FilePrinter.enter()]
100
- : []),
101
- ...statements.splice(0, statements.length),
102
- );
103
- await FilePrinter.write({
104
- location: importer.file,
105
- statements,
106
- top:
107
- "/**\n" +
108
- " * @packageDocumentation\n" +
109
- ` * @module ${directory.module}\n` +
110
- " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
111
- " */\n" +
112
- "//================================================================\n",
113
- });
114
- };
115
- }
1
+ import fs from "fs";
2
+ import ts from "typescript";
3
+
4
+ import { INestiaConfig } from "../../INestiaConfig";
5
+ import { IRoute } from "../../structures/IRoute";
6
+ import { MapUtil } from "../../utils/MapUtil";
7
+ import { FilePrinter } from "./FilePrinter";
8
+ import { ImportDictionary } from "./ImportDictionary";
9
+ import { SdkRouteDirectory } from "./SdkRouteDirectory";
10
+ import { SdkRouteProgrammer } from "./SdkRouteProgrammer";
11
+
12
+ export namespace SdkFileProgrammer {
13
+ /* ---------------------------------------------------------
14
+ CONSTRUCTOR
15
+ --------------------------------------------------------- */
16
+ export const generate =
17
+ (checker: ts.TypeChecker) =>
18
+ (config: INestiaConfig) =>
19
+ async (routeList: IRoute[]): Promise<void> => {
20
+ // CONSTRUCT FOLDER TREE
21
+ const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
22
+ for (const route of routeList) emplace(root)(route);
23
+
24
+ // ITERATE FILES
25
+ await iterate(checker)(config)(root)(config.output + "/functional");
26
+ };
27
+
28
+ const emplace =
29
+ (directory: SdkRouteDirectory) =>
30
+ (route: IRoute): void => {
31
+ // OPEN DIRECTORIES
32
+ for (const key of route.accessors.slice(0, -1)) {
33
+ directory = MapUtil.take(
34
+ directory.children,
35
+ key,
36
+ () => new SdkRouteDirectory(directory, key),
37
+ );
38
+ }
39
+
40
+ // ADD ROUTE
41
+ directory.routes.push(route);
42
+ };
43
+
44
+ /* ---------------------------------------------------------
45
+ FILE ITERATOR
46
+ --------------------------------------------------------- */
47
+ const iterate =
48
+ (checker: ts.TypeChecker) =>
49
+ (config: INestiaConfig) =>
50
+ (directory: SdkRouteDirectory) =>
51
+ async (outDir: string): Promise<void> => {
52
+ // CREATE A NEW DIRECTORY
53
+ try {
54
+ await fs.promises.mkdir(outDir);
55
+ } catch {}
56
+
57
+ // ITERATE CHILDREN
58
+ const statements: ts.Statement[] = [];
59
+ for (const [key, value] of directory.children) {
60
+ await iterate(checker)(config)(value)(`${outDir}/${key}`);
61
+ statements.push(
62
+ ts.factory.createExportDeclaration(
63
+ undefined,
64
+ false,
65
+ ts.factory.createNamespaceExport(ts.factory.createIdentifier(key)),
66
+ ts.factory.createStringLiteral(`./${key}`),
67
+ undefined,
68
+ ),
69
+ );
70
+ }
71
+ if (statements.length && directory.routes.length)
72
+ statements.push(FilePrinter.enter());
73
+
74
+ // ITERATE ROUTES
75
+ const importer: ImportDictionary = new ImportDictionary(
76
+ `${outDir}/index.ts`,
77
+ );
78
+ directory.routes.forEach((route, i) => {
79
+ if (config.clone !== true)
80
+ for (const tuple of route.imports)
81
+ for (const instance of tuple[1])
82
+ importer.internal({
83
+ file: tuple[0],
84
+ instance,
85
+ type: true,
86
+ });
87
+ statements.push(
88
+ ...SdkRouteProgrammer.generate(checker)(config)(importer)(route),
89
+ );
90
+ if (i !== directory.routes.length - 1)
91
+ statements.push(FilePrinter.enter());
92
+ });
93
+
94
+ // FINALIZE THE CONTENT
95
+ if (directory.routes.length !== 0)
96
+ statements.push(
97
+ ...importer.toStatements(outDir),
98
+ ...(!importer.empty() && statements.length
99
+ ? [FilePrinter.enter()]
100
+ : []),
101
+ ...statements.splice(0, statements.length),
102
+ );
103
+ await FilePrinter.write({
104
+ location: importer.file,
105
+ statements,
106
+ top:
107
+ "/**\n" +
108
+ " * @packageDocumentation\n" +
109
+ ` * @module ${directory.module}\n` +
110
+ " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
111
+ " */\n" +
112
+ "//================================================================\n",
113
+ });
114
+ };
115
+ }