@nestia/sdk 11.0.0-dev.20260316 → 11.0.1
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/LICENSE +21 -21
- package/README.md +93 -93
- package/assets/bundle/api/HttpError.ts +1 -1
- package/assets/bundle/api/IConnection.ts +1 -1
- package/assets/bundle/api/Primitive.ts +1 -1
- package/assets/bundle/api/Resolved.ts +1 -1
- package/assets/bundle/api/index.ts +4 -4
- package/assets/bundle/api/module.ts +6 -6
- package/assets/bundle/distribute/README.md +37 -37
- package/assets/bundle/distribute/package.json +28 -28
- package/assets/bundle/distribute/tsconfig.json +109 -109
- package/assets/bundle/e2e/index.ts +42 -42
- package/assets/config/nestia.config.ts +97 -97
- package/lib/executable/internal/NestiaConfigLoader.js +5 -5
- package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
- package/package.json +8 -8
- package/src/INestiaConfig.ts +267 -267
- package/src/NestiaSdkApplication.ts +307 -307
- package/src/NestiaSwaggerComposer.ts +143 -143
- package/src/analyses/AccessorAnalyzer.ts +67 -67
- package/src/analyses/DtoAnalyzer.ts +260 -260
- package/src/analyses/ImportAnalyzer.ts +126 -126
- package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
- package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +72 -72
- package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +350 -350
- package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +126 -126
- package/src/analyses/TypedHttpRouteAnalyzer.ts +208 -208
- package/src/executable/internal/NestiaConfigLoader.ts +85 -85
- package/src/executable/internal/NestiaSdkCommand.ts +107 -107
- package/src/generates/SwaggerGenerator.ts +291 -291
- package/src/generates/internal/E2eFileProgrammer.ts +196 -196
- package/src/generates/internal/FilePrinter.ts +64 -64
- package/src/generates/internal/ImportDictionary.ts +192 -192
- package/src/generates/internal/SdkAliasCollection.ts +260 -260
- package/src/generates/internal/SdkFileProgrammer.ts +110 -110
- package/src/generates/internal/SdkHttpCloneProgrammer.ts +126 -126
- package/src/generates/internal/SdkHttpCloneReferencer.ts +77 -77
- package/src/generates/internal/SdkHttpFunctionProgrammer.ts +278 -278
- package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +502 -502
- package/src/generates/internal/SdkHttpRouteProgrammer.ts +109 -109
- package/src/generates/internal/SdkHttpSimulationProgrammer.ts +312 -312
- package/src/generates/internal/SdkImportWizard.ts +62 -62
- package/src/generates/internal/SdkTypeProgrammer.ts +388 -388
- package/src/generates/internal/SdkTypeTagProgrammer.ts +114 -114
- package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +379 -379
- package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +302 -302
- package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
- package/src/generates/internal/SwaggerOperationParameterComposer.ts +161 -161
- package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
- package/src/module.ts +4 -4
- package/src/structures/IReflectHttpOperationException.ts +18 -18
- package/src/structures/IReflectHttpOperationParameter.ts +79 -79
- package/src/structures/IReflectHttpOperationSuccess.ts +21 -21
- package/src/structures/ITypedApplication.ts +11 -11
- package/src/structures/ITypedHttpRouteException.ts +15 -15
- package/src/structures/ITypedHttpRouteParameter.ts +41 -41
- package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
- package/src/transformers/IOperationMetadata.ts +46 -46
- package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
- package/src/transformers/SdkOperationProgrammer.ts +240 -240
- package/src/transformers/SdkOperationTransformer.ts +248 -248
- package/src/transformers/TextPlainValidator.ts +17 -17
- package/src/utils/MetadataUtil.ts +26 -26
- package/src/validators/HttpHeadersValidator.ts +40 -40
- package/src/validators/HttpQueryValidator.ts +40 -40
|
@@ -1,85 +1,85 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import fs from "fs";
|
|
3
|
-
import path from "path";
|
|
4
|
-
import { register } from "ts-node";
|
|
5
|
-
import { parse } from "tsconfck";
|
|
6
|
-
import ts from "typescript";
|
|
7
|
-
import typia from "typia";
|
|
8
|
-
|
|
9
|
-
import { INestiaConfig } from "../../INestiaConfig";
|
|
10
|
-
|
|
11
|
-
export namespace NestiaConfigLoader {
|
|
12
|
-
export const compilerOptions = async (
|
|
13
|
-
project: string,
|
|
14
|
-
): Promise<ts.ParsedCommandLine> => {
|
|
15
|
-
const configFileName = ts.findConfigFile(
|
|
16
|
-
process.cwd(),
|
|
17
|
-
ts.sys.fileExists,
|
|
18
|
-
project,
|
|
19
|
-
);
|
|
20
|
-
if (!configFileName) throw new Error(`unable to find "${project}" file.`);
|
|
21
|
-
const { tsconfig } = await parse(configFileName);
|
|
22
|
-
const configFileText = JSON.stringify(tsconfig);
|
|
23
|
-
const { config } = ts.parseConfigFileTextToJson(
|
|
24
|
-
configFileName,
|
|
25
|
-
configFileText,
|
|
26
|
-
);
|
|
27
|
-
return ts.parseJsonConfigFileContent(
|
|
28
|
-
config,
|
|
29
|
-
ts.sys,
|
|
30
|
-
path.dirname(configFileName),
|
|
31
|
-
);
|
|
32
|
-
};
|
|
33
|
-
|
|
34
|
-
export const configurations = async (
|
|
35
|
-
file: string,
|
|
36
|
-
compilerOptions: Record<string, any>,
|
|
37
|
-
): Promise<INestiaConfig[]> => {
|
|
38
|
-
if (fs.existsSync(path.resolve(file)) === false)
|
|
39
|
-
throw new Error(`Unable to find "${file}" file.`);
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
const setup: boolean = typia
|
|
44
|
-
.assert<object[]>(compilerOptions.plugins ?? [])
|
|
45
|
-
.some(
|
|
46
|
-
(x: any) =>
|
|
47
|
-
x.transform === "@nestia/sdk/lib/transform" ||
|
|
48
|
-
x.transform === "@nestia/sdk/src/transform.ts",
|
|
49
|
-
);
|
|
50
|
-
const plugins: any[] = [
|
|
51
|
-
...(compilerOptions.plugins ?? []),
|
|
52
|
-
...(setup ? [] : [{ transform: "@nestia/sdk/lib/transform" }]),
|
|
53
|
-
];
|
|
54
|
-
if (!(process as any)[Symbol.for("ts-node.register.instance")])
|
|
55
|
-
register({
|
|
56
|
-
emit: false,
|
|
57
|
-
compilerOptions: {
|
|
58
|
-
...compilerOptions,
|
|
59
|
-
plugins,
|
|
60
|
-
},
|
|
61
|
-
require: compilerOptions.baseUrl
|
|
62
|
-
? ["tsconfig-paths/register"]
|
|
63
|
-
: undefined,
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
const loaded: (INestiaConfig | INestiaConfig[]) & {
|
|
67
|
-
default?: INestiaConfig | INestiaConfig[];
|
|
68
|
-
} = await import(path.resolve(file));
|
|
69
|
-
const instance: INestiaConfig | INestiaConfig[] =
|
|
70
|
-
typeof loaded?.default === "object" && loaded.default !== null
|
|
71
|
-
? loaded.default
|
|
72
|
-
: loaded;
|
|
73
|
-
const configurations: INestiaConfig[] = Array.isArray(instance)
|
|
74
|
-
? instance
|
|
75
|
-
: [instance];
|
|
76
|
-
|
|
77
|
-
try {
|
|
78
|
-
return typia.assert(configurations);
|
|
79
|
-
} catch (exp) {
|
|
80
|
-
if (typia.is<typia.TypeGuardError>(exp))
|
|
81
|
-
exp.message = `invalid "${file}" data.`;
|
|
82
|
-
throw exp;
|
|
83
|
-
}
|
|
84
|
-
};
|
|
85
|
-
}
|
|
1
|
+
import { doNotThrowTransformError } from "@nestia/core";
|
|
2
|
+
import fs from "fs";
|
|
3
|
+
import path from "path";
|
|
4
|
+
import { register } from "ts-node";
|
|
5
|
+
import { parse } from "tsconfck";
|
|
6
|
+
import ts from "typescript";
|
|
7
|
+
import typia from "typia";
|
|
8
|
+
|
|
9
|
+
import { INestiaConfig } from "../../INestiaConfig";
|
|
10
|
+
|
|
11
|
+
export namespace NestiaConfigLoader {
|
|
12
|
+
export const compilerOptions = async (
|
|
13
|
+
project: string,
|
|
14
|
+
): Promise<ts.ParsedCommandLine> => {
|
|
15
|
+
const configFileName = ts.findConfigFile(
|
|
16
|
+
process.cwd(),
|
|
17
|
+
ts.sys.fileExists,
|
|
18
|
+
project,
|
|
19
|
+
);
|
|
20
|
+
if (!configFileName) throw new Error(`unable to find "${project}" file.`);
|
|
21
|
+
const { tsconfig } = await parse(configFileName);
|
|
22
|
+
const configFileText = JSON.stringify(tsconfig);
|
|
23
|
+
const { config } = ts.parseConfigFileTextToJson(
|
|
24
|
+
configFileName,
|
|
25
|
+
configFileText,
|
|
26
|
+
);
|
|
27
|
+
return ts.parseJsonConfigFileContent(
|
|
28
|
+
config,
|
|
29
|
+
ts.sys,
|
|
30
|
+
path.dirname(configFileName),
|
|
31
|
+
);
|
|
32
|
+
};
|
|
33
|
+
|
|
34
|
+
export const configurations = async (
|
|
35
|
+
file: string,
|
|
36
|
+
compilerOptions: Record<string, any>,
|
|
37
|
+
): Promise<INestiaConfig[]> => {
|
|
38
|
+
if (fs.existsSync(path.resolve(file)) === false)
|
|
39
|
+
throw new Error(`Unable to find "${file}" file.`);
|
|
40
|
+
|
|
41
|
+
doNotThrowTransformError(true);
|
|
42
|
+
|
|
43
|
+
const setup: boolean = typia
|
|
44
|
+
.assert<object[]>(compilerOptions.plugins ?? [])
|
|
45
|
+
.some(
|
|
46
|
+
(x: any) =>
|
|
47
|
+
x.transform === "@nestia/sdk/lib/transform" ||
|
|
48
|
+
x.transform === "@nestia/sdk/src/transform.ts",
|
|
49
|
+
);
|
|
50
|
+
const plugins: any[] = [
|
|
51
|
+
...(compilerOptions.plugins ?? []),
|
|
52
|
+
...(setup ? [] : [{ transform: "@nestia/sdk/lib/transform" }]),
|
|
53
|
+
];
|
|
54
|
+
if (!(process as any)[Symbol.for("ts-node.register.instance")])
|
|
55
|
+
register({
|
|
56
|
+
emit: false,
|
|
57
|
+
compilerOptions: {
|
|
58
|
+
...compilerOptions,
|
|
59
|
+
plugins,
|
|
60
|
+
},
|
|
61
|
+
require: compilerOptions.baseUrl
|
|
62
|
+
? ["tsconfig-paths/register"]
|
|
63
|
+
: undefined,
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
const loaded: (INestiaConfig | INestiaConfig[]) & {
|
|
67
|
+
default?: INestiaConfig | INestiaConfig[];
|
|
68
|
+
} = await import(path.resolve(file));
|
|
69
|
+
const instance: INestiaConfig | INestiaConfig[] =
|
|
70
|
+
typeof loaded?.default === "object" && loaded.default !== null
|
|
71
|
+
? loaded.default
|
|
72
|
+
: loaded;
|
|
73
|
+
const configurations: INestiaConfig[] = Array.isArray(instance)
|
|
74
|
+
? instance
|
|
75
|
+
: [instance];
|
|
76
|
+
|
|
77
|
+
try {
|
|
78
|
+
return typia.assert(configurations);
|
|
79
|
+
} catch (exp) {
|
|
80
|
+
if (typia.is<typia.TypeGuardError>(exp))
|
|
81
|
+
exp.message = `invalid "${file}" data.`;
|
|
82
|
+
throw exp;
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
}
|
|
@@ -1,107 +1,107 @@
|
|
|
1
|
-
import ts from "typescript";
|
|
2
|
-
|
|
3
|
-
import { INestiaConfig } from "../../INestiaConfig";
|
|
4
|
-
import { NestiaSdkApplication } from "../../NestiaSdkApplication";
|
|
5
|
-
import { NestiaConfigLoader } from "./NestiaConfigLoader";
|
|
6
|
-
|
|
7
|
-
export namespace NestiaSdkCommand {
|
|
8
|
-
export const sdk = () =>
|
|
9
|
-
main({
|
|
10
|
-
title: "SDK library",
|
|
11
|
-
generate: (app) => app.sdk(),
|
|
12
|
-
validate: (config) => !!config.output,
|
|
13
|
-
solution: "configure INestiaConfig.output property.",
|
|
14
|
-
});
|
|
15
|
-
|
|
16
|
-
export const swagger = () =>
|
|
17
|
-
main({
|
|
18
|
-
title: "Swagger Document",
|
|
19
|
-
generate: (app) => app.swagger(),
|
|
20
|
-
validate: (config) => !!config.swagger?.output,
|
|
21
|
-
solution: "configure INestiaConfig.swagger property.",
|
|
22
|
-
});
|
|
23
|
-
|
|
24
|
-
export const e2e = () =>
|
|
25
|
-
main({
|
|
26
|
-
title: "E2E Functions",
|
|
27
|
-
generate: (app) => app.e2e(),
|
|
28
|
-
validate: (config) => !!config.e2e,
|
|
29
|
-
solution: [
|
|
30
|
-
"configure two properties:",
|
|
31
|
-
"",
|
|
32
|
-
" - INestiaConfig.output",
|
|
33
|
-
" - INestiaConfig.e2e",
|
|
34
|
-
].join("\n"),
|
|
35
|
-
});
|
|
36
|
-
|
|
37
|
-
export const all = () =>
|
|
38
|
-
main({
|
|
39
|
-
title: "everything",
|
|
40
|
-
generate: (app) => app.all(),
|
|
41
|
-
validate: () => true,
|
|
42
|
-
solution: [
|
|
43
|
-
"configure at least one property of below:",
|
|
44
|
-
"",
|
|
45
|
-
" - INestiaConfig.output",
|
|
46
|
-
" - INestiaConfig.swagger.output",
|
|
47
|
-
].join("\n"),
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
const main = async (props: {
|
|
51
|
-
title: string;
|
|
52
|
-
solution: string;
|
|
53
|
-
generate: (app: NestiaSdkApplication) => Promise<void>;
|
|
54
|
-
validate: (config: INestiaConfig) => boolean;
|
|
55
|
-
}) => {
|
|
56
|
-
// LOAD CONFIG INFO
|
|
57
|
-
const command: ts.ParsedCommandLine =
|
|
58
|
-
await NestiaConfigLoader.compilerOptions(
|
|
59
|
-
getFileArgument({
|
|
60
|
-
type: "project",
|
|
61
|
-
extension: "json",
|
|
62
|
-
}) ?? "tsconfig.json",
|
|
63
|
-
);
|
|
64
|
-
|
|
65
|
-
const configurations: INestiaConfig[] =
|
|
66
|
-
await NestiaConfigLoader.configurations(
|
|
67
|
-
getFileArgument({
|
|
68
|
-
type: "config",
|
|
69
|
-
extension: "ts",
|
|
70
|
-
}) ?? "nestia.config.ts",
|
|
71
|
-
command.raw.compilerOptions,
|
|
72
|
-
);
|
|
73
|
-
|
|
74
|
-
// GENERATE
|
|
75
|
-
if (
|
|
76
|
-
configurations.length > 1 &&
|
|
77
|
-
configurations.some(props.validate) === false
|
|
78
|
-
)
|
|
79
|
-
throw new Error(
|
|
80
|
-
`Every configurations are invalid to generate ${props.title}, ${props.solution}`,
|
|
81
|
-
);
|
|
82
|
-
for (const config of configurations) {
|
|
83
|
-
if (configurations.length > 1 && props.validate(config) === false)
|
|
84
|
-
continue;
|
|
85
|
-
const app: NestiaSdkApplication = new NestiaSdkApplication(config);
|
|
86
|
-
await props.generate(app);
|
|
87
|
-
}
|
|
88
|
-
};
|
|
89
|
-
|
|
90
|
-
const getFileArgument = (props: {
|
|
91
|
-
type: string;
|
|
92
|
-
extension: string;
|
|
93
|
-
}): string | null => {
|
|
94
|
-
const argv: string[] = process.argv.slice(3);
|
|
95
|
-
if (argv.length === 0) return null;
|
|
96
|
-
|
|
97
|
-
const index: number = argv.findIndex((str) => str === `--${props.type}`);
|
|
98
|
-
if (index === -1) return null;
|
|
99
|
-
else if (argv.length === 1)
|
|
100
|
-
throw new Error(`${props.type} file must be provided`);
|
|
101
|
-
|
|
102
|
-
const file: string = argv[index + 1]!;
|
|
103
|
-
if (file.endsWith(props.extension) === false)
|
|
104
|
-
throw new Error(`${props.type} file must be ${props.extension} file`);
|
|
105
|
-
return file;
|
|
106
|
-
};
|
|
107
|
-
}
|
|
1
|
+
import ts from "typescript";
|
|
2
|
+
|
|
3
|
+
import { INestiaConfig } from "../../INestiaConfig";
|
|
4
|
+
import { NestiaSdkApplication } from "../../NestiaSdkApplication";
|
|
5
|
+
import { NestiaConfigLoader } from "./NestiaConfigLoader";
|
|
6
|
+
|
|
7
|
+
export namespace NestiaSdkCommand {
|
|
8
|
+
export const sdk = () =>
|
|
9
|
+
main({
|
|
10
|
+
title: "SDK library",
|
|
11
|
+
generate: (app) => app.sdk(),
|
|
12
|
+
validate: (config) => !!config.output,
|
|
13
|
+
solution: "configure INestiaConfig.output property.",
|
|
14
|
+
});
|
|
15
|
+
|
|
16
|
+
export const swagger = () =>
|
|
17
|
+
main({
|
|
18
|
+
title: "Swagger Document",
|
|
19
|
+
generate: (app) => app.swagger(),
|
|
20
|
+
validate: (config) => !!config.swagger?.output,
|
|
21
|
+
solution: "configure INestiaConfig.swagger property.",
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
export const e2e = () =>
|
|
25
|
+
main({
|
|
26
|
+
title: "E2E Functions",
|
|
27
|
+
generate: (app) => app.e2e(),
|
|
28
|
+
validate: (config) => !!config.e2e,
|
|
29
|
+
solution: [
|
|
30
|
+
"configure two properties:",
|
|
31
|
+
"",
|
|
32
|
+
" - INestiaConfig.output",
|
|
33
|
+
" - INestiaConfig.e2e",
|
|
34
|
+
].join("\n"),
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
export const all = () =>
|
|
38
|
+
main({
|
|
39
|
+
title: "everything",
|
|
40
|
+
generate: (app) => app.all(),
|
|
41
|
+
validate: () => true,
|
|
42
|
+
solution: [
|
|
43
|
+
"configure at least one property of below:",
|
|
44
|
+
"",
|
|
45
|
+
" - INestiaConfig.output",
|
|
46
|
+
" - INestiaConfig.swagger.output",
|
|
47
|
+
].join("\n"),
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
const main = async (props: {
|
|
51
|
+
title: string;
|
|
52
|
+
solution: string;
|
|
53
|
+
generate: (app: NestiaSdkApplication) => Promise<void>;
|
|
54
|
+
validate: (config: INestiaConfig) => boolean;
|
|
55
|
+
}) => {
|
|
56
|
+
// LOAD CONFIG INFO
|
|
57
|
+
const command: ts.ParsedCommandLine =
|
|
58
|
+
await NestiaConfigLoader.compilerOptions(
|
|
59
|
+
getFileArgument({
|
|
60
|
+
type: "project",
|
|
61
|
+
extension: "json",
|
|
62
|
+
}) ?? "tsconfig.json",
|
|
63
|
+
);
|
|
64
|
+
|
|
65
|
+
const configurations: INestiaConfig[] =
|
|
66
|
+
await NestiaConfigLoader.configurations(
|
|
67
|
+
getFileArgument({
|
|
68
|
+
type: "config",
|
|
69
|
+
extension: "ts",
|
|
70
|
+
}) ?? "nestia.config.ts",
|
|
71
|
+
command.raw.compilerOptions,
|
|
72
|
+
);
|
|
73
|
+
|
|
74
|
+
// GENERATE
|
|
75
|
+
if (
|
|
76
|
+
configurations.length > 1 &&
|
|
77
|
+
configurations.some(props.validate) === false
|
|
78
|
+
)
|
|
79
|
+
throw new Error(
|
|
80
|
+
`Every configurations are invalid to generate ${props.title}, ${props.solution}`,
|
|
81
|
+
);
|
|
82
|
+
for (const config of configurations) {
|
|
83
|
+
if (configurations.length > 1 && props.validate(config) === false)
|
|
84
|
+
continue;
|
|
85
|
+
const app: NestiaSdkApplication = new NestiaSdkApplication(config);
|
|
86
|
+
await props.generate(app);
|
|
87
|
+
}
|
|
88
|
+
};
|
|
89
|
+
|
|
90
|
+
const getFileArgument = (props: {
|
|
91
|
+
type: string;
|
|
92
|
+
extension: string;
|
|
93
|
+
}): string | null => {
|
|
94
|
+
const argv: string[] = process.argv.slice(3);
|
|
95
|
+
if (argv.length === 0) return null;
|
|
96
|
+
|
|
97
|
+
const index: number = argv.findIndex((str) => str === `--${props.type}`);
|
|
98
|
+
if (index === -1) return null;
|
|
99
|
+
else if (argv.length === 1)
|
|
100
|
+
throw new Error(`${props.type} file must be provided`);
|
|
101
|
+
|
|
102
|
+
const file: string = argv[index + 1]!;
|
|
103
|
+
if (file.endsWith(props.extension) === false)
|
|
104
|
+
throw new Error(`${props.type} file must be ${props.extension} file`);
|
|
105
|
+
return file;
|
|
106
|
+
};
|
|
107
|
+
}
|