@nestia/sdk 7.1.1-dev.20250714 → 7.2.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 (162) 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/analyses/DtoAnalyzer.d.ts +21 -0
  15. package/lib/analyses/DtoAnalyzer.js +208 -0
  16. package/lib/analyses/DtoAnalyzer.js.map +1 -0
  17. package/lib/analyses/ImportAnalyzer.d.ts +3 -8
  18. package/lib/analyses/ImportAnalyzer.js +84 -102
  19. package/lib/analyses/ImportAnalyzer.js.map +1 -1
  20. package/lib/analyses/ReflectHttpOperationAnalyzer.js +1 -1
  21. package/lib/analyses/ReflectHttpOperationAnalyzer.js.map +1 -1
  22. package/lib/analyses/ReflectWebSocketOperationAnalyzer.js +1 -1
  23. package/lib/analyses/ReflectWebSocketOperationAnalyzer.js.map +1 -1
  24. package/lib/executable/internal/NestiaConfigLoader.js +4 -4
  25. package/lib/executable/sdk.js +12 -12
  26. package/lib/generates/internal/E2eFileProgrammer.js +3 -9
  27. package/lib/generates/internal/E2eFileProgrammer.js.map +1 -1
  28. package/lib/generates/internal/ImportDictionary.d.ts +9 -11
  29. package/lib/generates/internal/ImportDictionary.js +55 -48
  30. package/lib/generates/internal/ImportDictionary.js.map +1 -1
  31. package/lib/generates/internal/SdkAliasCollection.js +24 -18
  32. package/lib/generates/internal/SdkAliasCollection.js.map +1 -1
  33. package/lib/generates/internal/SdkFileProgrammer.js +1 -7
  34. package/lib/generates/internal/SdkFileProgrammer.js.map +1 -1
  35. package/lib/generates/internal/SdkHttpCloneReferencer.js +3 -1
  36. package/lib/generates/internal/SdkHttpCloneReferencer.js.map +1 -1
  37. package/lib/generates/internal/SdkHttpSimulationProgrammer.js +4 -3
  38. package/lib/generates/internal/SdkHttpSimulationProgrammer.js.map +1 -1
  39. package/lib/generates/internal/SdkImportWizard.js +28 -21
  40. package/lib/generates/internal/SdkImportWizard.js.map +1 -1
  41. package/lib/generates/internal/SdkTypeProgrammer.js +3 -2
  42. package/lib/generates/internal/SdkTypeProgrammer.js.map +1 -1
  43. package/lib/generates/internal/SdkTypeTagProgrammer.js +10 -8
  44. package/lib/generates/internal/SdkTypeTagProgrammer.js.map +1 -1
  45. package/lib/generates/internal/SdkWebSocketNamespaceProgrammer.js +8 -6
  46. package/lib/generates/internal/SdkWebSocketNamespaceProgrammer.js.map +1 -1
  47. package/lib/generates/internal/SdkWebSocketRouteProgrammer.js +12 -9
  48. package/lib/generates/internal/SdkWebSocketRouteProgrammer.js.map +1 -1
  49. package/lib/structures/IReflectHttpOperation.d.ts +2 -2
  50. package/lib/structures/IReflectImport.d.ts +6 -0
  51. package/lib/structures/{IReflectTypeImport.js → IReflectImport.js} +1 -1
  52. package/lib/structures/IReflectImport.js.map +1 -0
  53. package/lib/structures/IReflectWebSocketOperation.d.ts +2 -2
  54. package/lib/structures/IReflectWebSocketOperationParameter.d.ts +2 -2
  55. package/lib/structures/ITypedHttpRoute.d.ts +2 -2
  56. package/lib/structures/ITypedWebSocketRoute.d.ts +2 -2
  57. package/lib/transformers/IOperationMetadata.d.ts +3 -3
  58. package/lib/transformers/SdkOperationProgrammer.d.ts +3 -1
  59. package/lib/transformers/SdkOperationProgrammer.js +57 -26
  60. package/lib/transformers/SdkOperationProgrammer.js.map +1 -1
  61. package/lib/transformers/SdkOperationTransformer.js +3 -3
  62. package/lib/transformers/SdkOperationTransformer.js.map +1 -1
  63. package/package.json +4 -4
  64. package/src/INestiaConfig.ts +269 -269
  65. package/src/NestiaSdkApplication.ts +307 -307
  66. package/src/NestiaSwaggerComposer.ts +138 -138
  67. package/src/analyses/AccessorAnalyzer.ts +67 -67
  68. package/src/analyses/ConfigAnalyzer.ts +155 -155
  69. package/src/analyses/DtoAnalyzer.ts +250 -0
  70. package/src/analyses/ExceptionAnalyzer.ts +154 -154
  71. package/src/analyses/GenericAnalyzer.ts +49 -49
  72. package/src/analyses/ImportAnalyzer.ts +126 -171
  73. package/src/analyses/PathAnalyzer.ts +69 -69
  74. package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
  75. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  76. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +71 -71
  77. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +348 -348
  78. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +127 -127
  79. package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
  80. package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
  81. package/src/analyses/SecurityAnalyzer.ts +25 -25
  82. package/src/analyses/TypedHttpRouteAnalyzer.ts +204 -204
  83. package/src/analyses/TypedWebSocketRouteAnalyzer.ts +33 -33
  84. package/src/decorators/OperationMetadata.ts +15 -15
  85. package/src/executable/internal/CommandParser.ts +15 -15
  86. package/src/executable/internal/NestiaConfigLoader.ts +78 -78
  87. package/src/executable/internal/NestiaSdkCommand.ts +103 -103
  88. package/src/executable/sdk.ts +75 -75
  89. package/src/generates/CloneGenerator.ts +66 -66
  90. package/src/generates/E2eGenerator.ts +32 -32
  91. package/src/generates/SdkGenerator.ts +160 -160
  92. package/src/generates/SwaggerGenerator.ts +284 -284
  93. package/src/generates/internal/E2eFileProgrammer.ts +197 -205
  94. package/src/generates/internal/FilePrinter.ts +53 -53
  95. package/src/generates/internal/ImportDictionary.ts +190 -163
  96. package/src/generates/internal/SdkAliasCollection.ts +261 -255
  97. package/src/generates/internal/SdkDistributionComposer.ts +103 -103
  98. package/src/generates/internal/SdkFileProgrammer.ts +110 -116
  99. package/src/generates/internal/SdkHttpCloneProgrammer.ts +124 -124
  100. package/src/generates/internal/SdkHttpCloneReferencer.ts +77 -75
  101. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +279 -279
  102. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +500 -500
  103. package/src/generates/internal/SdkHttpParameterProgrammer.ts +178 -178
  104. package/src/generates/internal/SdkHttpRouteProgrammer.ts +107 -107
  105. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +310 -309
  106. package/src/generates/internal/SdkImportWizard.ts +62 -55
  107. package/src/generates/internal/SdkRouteDirectory.ts +18 -18
  108. package/src/generates/internal/SdkTypeProgrammer.ts +385 -384
  109. package/src/generates/internal/SdkTypeTagProgrammer.ts +104 -102
  110. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +368 -366
  111. package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +87 -87
  112. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +282 -279
  113. package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
  114. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  115. package/src/generates/internal/SwaggerOperationParameterComposer.ts +177 -177
  116. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  117. package/src/index.ts +4 -4
  118. package/src/module.ts +3 -3
  119. package/src/structures/INestiaProject.ts +13 -13
  120. package/src/structures/INestiaSdkInput.ts +20 -20
  121. package/src/structures/IReflectApplication.ts +8 -8
  122. package/src/structures/IReflectController.ts +15 -15
  123. package/src/structures/IReflectHttpOperation.ts +26 -26
  124. package/src/structures/IReflectHttpOperationException.ts +19 -19
  125. package/src/structures/IReflectHttpOperationParameter.ts +77 -81
  126. package/src/structures/IReflectHttpOperationSuccess.ts +22 -22
  127. package/src/structures/IReflectImport.ts +6 -0
  128. package/src/structures/IReflectOperationError.ts +26 -26
  129. package/src/structures/IReflectType.ts +4 -4
  130. package/src/structures/IReflectWebSocketOperation.ts +17 -17
  131. package/src/structures/IReflectWebSocketOperationParameter.ts +36 -38
  132. package/src/structures/ITypedApplication.ts +11 -11
  133. package/src/structures/ITypedHttpRoute.ts +41 -41
  134. package/src/structures/ITypedHttpRouteException.ts +15 -15
  135. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  136. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  137. package/src/structures/ITypedWebSocketRoute.ts +24 -24
  138. package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
  139. package/src/structures/MethodType.ts +5 -5
  140. package/src/structures/ParamCategory.ts +1 -1
  141. package/src/structures/TypeEntry.ts +22 -22
  142. package/src/transform.ts +9 -9
  143. package/src/transformers/IOperationMetadata.ts +44 -44
  144. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  145. package/src/transformers/SdkOperationProgrammer.ts +238 -209
  146. package/src/transformers/SdkOperationTransformer.ts +252 -253
  147. package/src/transformers/TextPlainValidator.ts +17 -17
  148. package/src/typings/get-function-location.d.ts +7 -7
  149. package/src/utils/ArrayUtil.ts +26 -26
  150. package/src/utils/FileRetriever.ts +22 -22
  151. package/src/utils/MapUtil.ts +14 -14
  152. package/src/utils/MetadataUtil.ts +26 -26
  153. package/src/utils/PathUtil.ts +10 -10
  154. package/src/utils/SourceFinder.ts +66 -66
  155. package/src/utils/StringUtil.ts +17 -17
  156. package/src/utils/StripEnums.ts +5 -5
  157. package/src/utils/VersioningStrategy.ts +28 -28
  158. package/src/validators/HttpHeadersValidator.ts +34 -34
  159. package/src/validators/HttpQueryValidator.ts +34 -34
  160. package/lib/structures/IReflectTypeImport.d.ts +0 -4
  161. package/lib/structures/IReflectTypeImport.js.map +0 -1
  162. package/src/structures/IReflectTypeImport.ts +0 -4
@@ -1,163 +1,190 @@
1
- import path from "path";
2
- import { HashMap, HashSet, Pair } from "tstl";
3
- import ts from "typescript";
4
-
5
- import { FilePrinter } from "./FilePrinter";
6
-
7
- export class ImportDictionary {
8
- private readonly components_: HashMap<Pair<string, boolean>, IComposition> =
9
- new HashMap();
10
-
11
- public constructor(public readonly file: string) {}
12
-
13
- public empty(): boolean {
14
- return this.components_.empty();
15
- }
16
-
17
- public external(props: ImportDictionary.IExternalProps): string {
18
- const key: string = `node_modules/${props.library}`;
19
- const composition: IComposition = this.components_.take(
20
- new Pair(key, props.type),
21
- () => ({
22
- location: key,
23
- elements: new HashSet(),
24
- default: false,
25
- type: props.type,
26
- }),
27
- );
28
- if (props.instance === null) composition.default = true;
29
- else composition.elements.insert(props.instance);
30
- return props.instance ?? props.library;
31
- }
32
-
33
- public internal(props: ImportDictionary.IInternalProps): string {
34
- const file: string = normalize(
35
- (() => {
36
- if (props.file.substring(props.file.length - 5) === ".d.ts")
37
- return props.file.substring(0, props.file.length - 5);
38
- else if (props.file.substring(props.file.length - 3) === ".ts")
39
- return props.file.substring(0, props.file.length - 3);
40
- return props.file;
41
- })(),
42
- );
43
- const composition: IComposition = this.components_.take(
44
- new Pair(file, props.type),
45
- () => ({
46
- location: file,
47
- elements: new HashSet(),
48
- default: false,
49
- type: props.type,
50
- }),
51
- );
52
- if (props.instance === null) {
53
- composition.default = true;
54
- if (props.name) composition.name = props.name;
55
- } else composition.elements.insert(props.instance);
56
- return props.instance ?? file;
57
- }
58
-
59
- public toStatements(outDir: string): ts.Statement[] {
60
- outDir = path.resolve(outDir);
61
- const external: ts.ImportDeclaration[] = [];
62
- const internal: ts.ImportDeclaration[] = [];
63
-
64
- const locator = (str: string) => {
65
- const location: string = path
66
- .relative(outDir, str)
67
- .split(path.sep)
68
- .join("/");
69
- const index: number = location.lastIndexOf(NODE_MODULES);
70
- return index === -1
71
- ? location.startsWith("..")
72
- ? location
73
- : `./${location}`
74
- : location.substring(index + NODE_MODULES.length);
75
- };
76
- const enroll =
77
- (filter: (str: string) => boolean) =>
78
- (container: ts.ImportDeclaration[]) => {
79
- const compositions: IComposition[] = this.components_
80
- .toJSON()
81
- .filter((c) => filter(c.second.location))
82
- .map((e) => ({
83
- ...e.second,
84
- location: locator(e.second.location),
85
- }))
86
- .sort((a, b) => a.location.localeCompare(b.location));
87
- for (const c of compositions) {
88
- const brackets: string[] = [];
89
- if (c.default) brackets.push(c.name ?? c.location);
90
- if (c.elements.empty() === false)
91
- brackets.push(
92
- `{ ${c.elements
93
- .toJSON()
94
- .sort((a, b) => a.localeCompare(b))
95
- .join(", ")} }`,
96
- );
97
- container.push(
98
- ts.factory.createImportDeclaration(
99
- undefined,
100
- ts.factory.createImportClause(
101
- c.type,
102
- c.default
103
- ? ts.factory.createIdentifier(c.name ?? c.location)
104
- : undefined,
105
- c.elements.empty() === false
106
- ? ts.factory.createNamedImports(
107
- [...c.elements].map((elem) =>
108
- ts.factory.createImportSpecifier(
109
- false,
110
- undefined,
111
- ts.factory.createIdentifier(elem),
112
- ),
113
- ),
114
- )
115
- : undefined,
116
- ),
117
- ts.factory.createStringLiteral(c.location),
118
- ),
119
- );
120
- }
121
- };
122
-
123
- enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
124
- enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
125
- return [
126
- ...external,
127
- ...(external.length && internal.length ? [FilePrinter.enter()] : []),
128
- ...internal,
129
- ];
130
- }
131
- }
132
- export namespace ImportDictionary {
133
- export interface IExternalProps {
134
- type: boolean;
135
- library: string;
136
- instance: string | null;
137
- }
138
- export interface IInternalProps {
139
- type: boolean;
140
- file: string;
141
- instance: string | null;
142
- name?: string | null;
143
- }
144
- }
145
-
146
- interface IComposition {
147
- location: string;
148
- type: boolean;
149
- default: boolean;
150
- name?: string;
151
- elements: HashSet<string>;
152
- }
153
-
154
- const NODE_MODULES = "node_modules/";
155
-
156
- const normalize = (file: string): string => {
157
- file = path.resolve(file);
158
- if (file.includes(`node_modules${path.sep}`))
159
- file =
160
- "node_modules/" +
161
- file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
162
- return file;
163
- };
1
+ import path from "path";
2
+ import { HashMap, TreeSet, hash } from "tstl";
3
+ import ts from "typescript";
4
+
5
+ import { ImportAnalyzer } from "../../analyses/ImportAnalyzer";
6
+ import { IReflectImport } from "../../structures/IReflectImport";
7
+ import { FilePrinter } from "./FilePrinter";
8
+
9
+ export class ImportDictionary {
10
+ private readonly components_: HashMap<ICompositeKey, ICompositeValue> =
11
+ new HashMap(
12
+ (key) => hash(key.file, key.declaration, key.asterisk, key.default),
13
+ (a, b) =>
14
+ a.file === b.file &&
15
+ a.declaration === b.declaration &&
16
+ a.asterisk === b.asterisk &&
17
+ a.default === b.default,
18
+ );
19
+
20
+ public constructor(public readonly file: string) {}
21
+
22
+ public empty(): boolean {
23
+ return this.components_.empty();
24
+ }
25
+
26
+ public declarations(imports: IReflectImport[]): void {
27
+ imports = ImportAnalyzer.merge(imports);
28
+ for (const imp of imports) {
29
+ if (imp.asterisk !== null)
30
+ this.internal({
31
+ type: "asterisk",
32
+ file: imp.file,
33
+ name: imp.asterisk,
34
+ declaration: true,
35
+ });
36
+ if (imp.default !== null)
37
+ this.internal({
38
+ type: "default",
39
+ file: imp.file,
40
+ name: imp.default,
41
+ declaration: true,
42
+ });
43
+ for (const elem of imp.elements)
44
+ this.internal({
45
+ type: "element",
46
+ file: imp.file,
47
+ name: elem,
48
+ declaration: true,
49
+ });
50
+ }
51
+ }
52
+
53
+ public external(props: ImportDictionary.IProps): string {
54
+ const file: string = `node_modules/${props.file}`;
55
+ return this.internal({
56
+ ...props,
57
+ file,
58
+ });
59
+ }
60
+
61
+ public internal(props: ImportDictionary.IProps): string {
62
+ const file: string = normalize(
63
+ (() => {
64
+ if (props.file.substring(props.file.length - 5) === ".d.ts")
65
+ return props.file.substring(0, props.file.length - 5);
66
+ else if (props.file.substring(props.file.length - 3) === ".ts")
67
+ return props.file.substring(0, props.file.length - 3);
68
+ return props.file;
69
+ })(),
70
+ );
71
+ const key: ICompositeKey = {
72
+ file: file,
73
+ declaration: props.declaration,
74
+ asterisk: props.type === "asterisk" ? props.name : null,
75
+ default: props.type === "default" ? props.name : null,
76
+ };
77
+ const value: ICompositeValue = this.components_.take(key, () => ({
78
+ ...key,
79
+ elements: new TreeSet<string>(),
80
+ }));
81
+ if (props.type === "element") value.elements.insert(props.name);
82
+ return props.name;
83
+ }
84
+
85
+ public toStatements(outDir: string): ts.Statement[] {
86
+ outDir = path.resolve(outDir);
87
+
88
+ const external: ts.ImportDeclaration[] = [];
89
+ const internal: ts.ImportDeclaration[] = [];
90
+ const locator = (str: string) => {
91
+ const location: string = path
92
+ .relative(outDir, str)
93
+ .split(path.sep)
94
+ .join("/");
95
+ const index: number = location.lastIndexOf(NODE_MODULES);
96
+ return index === -1
97
+ ? location.startsWith("..")
98
+ ? location
99
+ : `./${location}`
100
+ : location.substring(index + NODE_MODULES.length);
101
+ };
102
+ const enroll =
103
+ (filter: (str: string) => boolean) =>
104
+ (container: ts.ImportDeclaration[]) => {
105
+ const compositions: ICompositeValue[] = this.components_
106
+ .toJSON()
107
+ .filter((c) => filter(c.second.file))
108
+ .map(
109
+ (e) =>
110
+ ({
111
+ ...e.second,
112
+ file: locator(e.second.file),
113
+ }) satisfies ICompositeValue,
114
+ )
115
+ .sort((a, b) => a.file.localeCompare(b.file));
116
+ for (const c of compositions)
117
+ container.push(
118
+ ts.factory.createImportDeclaration(
119
+ undefined,
120
+ this.toImportClaude(c),
121
+ ts.factory.createStringLiteral(c.file),
122
+ undefined,
123
+ ),
124
+ );
125
+ };
126
+
127
+ enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
128
+ enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
129
+ return [
130
+ ...external,
131
+ ...(external.length && internal.length ? [FilePrinter.enter()] : []),
132
+ ...internal,
133
+ ];
134
+ }
135
+
136
+ private toImportClaude(c: ICompositeValue): ts.ImportClause {
137
+ if (c.asterisk !== null)
138
+ return ts.factory.createImportClause(
139
+ c.declaration,
140
+ undefined,
141
+ ts.factory.createNamespaceImport(
142
+ ts.factory.createIdentifier(c.asterisk),
143
+ ),
144
+ );
145
+ return ts.factory.createImportClause(
146
+ c.declaration,
147
+ c.default !== null ? ts.factory.createIdentifier(c.default) : undefined,
148
+ c.elements.size() !== 0
149
+ ? ts.factory.createNamedImports(
150
+ Array.from(c.elements).map((elem) =>
151
+ ts.factory.createImportSpecifier(
152
+ false,
153
+ undefined,
154
+ ts.factory.createIdentifier(elem),
155
+ ),
156
+ ),
157
+ )
158
+ : undefined,
159
+ );
160
+ }
161
+ }
162
+ export namespace ImportDictionary {
163
+ export interface IProps {
164
+ type: "default" | "element" | "asterisk";
165
+ file: string;
166
+ name: string;
167
+ declaration: boolean;
168
+ }
169
+ }
170
+
171
+ interface ICompositeKey {
172
+ file: string;
173
+ declaration: boolean;
174
+ asterisk: string | null;
175
+ default: string | null;
176
+ }
177
+ interface ICompositeValue extends ICompositeKey {
178
+ elements: TreeSet<string>;
179
+ }
180
+
181
+ const NODE_MODULES = "node_modules/";
182
+
183
+ const normalize = (file: string): string => {
184
+ file = path.resolve(file);
185
+ if (file.includes(`node_modules${path.sep}`))
186
+ file =
187
+ "node_modules/" +
188
+ file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
189
+ return file;
190
+ };