@nestia/sdk 2.4.2 → 2.4.3

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 (111) hide show
  1. package/lib/NestiaSdkApplication.js +2 -6
  2. package/lib/NestiaSdkApplication.js.map +1 -1
  3. package/lib/analyses/AccessorAnalyzer.js.map +1 -1
  4. package/lib/analyses/ConfigAnalyzer.js +4 -8
  5. package/lib/analyses/ConfigAnalyzer.js.map +1 -1
  6. package/lib/analyses/ControllerAnalyzer.js +6 -8
  7. package/lib/analyses/ControllerAnalyzer.js.map +1 -1
  8. package/lib/analyses/ExceptionAnalyzer.js.map +1 -1
  9. package/lib/analyses/GenericAnalyzer.js +1 -2
  10. package/lib/analyses/GenericAnalyzer.js.map +1 -1
  11. package/lib/analyses/ImportAnalyzer.js +4 -4
  12. package/lib/analyses/ImportAnalyzer.js.map +1 -1
  13. package/lib/analyses/PathAnalyzer.js.map +1 -1
  14. package/lib/analyses/ReflectAnalyzer.js +7 -8
  15. package/lib/analyses/ReflectAnalyzer.js.map +1 -1
  16. package/lib/analyses/SecurityAnalyzer.js.map +1 -1
  17. package/lib/executable/internal/CommandParser.js.map +1 -1
  18. package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
  19. package/lib/executable/internal/NestiaSdkCommand.js.map +1 -1
  20. package/lib/executable/sdk.js +11 -11
  21. package/lib/executable/sdk.js.map +1 -1
  22. package/lib/generates/E2eGenerator.js.map +1 -1
  23. package/lib/generates/SdkGenerator.js.map +1 -1
  24. package/lib/generates/SwaggerGenerator.js +5 -11
  25. package/lib/generates/SwaggerGenerator.js.map +1 -1
  26. package/lib/generates/internal/E2eFileProgrammer.js +2 -8
  27. package/lib/generates/internal/E2eFileProgrammer.js.map +1 -1
  28. package/lib/generates/internal/SdkDistributionComposer.js.map +1 -1
  29. package/lib/generates/internal/SdkDtoGenerator.js +3 -9
  30. package/lib/generates/internal/SdkDtoGenerator.js.map +1 -1
  31. package/lib/generates/internal/SdkFileProgrammer.js +4 -4
  32. package/lib/generates/internal/SdkFileProgrammer.js.map +1 -1
  33. package/lib/generates/internal/SdkFunctionProgrammer.js +12 -20
  34. package/lib/generates/internal/SdkFunctionProgrammer.js.map +1 -1
  35. package/lib/generates/internal/SdkImportWizard.js.map +1 -1
  36. package/lib/generates/internal/SdkRouteDirectory.js +1 -3
  37. package/lib/generates/internal/SdkRouteDirectory.js.map +1 -1
  38. package/lib/generates/internal/SdkSimulationProgrammer.js +5 -7
  39. package/lib/generates/internal/SdkSimulationProgrammer.js.map +1 -1
  40. package/lib/generates/internal/SdkTypeDefiner.js +2 -5
  41. package/lib/generates/internal/SdkTypeDefiner.js.map +1 -1
  42. package/lib/generates/internal/SwaggerSchemaGenerator.js +29 -44
  43. package/lib/generates/internal/SwaggerSchemaGenerator.js.map +1 -1
  44. package/lib/generates/internal/SwaggerSchemaValidator.js +3 -9
  45. package/lib/generates/internal/SwaggerSchemaValidator.js.map +1 -1
  46. package/lib/structures/MethodType.js +1 -7
  47. package/lib/structures/MethodType.js.map +1 -1
  48. package/lib/structures/TypeEntry.js.map +1 -1
  49. package/lib/utils/ArrayUtil.js.map +1 -1
  50. package/lib/utils/FileRetriever.js.map +1 -1
  51. package/lib/utils/ImportDictionary.js +1 -4
  52. package/lib/utils/ImportDictionary.js.map +1 -1
  53. package/lib/utils/MapUtil.js.map +1 -1
  54. package/lib/utils/PathUtil.js.map +1 -1
  55. package/lib/utils/SourceFinder.js.map +1 -1
  56. package/package.json +4 -7
  57. package/src/INestiaConfig.ts +234 -234
  58. package/src/NestiaSdkApplication.ts +253 -268
  59. package/src/analyses/AccessorAnalyzer.ts +60 -60
  60. package/src/analyses/ConfigAnalyzer.ts +147 -164
  61. package/src/analyses/ControllerAnalyzer.ts +379 -399
  62. package/src/analyses/ExceptionAnalyzer.ts +115 -124
  63. package/src/analyses/GenericAnalyzer.ts +51 -57
  64. package/src/analyses/ImportAnalyzer.ts +138 -159
  65. package/src/analyses/PathAnalyzer.ts +98 -100
  66. package/src/analyses/ReflectAnalyzer.ts +425 -433
  67. package/src/analyses/SecurityAnalyzer.ts +20 -20
  68. package/src/executable/internal/CommandParser.ts +15 -15
  69. package/src/executable/internal/NestiaConfigLoader.ts +67 -68
  70. package/src/executable/internal/NestiaSdkCommand.ts +60 -64
  71. package/src/executable/sdk.ts +73 -73
  72. package/src/generates/E2eGenerator.ts +64 -67
  73. package/src/generates/SdkGenerator.ts +96 -100
  74. package/src/generates/SwaggerGenerator.ts +372 -410
  75. package/src/generates/internal/E2eFileProgrammer.ts +123 -129
  76. package/src/generates/internal/SdkDistributionComposer.ts +91 -91
  77. package/src/generates/internal/SdkDtoGenerator.ts +424 -450
  78. package/src/generates/internal/SdkFileProgrammer.ts +106 -111
  79. package/src/generates/internal/SdkFunctionProgrammer.ts +466 -501
  80. package/src/generates/internal/SdkImportWizard.ts +55 -55
  81. package/src/generates/internal/SdkRouteDirectory.ts +17 -19
  82. package/src/generates/internal/SdkSimulationProgrammer.ts +133 -142
  83. package/src/generates/internal/SdkTypeDefiner.ts +119 -124
  84. package/src/generates/internal/SwaggerSchemaGenerator.ts +382 -401
  85. package/src/generates/internal/SwaggerSchemaValidator.ts +198 -210
  86. package/src/index.ts +4 -4
  87. package/src/module.ts +2 -2
  88. package/src/structures/IController.ts +79 -81
  89. package/src/structures/IErrorReport.ts +6 -6
  90. package/src/structures/INestiaProject.ts +13 -13
  91. package/src/structures/INormalizedInput.ts +20 -20
  92. package/src/structures/IRoute.ts +40 -41
  93. package/src/structures/ISwagger.ts +91 -91
  94. package/src/structures/ISwaggerComponents.ts +29 -29
  95. package/src/structures/ISwaggerError.ts +8 -8
  96. package/src/structures/ISwaggerInfo.ts +80 -80
  97. package/src/structures/ISwaggerLazyProperty.ts +7 -7
  98. package/src/structures/ISwaggerLazySchema.ts +7 -7
  99. package/src/structures/ISwaggerRoute.ts +51 -51
  100. package/src/structures/ISwaggerSecurityScheme.ts +65 -65
  101. package/src/structures/ITypeTuple.ts +6 -6
  102. package/src/structures/MethodType.ts +5 -11
  103. package/src/structures/ParamCategory.ts +1 -1
  104. package/src/structures/TypeEntry.ts +22 -22
  105. package/src/utils/ArrayUtil.ts +26 -26
  106. package/src/utils/FileRetriever.ts +22 -22
  107. package/src/utils/ImportDictionary.ts +125 -128
  108. package/src/utils/MapUtil.ts +14 -14
  109. package/src/utils/PathUtil.ts +10 -10
  110. package/src/utils/SourceFinder.ts +66 -70
  111. package/src/utils/StripEnums.ts +5 -10
@@ -1,129 +1,123 @@
1
- import fs from "fs";
2
-
3
- import { INestiaConfig } from "../../INestiaConfig";
4
- import { IRoute } from "../../structures/IRoute";
5
- import { ImportDictionary } from "../../utils/ImportDictionary";
6
- import { SdkDtoGenerator } from "./SdkDtoGenerator";
7
- import { SdkImportWizard } from "./SdkImportWizard";
8
- import { SdkTypeDefiner } from "./SdkTypeDefiner";
9
-
10
- export namespace E2eFileProgrammer {
11
- export const generate =
12
- (config: INestiaConfig) =>
13
- (props: { api: string; current: string }) =>
14
- async (route: IRoute): Promise<void> => {
15
- const importer: ImportDictionary = new ImportDictionary(
16
- `${props.current}/${name(route)}.ts`,
17
- );
18
- if (config.clone !== true)
19
- for (const tuple of route.imports)
20
- for (const instance of tuple[1])
21
- importer.internal({
22
- file: tuple[0],
23
- type: true,
24
- instance,
25
- });
26
- importer.internal({
27
- type: false,
28
- file: props.api,
29
- instance: null,
30
- name: "api",
31
- });
32
-
33
- const body: string = arrow(config)(importer)(route);
34
- const content: string = [
35
- importer.toScript(props.current),
36
- "",
37
- body,
38
- ].join("\n");
39
-
40
- await fs.promises.writeFile(importer.file, content, "utf8");
41
- };
42
-
43
- const arrow =
44
- (config: INestiaConfig) =>
45
- (importer: ImportDictionary) =>
46
- (route: IRoute): string => {
47
- const tab: number = 2;
48
- const headers = route.parameters.find(
49
- (p) => p.category === "headers" && p.field === undefined,
50
- );
51
- const output = [
52
- `await ${accessor(route)}(`,
53
- headers !== undefined
54
- ? [
55
- "{",
56
- " ...connection,",
57
- " headers: {",
58
- " ...(connection.headers ?? {}),",
59
- ` ...${SdkImportWizard.typia(
60
- importer,
61
- )}.random<${getTypeName(config)(importer)(
62
- headers,
63
- )}>(),`,
64
- " },",
65
- "},",
66
- ]
67
- .map((line) => `${" ".repeat(tab * 4)}${line}`)
68
- .join("\n")
69
- : `${" ".repeat(tab * 4)}connection,`,
70
- ...route.parameters
71
- .filter((param) => param.category !== "headers")
72
- .map(parameter(config)(importer)(tab)),
73
- `${" ".repeat((tab - 1) * 4)});`,
74
- ].join("\n");
75
- return [
76
- `export const ${name(route)} = async (`,
77
- ` connection: api.IConnection`,
78
- `): Promise<void> => {`,
79
- ...(route.output.typeName === "void"
80
- ? [` ${output}`]
81
- : [
82
- ` const output: ${SdkTypeDefiner.output(config)(
83
- importer,
84
- )(route)} = ${output}`,
85
- ` ${SdkImportWizard.typia(
86
- importer,
87
- )}.assert(output);`,
88
- ]),
89
- `};`,
90
- ].join("\n");
91
- };
92
-
93
- const parameter =
94
- (config: INestiaConfig) =>
95
- (importer: ImportDictionary) =>
96
- (tab: number) =>
97
- (param: IRoute.IParameter): string => {
98
- const middle: string = `${SdkImportWizard.typia(
99
- importer,
100
- )}.random<${wrap(config)(importer)(
101
- getTypeName(config)(importer)(param),
102
- param.category === "body",
103
- )}>()`;
104
- return `${" ".repeat(4 * tab)}${middle},`;
105
- };
106
-
107
- const name = (route: IRoute): string =>
108
- ["test", "api", ...route.accessors].join("_");
109
-
110
- const accessor = (route: IRoute): string =>
111
- ["api", "functional", ...route.accessors].join(".");
112
-
113
- const wrap =
114
- (config: INestiaConfig) =>
115
- (importer: ImportDictionary) =>
116
- (name: string, body: boolean): string =>
117
- config.primitive === false
118
- ? name
119
- : `${(body
120
- ? SdkImportWizard.Primitive
121
- : SdkImportWizard.Resolved)(importer)}<${name}>`;
122
- }
123
- const getTypeName =
124
- (config: INestiaConfig) =>
125
- (importer: ImportDictionary) =>
126
- (p: IRoute.IParameter | IRoute.IOutput) =>
127
- p.metadata
128
- ? SdkDtoGenerator.decode(config)(importer)(p.metadata)
129
- : p.typeName;
1
+ import fs from "fs";
2
+
3
+ import { INestiaConfig } from "../../INestiaConfig";
4
+ import { IRoute } from "../../structures/IRoute";
5
+ import { ImportDictionary } from "../../utils/ImportDictionary";
6
+ import { SdkDtoGenerator } from "./SdkDtoGenerator";
7
+ import { SdkImportWizard } from "./SdkImportWizard";
8
+ import { SdkTypeDefiner } from "./SdkTypeDefiner";
9
+
10
+ export namespace E2eFileProgrammer {
11
+ export const generate =
12
+ (config: INestiaConfig) =>
13
+ (props: { api: string; current: string }) =>
14
+ async (route: IRoute): Promise<void> => {
15
+ const importer: ImportDictionary = new ImportDictionary(
16
+ `${props.current}/${name(route)}.ts`,
17
+ );
18
+ if (config.clone !== true)
19
+ for (const tuple of route.imports)
20
+ for (const instance of tuple[1])
21
+ importer.internal({
22
+ file: tuple[0],
23
+ type: true,
24
+ instance,
25
+ });
26
+ importer.internal({
27
+ type: false,
28
+ file: props.api,
29
+ instance: null,
30
+ name: "api",
31
+ });
32
+
33
+ const body: string = arrow(config)(importer)(route);
34
+ const content: string = [importer.toScript(props.current), "", body].join(
35
+ "\n",
36
+ );
37
+
38
+ await fs.promises.writeFile(importer.file, content, "utf8");
39
+ };
40
+
41
+ const arrow =
42
+ (config: INestiaConfig) =>
43
+ (importer: ImportDictionary) =>
44
+ (route: IRoute): string => {
45
+ const tab: number = 2;
46
+ const headers = route.parameters.find(
47
+ (p) => p.category === "headers" && p.field === undefined,
48
+ );
49
+ const output = [
50
+ `await ${accessor(route)}(`,
51
+ headers !== undefined
52
+ ? [
53
+ "{",
54
+ " ...connection,",
55
+ " headers: {",
56
+ " ...(connection.headers ?? {}),",
57
+ ` ...${SdkImportWizard.typia(
58
+ importer,
59
+ )}.random<${getTypeName(config)(importer)(headers)}>(),`,
60
+ " },",
61
+ "},",
62
+ ]
63
+ .map((line) => `${" ".repeat(tab * 4)}${line}`)
64
+ .join("\n")
65
+ : `${" ".repeat(tab * 4)}connection,`,
66
+ ...route.parameters
67
+ .filter((param) => param.category !== "headers")
68
+ .map(parameter(config)(importer)(tab)),
69
+ `${" ".repeat((tab - 1) * 4)});`,
70
+ ].join("\n");
71
+ return [
72
+ `export const ${name(route)} = async (`,
73
+ ` connection: api.IConnection`,
74
+ `): Promise<void> => {`,
75
+ ...(route.output.typeName === "void"
76
+ ? [` ${output}`]
77
+ : [
78
+ ` const output: ${SdkTypeDefiner.output(config)(importer)(
79
+ route,
80
+ )} = ${output}`,
81
+ ` ${SdkImportWizard.typia(importer)}.assert(output);`,
82
+ ]),
83
+ `};`,
84
+ ].join("\n");
85
+ };
86
+
87
+ const parameter =
88
+ (config: INestiaConfig) =>
89
+ (importer: ImportDictionary) =>
90
+ (tab: number) =>
91
+ (param: IRoute.IParameter): string => {
92
+ const middle: string = `${SdkImportWizard.typia(importer)}.random<${wrap(
93
+ config,
94
+ )(importer)(
95
+ getTypeName(config)(importer)(param),
96
+ param.category === "body",
97
+ )}>()`;
98
+ return `${" ".repeat(4 * tab)}${middle},`;
99
+ };
100
+
101
+ const name = (route: IRoute): string =>
102
+ ["test", "api", ...route.accessors].join("_");
103
+
104
+ const accessor = (route: IRoute): string =>
105
+ ["api", "functional", ...route.accessors].join(".");
106
+
107
+ const wrap =
108
+ (config: INestiaConfig) =>
109
+ (importer: ImportDictionary) =>
110
+ (name: string, body: boolean): string =>
111
+ config.primitive === false
112
+ ? name
113
+ : `${(body ? SdkImportWizard.Primitive : SdkImportWizard.Resolved)(
114
+ importer,
115
+ )}<${name}>`;
116
+ }
117
+ const getTypeName =
118
+ (config: INestiaConfig) =>
119
+ (importer: ImportDictionary) =>
120
+ (p: IRoute.IParameter | IRoute.IOutput) =>
121
+ p.metadata
122
+ ? SdkDtoGenerator.decode(config)(importer)(p.metadata)
123
+ : p.typeName;
@@ -1,91 +1,91 @@
1
- import cp from "child_process";
2
- import fs from "fs";
3
- import path from "path";
4
-
5
- import { INestiaConfig } from "../../INestiaConfig";
6
-
7
- export namespace SdkDistributionComposer {
8
- export const compose = async (config: INestiaConfig) => {
9
- if (!fs.existsSync(config.distribute!))
10
- await fs.promises.mkdir(config.distribute!);
11
-
12
- const root: string = process.cwd();
13
- const output: string = path.resolve(config.output!);
14
- process.chdir(config.distribute!);
15
-
16
- const exit = () => process.chdir(root);
17
- if (await configured()) return exit();
18
-
19
- // COPY FILES
20
- console.log("Composing SDK distribution environments...");
21
- for (const file of await fs.promises.readdir(BUNDLE))
22
- await fs.promises.copyFile(`${BUNDLE}/${file}`, file);
23
-
24
- // CONFIGURE PATHS
25
- for (const file of ["package.json", "tsconfig.json"])
26
- await replace({ root, output })(file);
27
-
28
- // INSTALL PACKAGES
29
- const versions: IDependencies = await dependencies();
30
- execute("npm install --save-dev rimraf");
31
- execute(
32
- `npm install --save @nestia/fetcher@${versions["@nestia/fetcher"]}`,
33
- );
34
- execute(`npm install --save typia@${versions["typia"]}`);
35
- execute("npx typia setup --manager npm");
36
-
37
- exit();
38
- };
39
-
40
- const configured = async (): Promise<boolean> =>
41
- ["package.json", "tsconfig.json"].every(fs.existsSync) &&
42
- (await (async () => {
43
- const content = JSON.parse(
44
- await fs.promises.readFile("package.json", "utf8"),
45
- );
46
- return !!content.dependencies?.["@nestia/fetcher"];
47
- })());
48
-
49
- const execute = (command: string) => {
50
- console.log(` - ${command}`);
51
- cp.execSync(command, { stdio: "ignore" });
52
- };
53
-
54
- const replace =
55
- (props: { root: string; output: string }) =>
56
- async (file: string): Promise<void> => {
57
- const relative = (from: string) => (to: string) =>
58
- path.relative(from, to).split("\\").join("/");
59
- const root: string = relative(process.cwd())(props.root);
60
- const output: string = relative(process.cwd())(props.output);
61
- const current: string = relative(props.root)(process.cwd());
62
-
63
- const content: string = await fs.promises.readFile(file, "utf8");
64
- await fs.promises.writeFile(
65
- file,
66
- content
67
- .split("${root}")
68
- .join(root)
69
- .split("${output}")
70
- .join(output)
71
- .split("${current}")
72
- .join(current),
73
- "utf8",
74
- );
75
- };
76
-
77
- const dependencies = async () => {
78
- const content: string = await fs.promises.readFile(
79
- __dirname + "/../../../package.json",
80
- "utf8",
81
- );
82
- const json: { dependencies: IDependencies } = JSON.parse(content);
83
- return json.dependencies;
84
- };
85
- }
86
-
87
- interface IDependencies {
88
- "@nestia/fetcher": string;
89
- typia: string;
90
- }
91
- const BUNDLE = __dirname + "/../../../assets/bundle/distribute";
1
+ import cp from "child_process";
2
+ import fs from "fs";
3
+ import path from "path";
4
+
5
+ import { INestiaConfig } from "../../INestiaConfig";
6
+
7
+ export namespace SdkDistributionComposer {
8
+ export const compose = async (config: INestiaConfig) => {
9
+ if (!fs.existsSync(config.distribute!))
10
+ await fs.promises.mkdir(config.distribute!);
11
+
12
+ const root: string = process.cwd();
13
+ const output: string = path.resolve(config.output!);
14
+ process.chdir(config.distribute!);
15
+
16
+ const exit = () => process.chdir(root);
17
+ if (await configured()) return exit();
18
+
19
+ // COPY FILES
20
+ console.log("Composing SDK distribution environments...");
21
+ for (const file of await fs.promises.readdir(BUNDLE))
22
+ await fs.promises.copyFile(`${BUNDLE}/${file}`, file);
23
+
24
+ // CONFIGURE PATHS
25
+ for (const file of ["package.json", "tsconfig.json"])
26
+ await replace({ root, output })(file);
27
+
28
+ // INSTALL PACKAGES
29
+ const versions: IDependencies = await dependencies();
30
+ execute("npm install --save-dev rimraf");
31
+ execute(
32
+ `npm install --save @nestia/fetcher@${versions["@nestia/fetcher"]}`,
33
+ );
34
+ execute(`npm install --save typia@${versions["typia"]}`);
35
+ execute("npx typia setup --manager npm");
36
+
37
+ exit();
38
+ };
39
+
40
+ const configured = async (): Promise<boolean> =>
41
+ ["package.json", "tsconfig.json"].every(fs.existsSync) &&
42
+ (await (async () => {
43
+ const content = JSON.parse(
44
+ await fs.promises.readFile("package.json", "utf8"),
45
+ );
46
+ return !!content.dependencies?.["@nestia/fetcher"];
47
+ })());
48
+
49
+ const execute = (command: string) => {
50
+ console.log(` - ${command}`);
51
+ cp.execSync(command, { stdio: "ignore" });
52
+ };
53
+
54
+ const replace =
55
+ (props: { root: string; output: string }) =>
56
+ async (file: string): Promise<void> => {
57
+ const relative = (from: string) => (to: string) =>
58
+ path.relative(from, to).split("\\").join("/");
59
+ const root: string = relative(process.cwd())(props.root);
60
+ const output: string = relative(process.cwd())(props.output);
61
+ const current: string = relative(props.root)(process.cwd());
62
+
63
+ const content: string = await fs.promises.readFile(file, "utf8");
64
+ await fs.promises.writeFile(
65
+ file,
66
+ content
67
+ .split("${root}")
68
+ .join(root)
69
+ .split("${output}")
70
+ .join(output)
71
+ .split("${current}")
72
+ .join(current),
73
+ "utf8",
74
+ );
75
+ };
76
+
77
+ const dependencies = async () => {
78
+ const content: string = await fs.promises.readFile(
79
+ __dirname + "/../../../package.json",
80
+ "utf8",
81
+ );
82
+ const json: { dependencies: IDependencies } = JSON.parse(content);
83
+ return json.dependencies;
84
+ };
85
+ }
86
+
87
+ interface IDependencies {
88
+ "@nestia/fetcher": string;
89
+ typia: string;
90
+ }
91
+ const BUNDLE = __dirname + "/../../../assets/bundle/distribute";