@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.
Files changed (65) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +93 -93
  3. package/assets/bundle/api/HttpError.ts +1 -1
  4. package/assets/bundle/api/IConnection.ts +1 -1
  5. package/assets/bundle/api/Primitive.ts +1 -1
  6. package/assets/bundle/api/Resolved.ts +1 -1
  7. package/assets/bundle/api/index.ts +4 -4
  8. package/assets/bundle/api/module.ts +6 -6
  9. package/assets/bundle/distribute/README.md +37 -37
  10. package/assets/bundle/distribute/package.json +28 -28
  11. package/assets/bundle/distribute/tsconfig.json +109 -109
  12. package/assets/bundle/e2e/index.ts +42 -42
  13. package/assets/config/nestia.config.ts +97 -97
  14. package/lib/executable/internal/NestiaConfigLoader.js +5 -5
  15. package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
  16. package/package.json +8 -8
  17. package/src/INestiaConfig.ts +267 -267
  18. package/src/NestiaSdkApplication.ts +307 -307
  19. package/src/NestiaSwaggerComposer.ts +143 -143
  20. package/src/analyses/AccessorAnalyzer.ts +67 -67
  21. package/src/analyses/DtoAnalyzer.ts +260 -260
  22. package/src/analyses/ImportAnalyzer.ts +126 -126
  23. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  24. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +72 -72
  25. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +350 -350
  26. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +126 -126
  27. package/src/analyses/TypedHttpRouteAnalyzer.ts +208 -208
  28. package/src/executable/internal/NestiaConfigLoader.ts +85 -85
  29. package/src/executable/internal/NestiaSdkCommand.ts +107 -107
  30. package/src/generates/SwaggerGenerator.ts +291 -291
  31. package/src/generates/internal/E2eFileProgrammer.ts +196 -196
  32. package/src/generates/internal/FilePrinter.ts +64 -64
  33. package/src/generates/internal/ImportDictionary.ts +192 -192
  34. package/src/generates/internal/SdkAliasCollection.ts +260 -260
  35. package/src/generates/internal/SdkFileProgrammer.ts +110 -110
  36. package/src/generates/internal/SdkHttpCloneProgrammer.ts +126 -126
  37. package/src/generates/internal/SdkHttpCloneReferencer.ts +77 -77
  38. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +278 -278
  39. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +502 -502
  40. package/src/generates/internal/SdkHttpRouteProgrammer.ts +109 -109
  41. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +312 -312
  42. package/src/generates/internal/SdkImportWizard.ts +62 -62
  43. package/src/generates/internal/SdkTypeProgrammer.ts +388 -388
  44. package/src/generates/internal/SdkTypeTagProgrammer.ts +114 -114
  45. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +379 -379
  46. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +302 -302
  47. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  48. package/src/generates/internal/SwaggerOperationParameterComposer.ts +161 -161
  49. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  50. package/src/module.ts +4 -4
  51. package/src/structures/IReflectHttpOperationException.ts +18 -18
  52. package/src/structures/IReflectHttpOperationParameter.ts +79 -79
  53. package/src/structures/IReflectHttpOperationSuccess.ts +21 -21
  54. package/src/structures/ITypedApplication.ts +11 -11
  55. package/src/structures/ITypedHttpRouteException.ts +15 -15
  56. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  57. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  58. package/src/transformers/IOperationMetadata.ts +46 -46
  59. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  60. package/src/transformers/SdkOperationProgrammer.ts +240 -240
  61. package/src/transformers/SdkOperationTransformer.ts +248 -248
  62. package/src/transformers/TextPlainValidator.ts +17 -17
  63. package/src/utils/MetadataUtil.ts +26 -26
  64. package/src/validators/HttpHeadersValidator.ts +40 -40
  65. package/src/validators/HttpQueryValidator.ts +40 -40
@@ -1,85 +1,85 @@
1
- import { NoTransformConfigurationError } 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
- NoTransformConfigurationError.throws = false;
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
+ }