@nestia/sdk 2.6.3-dev.20240328 → 2.6.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 (31) hide show
  1. package/package.json +3 -3
  2. package/src/INestiaConfig.ts +248 -248
  3. package/src/NestiaSdkApplication.ts +255 -255
  4. package/src/analyses/ControllerAnalyzer.ts +402 -402
  5. package/src/analyses/ExceptionAnalyzer.ts +148 -148
  6. package/src/analyses/ReflectAnalyzer.ts +463 -463
  7. package/src/analyses/SecurityAnalyzer.ts +24 -24
  8. package/src/generates/CloneGenerator.ts +62 -62
  9. package/src/generates/E2eGenerator.ts +66 -66
  10. package/src/generates/SdkGenerator.ts +84 -84
  11. package/src/generates/SwaggerGenerator.ts +446 -446
  12. package/src/generates/internal/E2eFileProgrammer.ts +182 -182
  13. package/src/generates/internal/FilePrinter.ts +53 -53
  14. package/src/generates/internal/ImportDictionary.ts +147 -147
  15. package/src/generates/internal/SdkAliasCollection.ts +152 -152
  16. package/src/generates/internal/SdkCloneProgrammer.ts +155 -155
  17. package/src/generates/internal/SdkFileProgrammer.ts +115 -115
  18. package/src/generates/internal/SdkFunctionProgrammer.ts +298 -298
  19. package/src/generates/internal/SdkImportWizard.ts +55 -55
  20. package/src/generates/internal/SdkNamespaceProgrammer.ts +510 -510
  21. package/src/generates/internal/SdkRouteProgrammer.ts +83 -83
  22. package/src/generates/internal/SdkSimulationProgrammer.ts +365 -365
  23. package/src/generates/internal/SdkTypeProgrammer.ts +385 -385
  24. package/src/generates/internal/SwaggerSchemaGenerator.ts +438 -438
  25. package/src/structures/IController.ts +94 -94
  26. package/src/structures/IRoute.ts +53 -53
  27. package/src/structures/ISwagger.ts +91 -91
  28. package/src/structures/ISwaggerRoute.ts +54 -54
  29. package/src/structures/ISwaggerSecurityScheme.ts +65 -65
  30. package/src/structures/ParamCategory.ts +1 -1
  31. package/src/utils/StringUtil.ts +6 -6
@@ -1,24 +1,24 @@
1
- import { MapUtil } from "../utils/MapUtil";
2
-
3
- export namespace SecurityAnalyzer {
4
- const none = Symbol("none");
5
- export const merge = (...entire: Record<string, string[]>[]) => {
6
- const dict: Map<string | typeof none, Set<string>> = new Map();
7
- for (const obj of entire) {
8
- const entries = Object.entries(obj);
9
- for (const [key, value] of entries) {
10
- const set = MapUtil.take(dict, key, () => new Set());
11
- for (const val of value) set.add(val);
12
- }
13
- if (entries.length === 0) MapUtil.take(dict, none, () => new Set());
14
- }
15
- const output: Record<string, string[]>[] = [];
16
- for (const [key, set] of dict)
17
- key === none
18
- ? output.push({})
19
- : output.push({
20
- [key]: [...set],
21
- });
22
- return output;
23
- };
24
- }
1
+ import { MapUtil } from "../utils/MapUtil";
2
+
3
+ export namespace SecurityAnalyzer {
4
+ const none = Symbol("none");
5
+ export const merge = (...entire: Record<string, string[]>[]) => {
6
+ const dict: Map<string | typeof none, Set<string>> = new Map();
7
+ for (const obj of entire) {
8
+ const entries = Object.entries(obj);
9
+ for (const [key, value] of entries) {
10
+ const set = MapUtil.take(dict, key, () => new Set());
11
+ for (const val of value) set.add(val);
12
+ }
13
+ if (entries.length === 0) MapUtil.take(dict, none, () => new Set());
14
+ }
15
+ const output: Record<string, string[]>[] = [];
16
+ for (const [key, set] of dict)
17
+ key === none
18
+ ? output.push({})
19
+ : output.push({
20
+ [key]: [...set],
21
+ });
22
+ return output;
23
+ };
24
+ }
@@ -1,62 +1,62 @@
1
- import fs from "fs";
2
- import ts from "typescript";
3
-
4
- import { INestiaConfig } from "../INestiaConfig";
5
- import { IRoute } from "../structures/IRoute";
6
- import { FilePrinter } from "./internal/FilePrinter";
7
- import { ImportDictionary } from "./internal/ImportDictionary";
8
- import { SdkCloneProgrammer } from "./internal/SdkCloneProgrammer";
9
-
10
- export namespace CloneGenerator {
11
- export const write =
12
- (checker: ts.TypeChecker) =>
13
- (config: INestiaConfig) =>
14
- async (routes: IRoute[]): Promise<void> => {
15
- const dict: Map<string, SdkCloneProgrammer.IModule> =
16
- SdkCloneProgrammer.write(checker)(config)(routes);
17
- if (dict.size === 0) return;
18
- try {
19
- await fs.promises.mkdir(`${config.output}/structures`);
20
- } catch {}
21
- for (const [key, value] of dict) await writeDtoFile(config)(key, value);
22
- };
23
-
24
- const writeDtoFile =
25
- (config: INestiaConfig) =>
26
- async (key: string, value: SdkCloneProgrammer.IModule): Promise<void> => {
27
- const location: string = `${config.output}/structures/${key}.ts`;
28
- const importer: ImportDictionary = new ImportDictionary(location);
29
- const statements: ts.Statement[] = iterate(importer)(value);
30
- if (statements.length === 0) return;
31
-
32
- await FilePrinter.write({
33
- location,
34
- statements: [
35
- ...importer.toStatements(`${config.output}/structures`),
36
- ...(importer.empty() ? [] : [FilePrinter.enter()]),
37
- ...statements,
38
- ],
39
- });
40
- };
41
-
42
- const iterate =
43
- (importer: ImportDictionary) =>
44
- (modulo: SdkCloneProgrammer.IModule): ts.Statement[] => {
45
- const output: ts.Statement[] = [];
46
- if (modulo.programmer !== null) output.push(modulo.programmer(importer));
47
- if (modulo.children.size) {
48
- const internal: ts.Statement[] = [];
49
- for (const child of modulo.children.values())
50
- internal.push(...iterate(importer)(child));
51
- output.push(
52
- ts.factory.createModuleDeclaration(
53
- [ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
54
- ts.factory.createIdentifier(modulo.name),
55
- ts.factory.createModuleBlock(internal),
56
- ts.NodeFlags.Namespace,
57
- ),
58
- );
59
- }
60
- return output;
61
- };
62
- }
1
+ import fs from "fs";
2
+ import ts from "typescript";
3
+
4
+ import { INestiaConfig } from "../INestiaConfig";
5
+ import { IRoute } from "../structures/IRoute";
6
+ import { FilePrinter } from "./internal/FilePrinter";
7
+ import { ImportDictionary } from "./internal/ImportDictionary";
8
+ import { SdkCloneProgrammer } from "./internal/SdkCloneProgrammer";
9
+
10
+ export namespace CloneGenerator {
11
+ export const write =
12
+ (checker: ts.TypeChecker) =>
13
+ (config: INestiaConfig) =>
14
+ async (routes: IRoute[]): Promise<void> => {
15
+ const dict: Map<string, SdkCloneProgrammer.IModule> =
16
+ SdkCloneProgrammer.write(checker)(config)(routes);
17
+ if (dict.size === 0) return;
18
+ try {
19
+ await fs.promises.mkdir(`${config.output}/structures`);
20
+ } catch {}
21
+ for (const [key, value] of dict) await writeDtoFile(config)(key, value);
22
+ };
23
+
24
+ const writeDtoFile =
25
+ (config: INestiaConfig) =>
26
+ async (key: string, value: SdkCloneProgrammer.IModule): Promise<void> => {
27
+ const location: string = `${config.output}/structures/${key}.ts`;
28
+ const importer: ImportDictionary = new ImportDictionary(location);
29
+ const statements: ts.Statement[] = iterate(importer)(value);
30
+ if (statements.length === 0) return;
31
+
32
+ await FilePrinter.write({
33
+ location,
34
+ statements: [
35
+ ...importer.toStatements(`${config.output}/structures`),
36
+ ...(importer.empty() ? [] : [FilePrinter.enter()]),
37
+ ...statements,
38
+ ],
39
+ });
40
+ };
41
+
42
+ const iterate =
43
+ (importer: ImportDictionary) =>
44
+ (modulo: SdkCloneProgrammer.IModule): ts.Statement[] => {
45
+ const output: ts.Statement[] = [];
46
+ if (modulo.programmer !== null) output.push(modulo.programmer(importer));
47
+ if (modulo.children.size) {
48
+ const internal: ts.Statement[] = [];
49
+ for (const child of modulo.children.values())
50
+ internal.push(...iterate(importer)(child));
51
+ output.push(
52
+ ts.factory.createModuleDeclaration(
53
+ [ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
54
+ ts.factory.createIdentifier(modulo.name),
55
+ ts.factory.createModuleBlock(internal),
56
+ ts.NodeFlags.Namespace,
57
+ ),
58
+ );
59
+ }
60
+ return output;
61
+ };
62
+ }
@@ -1,66 +1,66 @@
1
- import fs from "fs";
2
- import path from "path";
3
- import ts from "typescript";
4
-
5
- import { INestiaConfig } from "../INestiaConfig";
6
- import { ConfigAnalyzer } from "../analyses/ConfigAnalyzer";
7
- import { IRoute } from "../structures/IRoute";
8
- import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
9
-
10
- export namespace E2eGenerator {
11
- export const generate =
12
- (checker: ts.TypeChecker) =>
13
- (config: INestiaConfig) =>
14
- async (routeList: IRoute[]): Promise<void> => {
15
- console.log("Generating E2E Test Functions");
16
-
17
- // PREPARE DIRECTORIES
18
- const output: string = path.resolve(config.e2e!);
19
- await mkdir(output);
20
- await mkdir(path.join(output, "features"));
21
- await mkdir(path.join(output, "features", "api"));
22
- await mkdir(path.join(output, "features", "api", "automated"));
23
-
24
- // GENERATE TEST INDEX FILE
25
- await index(config)(path.join(config.e2e!, "index.ts"));
26
-
27
- // GENERATE EACH TEST FILES
28
- for (const route of routeList)
29
- await E2eFileProgrammer.generate(checker)(config)({
30
- api: path.resolve(config.output!),
31
- current: path.join(output, "features", "api", "automated"),
32
- })(route);
33
- };
34
-
35
- const index =
36
- (config: INestiaConfig) =>
37
- async (output: string): Promise<void> => {
38
- if (fs.existsSync(output)) return;
39
-
40
- const location: string = path.join(
41
- __dirname,
42
- "..",
43
- "..",
44
- "assets",
45
- "bundle",
46
- "e2e",
47
- "index.ts",
48
- );
49
- const content: string = await fs.promises.readFile(location, "utf8");
50
-
51
- await fs.promises.writeFile(
52
- output,
53
- content.replace(
54
- "${input}",
55
- JSON.stringify(await ConfigAnalyzer.input(config)),
56
- ),
57
- "utf8",
58
- );
59
- };
60
- }
61
-
62
- const mkdir = async (location: string): Promise<void> => {
63
- try {
64
- await fs.promises.mkdir(location);
65
- } catch {}
66
- };
1
+ import fs from "fs";
2
+ import path from "path";
3
+ import ts from "typescript";
4
+
5
+ import { INestiaConfig } from "../INestiaConfig";
6
+ import { ConfigAnalyzer } from "../analyses/ConfigAnalyzer";
7
+ import { IRoute } from "../structures/IRoute";
8
+ import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
9
+
10
+ export namespace E2eGenerator {
11
+ export const generate =
12
+ (checker: ts.TypeChecker) =>
13
+ (config: INestiaConfig) =>
14
+ async (routeList: IRoute[]): Promise<void> => {
15
+ console.log("Generating E2E Test Functions");
16
+
17
+ // PREPARE DIRECTORIES
18
+ const output: string = path.resolve(config.e2e!);
19
+ await mkdir(output);
20
+ await mkdir(path.join(output, "features"));
21
+ await mkdir(path.join(output, "features", "api"));
22
+ await mkdir(path.join(output, "features", "api", "automated"));
23
+
24
+ // GENERATE TEST INDEX FILE
25
+ await index(config)(path.join(config.e2e!, "index.ts"));
26
+
27
+ // GENERATE EACH TEST FILES
28
+ for (const route of routeList)
29
+ await E2eFileProgrammer.generate(checker)(config)({
30
+ api: path.resolve(config.output!),
31
+ current: path.join(output, "features", "api", "automated"),
32
+ })(route);
33
+ };
34
+
35
+ const index =
36
+ (config: INestiaConfig) =>
37
+ async (output: string): Promise<void> => {
38
+ if (fs.existsSync(output)) return;
39
+
40
+ const location: string = path.join(
41
+ __dirname,
42
+ "..",
43
+ "..",
44
+ "assets",
45
+ "bundle",
46
+ "e2e",
47
+ "index.ts",
48
+ );
49
+ const content: string = await fs.promises.readFile(location, "utf8");
50
+
51
+ await fs.promises.writeFile(
52
+ output,
53
+ content.replace(
54
+ "${input}",
55
+ JSON.stringify(await ConfigAnalyzer.input(config)),
56
+ ),
57
+ "utf8",
58
+ );
59
+ };
60
+ }
61
+
62
+ const mkdir = async (location: string): Promise<void> => {
63
+ try {
64
+ await fs.promises.mkdir(location);
65
+ } catch {}
66
+ };
@@ -1,84 +1,84 @@
1
- import fs from "fs";
2
- import NodePath from "path";
3
- import { IPointer } from "tstl";
4
- import ts from "typescript";
5
-
6
- import { INestiaConfig } from "../INestiaConfig";
7
- import { IRoute } from "../structures/IRoute";
8
- import { CloneGenerator } from "./CloneGenerator";
9
- import { SdkDistributionComposer } from "./internal/SdkDistributionComposer";
10
- import { SdkFileProgrammer } from "./internal/SdkFileProgrammer";
11
-
12
- export namespace SdkGenerator {
13
- export const generate =
14
- (checker: ts.TypeChecker) =>
15
- (config: INestiaConfig) =>
16
- async (routes: IRoute[]): Promise<void> => {
17
- console.log("Generating SDK Library");
18
-
19
- // PREPARE NEW DIRECTORIES
20
- try {
21
- await fs.promises.mkdir(config.output!);
22
- } catch {}
23
-
24
- // BUNDLING
25
- const bundle: string[] = await fs.promises.readdir(BUNDLE_PATH);
26
- for (const file of bundle) {
27
- const current: string = `${BUNDLE_PATH}/${file}`;
28
- const target: string = `${config.output}/${file}`;
29
- const stats: fs.Stats = await fs.promises.stat(current);
30
-
31
- if (stats.isFile() === true) {
32
- const content: string = await fs.promises.readFile(current, "utf8");
33
- if (fs.existsSync(target) === false)
34
- await fs.promises.writeFile(target, content, "utf8");
35
- else if (BUNDLE_CHANGES[file] !== undefined) {
36
- const r: IPointer<string> = {
37
- value: await fs.promises.readFile(target, "utf8"),
38
- };
39
- for (const [before, after] of BUNDLE_CHANGES[file])
40
- r.value = r.value.replace(before, after);
41
- await fs.promises.writeFile(target, r.value, "utf8");
42
- }
43
- }
44
- }
45
-
46
- // STRUCTURES
47
- if (config.clone) await CloneGenerator.write(checker)(config)(routes);
48
-
49
- // FUNCTIONAL
50
- await SdkFileProgrammer.generate(checker)(config)(routes);
51
-
52
- // DISTRIBUTION
53
- if (config.distribute !== undefined)
54
- await SdkDistributionComposer.compose(config);
55
- };
56
-
57
- export const BUNDLE_PATH = NodePath.join(
58
- __dirname,
59
- "..",
60
- "..",
61
- "assets",
62
- "bundle",
63
- "api",
64
- );
65
- }
66
-
67
- const BUNDLE_CHANGES: Record<string, [string, string][]> = {
68
- "IConnection.ts": [
69
- [
70
- `export { IConnection } from "@nestia/fetcher"`,
71
- `export type { IConnection } from "@nestia/fetcher"`,
72
- ],
73
- ],
74
- "module.ts": [
75
- [`export * from "./IConnection"`, `export type * from "./IConnection"`],
76
- [`export * from "./Primitive"`, `export type * from "./Primitive"`],
77
- ],
78
- "Primitive.ts": [
79
- [
80
- `export { Primitive } from "@nestia/fetcher"`,
81
- `export type { Primitive } from "@nestia/fetcher"`,
82
- ],
83
- ],
84
- };
1
+ import fs from "fs";
2
+ import NodePath from "path";
3
+ import { IPointer } from "tstl";
4
+ import ts from "typescript";
5
+
6
+ import { INestiaConfig } from "../INestiaConfig";
7
+ import { IRoute } from "../structures/IRoute";
8
+ import { CloneGenerator } from "./CloneGenerator";
9
+ import { SdkDistributionComposer } from "./internal/SdkDistributionComposer";
10
+ import { SdkFileProgrammer } from "./internal/SdkFileProgrammer";
11
+
12
+ export namespace SdkGenerator {
13
+ export const generate =
14
+ (checker: ts.TypeChecker) =>
15
+ (config: INestiaConfig) =>
16
+ async (routes: IRoute[]): Promise<void> => {
17
+ console.log("Generating SDK Library");
18
+
19
+ // PREPARE NEW DIRECTORIES
20
+ try {
21
+ await fs.promises.mkdir(config.output!);
22
+ } catch {}
23
+
24
+ // BUNDLING
25
+ const bundle: string[] = await fs.promises.readdir(BUNDLE_PATH);
26
+ for (const file of bundle) {
27
+ const current: string = `${BUNDLE_PATH}/${file}`;
28
+ const target: string = `${config.output}/${file}`;
29
+ const stats: fs.Stats = await fs.promises.stat(current);
30
+
31
+ if (stats.isFile() === true) {
32
+ const content: string = await fs.promises.readFile(current, "utf8");
33
+ if (fs.existsSync(target) === false)
34
+ await fs.promises.writeFile(target, content, "utf8");
35
+ else if (BUNDLE_CHANGES[file] !== undefined) {
36
+ const r: IPointer<string> = {
37
+ value: await fs.promises.readFile(target, "utf8"),
38
+ };
39
+ for (const [before, after] of BUNDLE_CHANGES[file])
40
+ r.value = r.value.replace(before, after);
41
+ await fs.promises.writeFile(target, r.value, "utf8");
42
+ }
43
+ }
44
+ }
45
+
46
+ // STRUCTURES
47
+ if (config.clone) await CloneGenerator.write(checker)(config)(routes);
48
+
49
+ // FUNCTIONAL
50
+ await SdkFileProgrammer.generate(checker)(config)(routes);
51
+
52
+ // DISTRIBUTION
53
+ if (config.distribute !== undefined)
54
+ await SdkDistributionComposer.compose(config);
55
+ };
56
+
57
+ export const BUNDLE_PATH = NodePath.join(
58
+ __dirname,
59
+ "..",
60
+ "..",
61
+ "assets",
62
+ "bundle",
63
+ "api",
64
+ );
65
+ }
66
+
67
+ const BUNDLE_CHANGES: Record<string, [string, string][]> = {
68
+ "IConnection.ts": [
69
+ [
70
+ `export { IConnection } from "@nestia/fetcher"`,
71
+ `export type { IConnection } from "@nestia/fetcher"`,
72
+ ],
73
+ ],
74
+ "module.ts": [
75
+ [`export * from "./IConnection"`, `export type * from "./IConnection"`],
76
+ [`export * from "./Primitive"`, `export type * from "./Primitive"`],
77
+ ],
78
+ "Primitive.ts": [
79
+ [
80
+ `export { Primitive } from "@nestia/fetcher"`,
81
+ `export type { Primitive } from "@nestia/fetcher"`,
82
+ ],
83
+ ],
84
+ };