@nestia/sdk 7.0.0-dev.20250607 → 7.0.0

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/LICENSE +21 -21
  2. package/README.md +92 -92
  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 +4 -4
  15. package/lib/executable/sdk.js +12 -12
  16. package/package.json +5 -5
  17. package/src/INestiaConfig.ts +269 -269
  18. package/src/NestiaSdkApplication.ts +307 -307
  19. package/src/NestiaSwaggerComposer.ts +138 -138
  20. package/src/analyses/AccessorAnalyzer.ts +67 -67
  21. package/src/analyses/ConfigAnalyzer.ts +155 -155
  22. package/src/analyses/ExceptionAnalyzer.ts +154 -154
  23. package/src/analyses/GenericAnalyzer.ts +49 -49
  24. package/src/analyses/ImportAnalyzer.ts +171 -171
  25. package/src/analyses/PathAnalyzer.ts +69 -69
  26. package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
  27. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  28. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +71 -71
  29. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +348 -348
  30. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +127 -127
  31. package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
  32. package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
  33. package/src/analyses/SecurityAnalyzer.ts +25 -25
  34. package/src/analyses/TypedHttpRouteAnalyzer.ts +204 -204
  35. package/src/analyses/TypedWebSocketRouteAnalyzer.ts +33 -33
  36. package/src/decorators/OperationMetadata.ts +15 -15
  37. package/src/executable/internal/CommandParser.ts +15 -15
  38. package/src/executable/internal/NestiaConfigLoader.ts +78 -78
  39. package/src/executable/internal/NestiaSdkCommand.ts +103 -103
  40. package/src/executable/sdk.ts +75 -75
  41. package/src/generates/CloneGenerator.ts +66 -66
  42. package/src/generates/E2eGenerator.ts +32 -32
  43. package/src/generates/SdkGenerator.ts +160 -160
  44. package/src/generates/SwaggerGenerator.ts +284 -284
  45. package/src/generates/internal/E2eFileProgrammer.ts +205 -205
  46. package/src/generates/internal/FilePrinter.ts +53 -53
  47. package/src/generates/internal/ImportDictionary.ts +163 -163
  48. package/src/generates/internal/SdkAliasCollection.ts +255 -255
  49. package/src/generates/internal/SdkDistributionComposer.ts +103 -103
  50. package/src/generates/internal/SdkFileProgrammer.ts +116 -116
  51. package/src/generates/internal/SdkHttpCloneProgrammer.ts +124 -124
  52. package/src/generates/internal/SdkHttpCloneReferencer.ts +75 -75
  53. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +276 -276
  54. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +500 -500
  55. package/src/generates/internal/SdkHttpParameterProgrammer.ts +178 -178
  56. package/src/generates/internal/SdkHttpRouteProgrammer.ts +107 -107
  57. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +340 -340
  58. package/src/generates/internal/SdkImportWizard.ts +55 -55
  59. package/src/generates/internal/SdkRouteDirectory.ts +18 -18
  60. package/src/generates/internal/SdkTypeProgrammer.ts +384 -384
  61. package/src/generates/internal/SdkTypeTagProgrammer.ts +102 -102
  62. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +366 -366
  63. package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +87 -87
  64. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +279 -279
  65. package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
  66. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  67. package/src/generates/internal/SwaggerOperationParameterComposer.ts +177 -177
  68. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  69. package/src/index.ts +4 -4
  70. package/src/module.ts +3 -3
  71. package/src/structures/INestiaProject.ts +13 -13
  72. package/src/structures/INestiaSdkInput.ts +20 -20
  73. package/src/structures/IReflectApplication.ts +8 -8
  74. package/src/structures/IReflectController.ts +15 -15
  75. package/src/structures/IReflectHttpOperation.ts +26 -26
  76. package/src/structures/IReflectHttpOperationException.ts +19 -19
  77. package/src/structures/IReflectHttpOperationParameter.ts +81 -81
  78. package/src/structures/IReflectHttpOperationSuccess.ts +22 -22
  79. package/src/structures/IReflectOperationError.ts +26 -26
  80. package/src/structures/IReflectType.ts +4 -4
  81. package/src/structures/IReflectTypeImport.ts +4 -4
  82. package/src/structures/IReflectWebSocketOperation.ts +17 -17
  83. package/src/structures/IReflectWebSocketOperationParameter.ts +38 -38
  84. package/src/structures/ITypedApplication.ts +11 -11
  85. package/src/structures/ITypedHttpRoute.ts +41 -41
  86. package/src/structures/ITypedHttpRouteException.ts +15 -15
  87. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  88. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  89. package/src/structures/ITypedWebSocketRoute.ts +24 -24
  90. package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
  91. package/src/structures/MethodType.ts +5 -5
  92. package/src/structures/ParamCategory.ts +1 -1
  93. package/src/structures/TypeEntry.ts +22 -22
  94. package/src/transform.ts +9 -9
  95. package/src/transformers/IOperationMetadata.ts +44 -44
  96. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  97. package/src/transformers/SdkOperationProgrammer.ts +209 -209
  98. package/src/transformers/SdkOperationTransformer.ts +253 -253
  99. package/src/transformers/TextPlainValidator.ts +17 -17
  100. package/src/typings/get-function-location.d.ts +7 -7
  101. package/src/utils/ArrayUtil.ts +26 -26
  102. package/src/utils/FileRetriever.ts +22 -22
  103. package/src/utils/MapUtil.ts +14 -14
  104. package/src/utils/MetadataUtil.ts +26 -26
  105. package/src/utils/PathUtil.ts +10 -10
  106. package/src/utils/SourceFinder.ts +66 -66
  107. package/src/utils/StringUtil.ts +17 -17
  108. package/src/utils/StripEnums.ts +5 -5
  109. package/src/utils/VersioningStrategy.ts +28 -28
  110. package/src/validators/HttpHeadersValidator.ts +34 -34
  111. package/src/validators/HttpQueryValidator.ts +34 -34
@@ -1,124 +1,124 @@
1
- import { IPointer } from "tstl";
2
- import ts from "typescript";
3
- import { IJsDocTagInfo } from "typia";
4
- import { MetadataAliasType } from "typia/lib/schemas/metadata/MetadataAliasType";
5
- import { MetadataAtomic } from "typia/lib/schemas/metadata/MetadataAtomic";
6
- import { MetadataObjectType } from "typia/lib/schemas/metadata/MetadataObjectType";
7
-
8
- import { INestiaProject } from "../../structures/INestiaProject";
9
- import { ITypedApplication } from "../../structures/ITypedApplication";
10
- import { MapUtil } from "../../utils/MapUtil";
11
- import { StringUtil } from "../../utils/StringUtil";
12
- import { FilePrinter } from "./FilePrinter";
13
- import { ImportDictionary } from "./ImportDictionary";
14
- import { SdkTypeProgrammer } from "./SdkTypeProgrammer";
15
-
16
- export namespace SdkHttpCloneProgrammer {
17
- export interface IModule {
18
- name: string;
19
- children: Map<string, IModule>;
20
- programmer:
21
- | null
22
- | ((importer: ImportDictionary) => ts.TypeAliasDeclaration);
23
- }
24
-
25
- export const write = (app: ITypedApplication): Map<string, IModule> => {
26
- // COMPOSE THE DICTIONARY
27
- const dict: Map<string, IModule> = new Map();
28
- for (const [k, v] of app.collection.objects.entries())
29
- if (StringUtil.isImplicit(k) === false)
30
- prepare({
31
- dict,
32
- name: k,
33
- programmer: (importer) => writeObject(app.project)(importer)(v),
34
- });
35
- for (const [k, v] of app.collection.aliases.entries())
36
- if (StringUtil.isImplicit(k) === false)
37
- prepare({
38
- dict,
39
- name: k,
40
- programmer: (importer) => writeAlias(app.project)(importer)(v),
41
- });
42
- return dict;
43
- };
44
-
45
- const prepare = (props: {
46
- dict: Map<string, IModule>;
47
- name: string;
48
- programmer: (importer: ImportDictionary) => ts.TypeAliasDeclaration;
49
- }) => {
50
- let next: Map<string, IModule> = props.dict;
51
- const accessors: string[] = props.name.split(".");
52
- const modulo: IPointer<IModule> = { value: null! };
53
-
54
- accessors.forEach((acc, i) => {
55
- modulo.value = MapUtil.take(next, acc, () => ({
56
- name: acc,
57
- children: new Map(),
58
- programmer: null,
59
- }));
60
- if (i === accessors.length - 1)
61
- modulo.value.programmer = props.programmer;
62
- next = modulo.value.children;
63
- });
64
- return modulo!;
65
- };
66
-
67
- const writeAlias =
68
- (project: INestiaProject) =>
69
- (importer: ImportDictionary) =>
70
- (alias: MetadataAliasType): ts.TypeAliasDeclaration =>
71
- FilePrinter.description(
72
- ts.factory.createTypeAliasDeclaration(
73
- [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
74
- alias.name.split(".").at(-1)!,
75
- [],
76
- SdkTypeProgrammer.write(project)(importer)(alias.value),
77
- ),
78
- writeComment([])(alias.description, alias.jsDocTags),
79
- );
80
-
81
- const writeObject =
82
- (project: INestiaProject) =>
83
- (importer: ImportDictionary) =>
84
- (object: MetadataObjectType): ts.TypeAliasDeclaration => {
85
- return FilePrinter.description(
86
- ts.factory.createTypeAliasDeclaration(
87
- [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
88
- object.name.split(".").at(-1)!,
89
- [],
90
- SdkTypeProgrammer.write_object(project)(importer)(object),
91
- ),
92
- writeComment([])(object.description ?? null, object.jsDocTags),
93
- );
94
- };
95
- }
96
-
97
- const writeComment =
98
- (atomics: MetadataAtomic[]) =>
99
- (description: string | null, jsDocTags: IJsDocTagInfo[]): string => {
100
- const lines: string[] = [];
101
- if (description?.length)
102
- lines.push(...description.split("\n").map((s) => `${s}`));
103
-
104
- const filtered: IJsDocTagInfo[] =
105
- !!atomics.length && !!jsDocTags?.length
106
- ? jsDocTags.filter(
107
- (tag) =>
108
- !atomics.some((a) =>
109
- a.tags.some((r) => r.some((t) => t.kind === tag.name)),
110
- ),
111
- )
112
- : (jsDocTags ?? []);
113
-
114
- if (description?.length && filtered.length) lines.push("");
115
- if (filtered.length)
116
- lines.push(
117
- ...filtered.map((t) =>
118
- t.text?.length
119
- ? `@${t.name} ${t.text.map((e) => e.text).join("")}`
120
- : `@${t.name}`,
121
- ),
122
- );
123
- return lines.join("\n");
124
- };
1
+ import { IPointer } from "tstl";
2
+ import ts from "typescript";
3
+ import { IJsDocTagInfo } from "typia";
4
+ import { MetadataAliasType } from "typia/lib/schemas/metadata/MetadataAliasType";
5
+ import { MetadataAtomic } from "typia/lib/schemas/metadata/MetadataAtomic";
6
+ import { MetadataObjectType } from "typia/lib/schemas/metadata/MetadataObjectType";
7
+
8
+ import { INestiaProject } from "../../structures/INestiaProject";
9
+ import { ITypedApplication } from "../../structures/ITypedApplication";
10
+ import { MapUtil } from "../../utils/MapUtil";
11
+ import { StringUtil } from "../../utils/StringUtil";
12
+ import { FilePrinter } from "./FilePrinter";
13
+ import { ImportDictionary } from "./ImportDictionary";
14
+ import { SdkTypeProgrammer } from "./SdkTypeProgrammer";
15
+
16
+ export namespace SdkHttpCloneProgrammer {
17
+ export interface IModule {
18
+ name: string;
19
+ children: Map<string, IModule>;
20
+ programmer:
21
+ | null
22
+ | ((importer: ImportDictionary) => ts.TypeAliasDeclaration);
23
+ }
24
+
25
+ export const write = (app: ITypedApplication): Map<string, IModule> => {
26
+ // COMPOSE THE DICTIONARY
27
+ const dict: Map<string, IModule> = new Map();
28
+ for (const [k, v] of app.collection.objects.entries())
29
+ if (StringUtil.isImplicit(k) === false)
30
+ prepare({
31
+ dict,
32
+ name: k,
33
+ programmer: (importer) => writeObject(app.project)(importer)(v),
34
+ });
35
+ for (const [k, v] of app.collection.aliases.entries())
36
+ if (StringUtil.isImplicit(k) === false)
37
+ prepare({
38
+ dict,
39
+ name: k,
40
+ programmer: (importer) => writeAlias(app.project)(importer)(v),
41
+ });
42
+ return dict;
43
+ };
44
+
45
+ const prepare = (props: {
46
+ dict: Map<string, IModule>;
47
+ name: string;
48
+ programmer: (importer: ImportDictionary) => ts.TypeAliasDeclaration;
49
+ }) => {
50
+ let next: Map<string, IModule> = props.dict;
51
+ const accessors: string[] = props.name.split(".");
52
+ const modulo: IPointer<IModule> = { value: null! };
53
+
54
+ accessors.forEach((acc, i) => {
55
+ modulo.value = MapUtil.take(next, acc, () => ({
56
+ name: acc,
57
+ children: new Map(),
58
+ programmer: null,
59
+ }));
60
+ if (i === accessors.length - 1)
61
+ modulo.value.programmer = props.programmer;
62
+ next = modulo.value.children;
63
+ });
64
+ return modulo!;
65
+ };
66
+
67
+ const writeAlias =
68
+ (project: INestiaProject) =>
69
+ (importer: ImportDictionary) =>
70
+ (alias: MetadataAliasType): ts.TypeAliasDeclaration =>
71
+ FilePrinter.description(
72
+ ts.factory.createTypeAliasDeclaration(
73
+ [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
74
+ alias.name.split(".").at(-1)!,
75
+ [],
76
+ SdkTypeProgrammer.write(project)(importer)(alias.value),
77
+ ),
78
+ writeComment([])(alias.description, alias.jsDocTags),
79
+ );
80
+
81
+ const writeObject =
82
+ (project: INestiaProject) =>
83
+ (importer: ImportDictionary) =>
84
+ (object: MetadataObjectType): ts.TypeAliasDeclaration => {
85
+ return FilePrinter.description(
86
+ ts.factory.createTypeAliasDeclaration(
87
+ [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
88
+ object.name.split(".").at(-1)!,
89
+ [],
90
+ SdkTypeProgrammer.write_object(project)(importer)(object),
91
+ ),
92
+ writeComment([])(object.description ?? null, object.jsDocTags),
93
+ );
94
+ };
95
+ }
96
+
97
+ const writeComment =
98
+ (atomics: MetadataAtomic[]) =>
99
+ (description: string | null, jsDocTags: IJsDocTagInfo[]): string => {
100
+ const lines: string[] = [];
101
+ if (description?.length)
102
+ lines.push(...description.split("\n").map((s) => `${s}`));
103
+
104
+ const filtered: IJsDocTagInfo[] =
105
+ !!atomics.length && !!jsDocTags?.length
106
+ ? jsDocTags.filter(
107
+ (tag) =>
108
+ !atomics.some((a) =>
109
+ a.tags.some((r) => r.some((t) => t.kind === tag.name)),
110
+ ),
111
+ )
112
+ : (jsDocTags ?? []);
113
+
114
+ if (description?.length && filtered.length) lines.push("");
115
+ if (filtered.length)
116
+ lines.push(
117
+ ...filtered.map((t) =>
118
+ t.text?.length
119
+ ? `@${t.name} ${t.text.map((e) => e.text).join("")}`
120
+ : `@${t.name}`,
121
+ ),
122
+ );
123
+ return lines.join("\n");
124
+ };
@@ -1,75 +1,75 @@
1
- import { Metadata } from "typia/lib/schemas/metadata/Metadata";
2
-
3
- import { IReflectType } from "../../structures/IReflectType";
4
- import { ITypedApplication } from "../../structures/ITypedApplication";
5
- import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
6
- import { StringUtil } from "../../utils/StringUtil";
7
- import { SdkHttpParameterProgrammer } from "./SdkHttpParameterProgrammer";
8
-
9
- export namespace SdkHttpCloneReferencer {
10
- export const replace = (app: ITypedApplication): void => {
11
- const directory: string = `${app.project.config.output}/structures`;
12
- for (const route of app.routes)
13
- if (route.protocol === "http")
14
- visitRoute({
15
- directory,
16
- route,
17
- });
18
- };
19
-
20
- const visitRoute = (props: {
21
- directory: string;
22
- route: ITypedHttpRoute;
23
- }): void => {
24
- const unique: Set<string> = new Set();
25
- for (const p of SdkHttpParameterProgrammer.getSignificant(
26
- props.route,
27
- true,
28
- ))
29
- visitType({
30
- unique,
31
- metadata: p.metadata,
32
- type: p.type,
33
- name: (name) => (p.type = { name }),
34
- });
35
- for (const v of Object.values(props.route.exceptions))
36
- visitType({
37
- unique,
38
- metadata: v.metadata,
39
- type: v.type,
40
- name: (name) => (v.type = { name }),
41
- });
42
- visitType({
43
- unique,
44
- metadata: props.route.success.metadata,
45
- type: props.route.success.type,
46
- name: (name) => (props.route.success.type = { name }),
47
- });
48
- props.route.imports = Array.from(unique).map((str) => ({
49
- file: `${props.directory}/${str}`,
50
- instances: [str],
51
- }));
52
- };
53
-
54
- const visitType = (p: {
55
- unique: Set<string>;
56
- metadata: Metadata;
57
- type: IReflectType;
58
- name: (key: string) => void;
59
- }): void => {
60
- const enroll = (key: string) => {
61
- if (key.length && StringUtil.isImplicit(key) === false)
62
- p.unique.add(key.split(".")[0]);
63
- };
64
- for (const alias of p.metadata.aliases) enroll(alias.type.name);
65
- for (const array of p.metadata.arrays) enroll(array.type.name);
66
- for (const tuple of p.metadata.tuples) enroll(tuple.type.name);
67
- for (const object of p.metadata.objects) enroll(object.type.name);
68
- p.name(p.metadata.getName());
69
- };
70
- }
71
-
72
- const getFullText = (type: IReflectType): string =>
73
- type.typeArguments === undefined
74
- ? type.name
75
- : `${type.name}<${type.typeArguments.map(getFullText).join(", ")}>`;
1
+ import { Metadata } from "typia/lib/schemas/metadata/Metadata";
2
+
3
+ import { IReflectType } from "../../structures/IReflectType";
4
+ import { ITypedApplication } from "../../structures/ITypedApplication";
5
+ import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
6
+ import { StringUtil } from "../../utils/StringUtil";
7
+ import { SdkHttpParameterProgrammer } from "./SdkHttpParameterProgrammer";
8
+
9
+ export namespace SdkHttpCloneReferencer {
10
+ export const replace = (app: ITypedApplication): void => {
11
+ const directory: string = `${app.project.config.output}/structures`;
12
+ for (const route of app.routes)
13
+ if (route.protocol === "http")
14
+ visitRoute({
15
+ directory,
16
+ route,
17
+ });
18
+ };
19
+
20
+ const visitRoute = (props: {
21
+ directory: string;
22
+ route: ITypedHttpRoute;
23
+ }): void => {
24
+ const unique: Set<string> = new Set();
25
+ for (const p of SdkHttpParameterProgrammer.getSignificant(
26
+ props.route,
27
+ true,
28
+ ))
29
+ visitType({
30
+ unique,
31
+ metadata: p.metadata,
32
+ type: p.type,
33
+ name: (name) => (p.type = { name }),
34
+ });
35
+ for (const v of Object.values(props.route.exceptions))
36
+ visitType({
37
+ unique,
38
+ metadata: v.metadata,
39
+ type: v.type,
40
+ name: (name) => (v.type = { name }),
41
+ });
42
+ visitType({
43
+ unique,
44
+ metadata: props.route.success.metadata,
45
+ type: props.route.success.type,
46
+ name: (name) => (props.route.success.type = { name }),
47
+ });
48
+ props.route.imports = Array.from(unique).map((str) => ({
49
+ file: `${props.directory}/${str}`,
50
+ instances: [str],
51
+ }));
52
+ };
53
+
54
+ const visitType = (p: {
55
+ unique: Set<string>;
56
+ metadata: Metadata;
57
+ type: IReflectType;
58
+ name: (key: string) => void;
59
+ }): void => {
60
+ const enroll = (key: string) => {
61
+ if (key.length && StringUtil.isImplicit(key) === false)
62
+ p.unique.add(key.split(".")[0]);
63
+ };
64
+ for (const alias of p.metadata.aliases) enroll(alias.type.name);
65
+ for (const array of p.metadata.arrays) enroll(array.type.name);
66
+ for (const tuple of p.metadata.tuples) enroll(tuple.type.name);
67
+ for (const object of p.metadata.objects) enroll(object.type.name);
68
+ p.name(p.metadata.getName());
69
+ };
70
+ }
71
+
72
+ const getFullText = (type: IReflectType): string =>
73
+ type.typeArguments === undefined
74
+ ? type.name
75
+ : `${type.name}<${type.typeArguments.map(getFullText).join(", ")}>`;