@nestia/sdk 10.0.2 → 11.0.0-dev.20260312

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 (151) 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/INestiaConfig.d.ts +3 -3
  15. package/lib/NestiaSdkApplication.js.map +1 -1
  16. package/lib/NestiaSwaggerComposer.d.ts +3 -2
  17. package/lib/NestiaSwaggerComposer.js +5 -6
  18. package/lib/NestiaSwaggerComposer.js.map +1 -1
  19. package/lib/analyses/AccessorAnalyzer.js +2 -2
  20. package/lib/analyses/AccessorAnalyzer.js.map +1 -1
  21. package/lib/analyses/DtoAnalyzer.js.map +1 -1
  22. package/lib/analyses/ImportAnalyzer.js.map +1 -1
  23. package/lib/analyses/ReflectHttpOperationAnalyzer.js +3 -3
  24. package/lib/analyses/ReflectHttpOperationAnalyzer.js.map +1 -1
  25. package/lib/analyses/ReflectHttpOperationExceptionAnalyzer.js +4 -2
  26. package/lib/analyses/ReflectHttpOperationExceptionAnalyzer.js.map +1 -1
  27. package/lib/analyses/ReflectHttpOperationParameterAnalyzer.js +7 -11
  28. package/lib/analyses/ReflectHttpOperationParameterAnalyzer.js.map +1 -1
  29. package/lib/analyses/ReflectHttpOperationResponseAnalyzer.js +6 -6
  30. package/lib/analyses/ReflectHttpOperationResponseAnalyzer.js.map +1 -1
  31. package/lib/analyses/TypedHttpRouteAnalyzer.d.ts +1 -1
  32. package/lib/analyses/TypedHttpRouteAnalyzer.js +6 -8
  33. package/lib/analyses/TypedHttpRouteAnalyzer.js.map +1 -1
  34. package/lib/executable/internal/NestiaConfigLoader.js +111 -52
  35. package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
  36. package/lib/executable/internal/NestiaSdkCommand.js.map +1 -1
  37. package/lib/executable/sdk.js +0 -0
  38. package/lib/generates/SwaggerGenerator.d.ts +1 -1
  39. package/lib/generates/SwaggerGenerator.js +11 -12
  40. package/lib/generates/SwaggerGenerator.js.map +1 -1
  41. package/lib/generates/internal/E2eFileProgrammer.js +8 -9
  42. package/lib/generates/internal/E2eFileProgrammer.js.map +1 -1
  43. package/lib/generates/internal/SdkAliasCollection.d.ts +2 -2
  44. package/lib/generates/internal/SdkAliasCollection.js +2 -2
  45. package/lib/generates/internal/SdkAliasCollection.js.map +1 -1
  46. package/lib/generates/internal/SdkDistributionComposer.js +1 -1
  47. package/lib/generates/internal/SdkHttpCloneProgrammer.js.map +1 -1
  48. package/lib/generates/internal/SdkHttpCloneReferencer.js.map +1 -1
  49. package/lib/generates/internal/SdkHttpFunctionProgrammer.js +11 -12
  50. package/lib/generates/internal/SdkHttpFunctionProgrammer.js.map +1 -1
  51. package/lib/generates/internal/SdkHttpNamespaceProgrammer.js +13 -16
  52. package/lib/generates/internal/SdkHttpNamespaceProgrammer.js.map +1 -1
  53. package/lib/generates/internal/SdkHttpRouteProgrammer.js +4 -4
  54. package/lib/generates/internal/SdkHttpRouteProgrammer.js.map +1 -1
  55. package/lib/generates/internal/SdkHttpSimulationProgrammer.js +12 -16
  56. package/lib/generates/internal/SdkHttpSimulationProgrammer.js.map +1 -1
  57. package/lib/generates/internal/SdkImportWizard.js +2 -2
  58. package/lib/generates/internal/SdkImportWizard.js.map +1 -1
  59. package/lib/generates/internal/SdkTypeProgrammer.d.ts +2 -3
  60. package/lib/generates/internal/SdkTypeProgrammer.js +6 -7
  61. package/lib/generates/internal/SdkTypeProgrammer.js.map +1 -1
  62. package/lib/generates/internal/SdkTypeTagProgrammer.d.ts +1 -1
  63. package/lib/generates/internal/SdkTypeTagProgrammer.js +11 -11
  64. package/lib/generates/internal/SdkTypeTagProgrammer.js.map +1 -1
  65. package/lib/generates/internal/SdkWebSocketNamespaceProgrammer.js +6 -8
  66. package/lib/generates/internal/SdkWebSocketNamespaceProgrammer.js.map +1 -1
  67. package/lib/generates/internal/SdkWebSocketRouteProgrammer.js +2 -2
  68. package/lib/generates/internal/SdkWebSocketRouteProgrammer.js.map +1 -1
  69. package/lib/generates/internal/SwaggerOperationComposer.d.ts +3 -3
  70. package/lib/generates/internal/SwaggerOperationComposer.js.map +1 -1
  71. package/lib/generates/internal/SwaggerOperationParameterComposer.d.ts +1 -1
  72. package/lib/generates/internal/SwaggerOperationParameterComposer.js +10 -8
  73. package/lib/generates/internal/SwaggerOperationParameterComposer.js.map +1 -1
  74. package/lib/generates/internal/SwaggerOperationResponseComposer.d.ts +3 -3
  75. package/lib/generates/internal/SwaggerOperationResponseComposer.js.map +1 -1
  76. package/lib/module.d.ts +1 -0
  77. package/lib/module.js +1 -0
  78. package/lib/module.js.map +1 -1
  79. package/lib/structures/IReflectHttpOperationException.d.ts +3 -4
  80. package/lib/structures/IReflectHttpOperationParameter.d.ts +3 -5
  81. package/lib/structures/IReflectHttpOperationSuccess.d.ts +3 -4
  82. package/lib/structures/ITypedApplication.d.ts +1 -1
  83. package/lib/structures/ITypedHttpRouteException.d.ts +2 -2
  84. package/lib/structures/ITypedHttpRouteParameter.d.ts +2 -2
  85. package/lib/structures/ITypedHttpRouteSuccess.d.ts +2 -2
  86. package/lib/transformers/IOperationMetadata.d.ts +2 -4
  87. package/lib/transformers/ISdkOperationTransformerContext.d.ts +1 -1
  88. package/lib/transformers/SdkOperationProgrammer.js +8 -10
  89. package/lib/transformers/SdkOperationProgrammer.js.map +1 -1
  90. package/lib/transformers/SdkOperationTransformer.js +6 -8
  91. package/lib/transformers/SdkOperationTransformer.js.map +1 -1
  92. package/lib/transformers/TextPlainValidator.d.ts +2 -2
  93. package/lib/transformers/TextPlainValidator.js.map +1 -1
  94. package/lib/utils/MetadataUtil.d.ts +2 -2
  95. package/lib/utils/MetadataUtil.js.map +1 -1
  96. package/lib/validators/HttpHeadersValidator.d.ts +2 -3
  97. package/lib/validators/HttpHeadersValidator.js +2 -2
  98. package/lib/validators/HttpHeadersValidator.js.map +1 -1
  99. package/lib/validators/HttpQueryValidator.d.ts +2 -3
  100. package/lib/validators/HttpQueryValidator.js +2 -2
  101. package/lib/validators/HttpQueryValidator.js.map +1 -1
  102. package/package.json +44 -30
  103. package/src/INestiaConfig.ts +267 -267
  104. package/src/NestiaSdkApplication.ts +307 -307
  105. package/src/NestiaSwaggerComposer.ts +143 -138
  106. package/src/analyses/AccessorAnalyzer.ts +67 -67
  107. package/src/analyses/DtoAnalyzer.ts +260 -260
  108. package/src/analyses/ImportAnalyzer.ts +126 -126
  109. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  110. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +72 -71
  111. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +350 -348
  112. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +126 -127
  113. package/src/analyses/TypedHttpRouteAnalyzer.ts +208 -204
  114. package/src/executable/internal/NestiaConfigLoader.ts +85 -78
  115. package/src/executable/internal/NestiaSdkCommand.ts +107 -103
  116. package/src/generates/SwaggerGenerator.ts +291 -284
  117. package/src/generates/internal/E2eFileProgrammer.ts +196 -197
  118. package/src/generates/internal/FilePrinter.ts +64 -64
  119. package/src/generates/internal/ImportDictionary.ts +192 -192
  120. package/src/generates/internal/SdkAliasCollection.ts +260 -261
  121. package/src/generates/internal/SdkFileProgrammer.ts +110 -110
  122. package/src/generates/internal/SdkHttpCloneProgrammer.ts +126 -124
  123. package/src/generates/internal/SdkHttpCloneReferencer.ts +77 -77
  124. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +278 -279
  125. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +502 -500
  126. package/src/generates/internal/SdkHttpRouteProgrammer.ts +109 -108
  127. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +312 -310
  128. package/src/generates/internal/SdkImportWizard.ts +62 -62
  129. package/src/generates/internal/SdkTypeProgrammer.ts +388 -385
  130. package/src/generates/internal/SdkTypeTagProgrammer.ts +114 -104
  131. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +379 -381
  132. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +302 -302
  133. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  134. package/src/generates/internal/SwaggerOperationParameterComposer.ts +161 -162
  135. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  136. package/src/module.ts +4 -3
  137. package/src/structures/IReflectHttpOperationException.ts +18 -19
  138. package/src/structures/IReflectHttpOperationParameter.ts +79 -77
  139. package/src/structures/IReflectHttpOperationSuccess.ts +21 -22
  140. package/src/structures/ITypedApplication.ts +11 -11
  141. package/src/structures/ITypedHttpRouteException.ts +15 -15
  142. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  143. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  144. package/src/transformers/IOperationMetadata.ts +46 -44
  145. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  146. package/src/transformers/SdkOperationProgrammer.ts +240 -238
  147. package/src/transformers/SdkOperationTransformer.ts +248 -252
  148. package/src/transformers/TextPlainValidator.ts +17 -17
  149. package/src/utils/MetadataUtil.ts +26 -26
  150. package/src/validators/HttpHeadersValidator.ts +36 -34
  151. package/src/validators/HttpQueryValidator.ts +36 -34
@@ -1,192 +1,192 @@
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
- if (elem === "WebSocketAcceptor") continue;
45
- this.internal({
46
- type: "element",
47
- file: imp.file,
48
- name: elem,
49
- declaration: true,
50
- });
51
- }
52
- }
53
- }
54
-
55
- public external(props: ImportDictionary.IProps): string {
56
- const file: string = `node_modules/${props.file}`;
57
- return this.internal({
58
- ...props,
59
- file,
60
- });
61
- }
62
-
63
- public internal(props: ImportDictionary.IProps): string {
64
- const file: string = normalize(
65
- (() => {
66
- if (props.file.substring(props.file.length - 5) === ".d.ts")
67
- return props.file.substring(0, props.file.length - 5);
68
- else if (props.file.substring(props.file.length - 3) === ".ts")
69
- return props.file.substring(0, props.file.length - 3);
70
- return props.file;
71
- })(),
72
- );
73
- const key: ICompositeKey = {
74
- file: file,
75
- declaration: props.declaration,
76
- asterisk: props.type === "asterisk" ? props.name : null,
77
- default: props.type === "default" ? props.name : null,
78
- };
79
- const value: ICompositeValue = this.components_.take(key, () => ({
80
- ...key,
81
- elements: new TreeSet<string>(),
82
- }));
83
- if (props.type === "element") value.elements.insert(props.name);
84
- return props.name;
85
- }
86
-
87
- public toStatements(outDir: string): ts.Statement[] {
88
- outDir = path.resolve(outDir);
89
-
90
- const external: ts.ImportDeclaration[] = [];
91
- const internal: ts.ImportDeclaration[] = [];
92
- const locator = (str: string) => {
93
- const location: string = path
94
- .relative(outDir, str)
95
- .split(path.sep)
96
- .join("/");
97
- const index: number = location.lastIndexOf(NODE_MODULES);
98
- return index === -1
99
- ? location.startsWith("..")
100
- ? location
101
- : `./${location}`
102
- : location.substring(index + NODE_MODULES.length);
103
- };
104
- const enroll =
105
- (filter: (str: string) => boolean) =>
106
- (container: ts.ImportDeclaration[]) => {
107
- const compositions: ICompositeValue[] = this.components_
108
- .toJSON()
109
- .filter((c) => filter(c.second.file))
110
- .map(
111
- (e) =>
112
- ({
113
- ...e.second,
114
- file: locator(e.second.file),
115
- }) satisfies ICompositeValue,
116
- )
117
- .sort((a, b) => a.file.localeCompare(b.file));
118
- for (const c of compositions)
119
- container.push(
120
- ts.factory.createImportDeclaration(
121
- undefined,
122
- this.toImportClaude(c),
123
- ts.factory.createStringLiteral(c.file),
124
- undefined,
125
- ),
126
- );
127
- };
128
-
129
- enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
130
- enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
131
- return [
132
- ...external,
133
- ...(external.length && internal.length ? [FilePrinter.enter()] : []),
134
- ...internal,
135
- ];
136
- }
137
-
138
- private toImportClaude(c: ICompositeValue): ts.ImportClause {
139
- if (c.asterisk !== null)
140
- return ts.factory.createImportClause(
141
- c.declaration,
142
- undefined,
143
- ts.factory.createNamespaceImport(
144
- ts.factory.createIdentifier(c.asterisk),
145
- ),
146
- );
147
- return ts.factory.createImportClause(
148
- c.declaration,
149
- c.default !== null ? ts.factory.createIdentifier(c.default) : undefined,
150
- c.elements.size() !== 0
151
- ? ts.factory.createNamedImports(
152
- Array.from(c.elements).map((elem) =>
153
- ts.factory.createImportSpecifier(
154
- false,
155
- undefined,
156
- ts.factory.createIdentifier(elem),
157
- ),
158
- ),
159
- )
160
- : undefined,
161
- );
162
- }
163
- }
164
- export namespace ImportDictionary {
165
- export interface IProps {
166
- type: "default" | "element" | "asterisk";
167
- file: string;
168
- name: string;
169
- declaration: boolean;
170
- }
171
- }
172
-
173
- interface ICompositeKey {
174
- file: string;
175
- declaration: boolean;
176
- asterisk: string | null;
177
- default: string | null;
178
- }
179
- interface ICompositeValue extends ICompositeKey {
180
- elements: TreeSet<string>;
181
- }
182
-
183
- const NODE_MODULES = "node_modules/";
184
-
185
- const normalize = (file: string): string => {
186
- file = path.resolve(file);
187
- if (file.includes(`node_modules${path.sep}`))
188
- file =
189
- "node_modules/" +
190
- file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
191
- return file;
192
- };
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
+ if (elem === "WebSocketAcceptor") continue;
45
+ this.internal({
46
+ type: "element",
47
+ file: imp.file,
48
+ name: elem,
49
+ declaration: true,
50
+ });
51
+ }
52
+ }
53
+ }
54
+
55
+ public external(props: ImportDictionary.IProps): string {
56
+ const file: string = `node_modules/${props.file}`;
57
+ return this.internal({
58
+ ...props,
59
+ file,
60
+ });
61
+ }
62
+
63
+ public internal(props: ImportDictionary.IProps): string {
64
+ const file: string = normalize(
65
+ (() => {
66
+ if (props.file.substring(props.file.length - 5) === ".d.ts")
67
+ return props.file.substring(0, props.file.length - 5);
68
+ else if (props.file.substring(props.file.length - 3) === ".ts")
69
+ return props.file.substring(0, props.file.length - 3);
70
+ return props.file;
71
+ })(),
72
+ );
73
+ const key: ICompositeKey = {
74
+ file: file,
75
+ declaration: props.declaration,
76
+ asterisk: props.type === "asterisk" ? props.name : null,
77
+ default: props.type === "default" ? props.name : null,
78
+ };
79
+ const value: ICompositeValue = this.components_.take(key, () => ({
80
+ ...key,
81
+ elements: new TreeSet<string>(),
82
+ }));
83
+ if (props.type === "element") value.elements.insert(props.name);
84
+ return props.name;
85
+ }
86
+
87
+ public toStatements(outDir: string): ts.Statement[] {
88
+ outDir = path.resolve(outDir);
89
+
90
+ const external: ts.ImportDeclaration[] = [];
91
+ const internal: ts.ImportDeclaration[] = [];
92
+ const locator = (str: string) => {
93
+ const location: string = path
94
+ .relative(outDir, str)
95
+ .split(path.sep)
96
+ .join("/");
97
+ const index: number = location.lastIndexOf(NODE_MODULES);
98
+ return index === -1
99
+ ? location.startsWith("..")
100
+ ? location
101
+ : `./${location}`
102
+ : location.substring(index + NODE_MODULES.length);
103
+ };
104
+ const enroll =
105
+ (filter: (str: string) => boolean) =>
106
+ (container: ts.ImportDeclaration[]) => {
107
+ const compositions: ICompositeValue[] = this.components_
108
+ .toJSON()
109
+ .filter((c) => filter(c.second.file))
110
+ .map(
111
+ (e) =>
112
+ ({
113
+ ...e.second,
114
+ file: locator(e.second.file),
115
+ }) satisfies ICompositeValue,
116
+ )
117
+ .sort((a, b) => a.file.localeCompare(b.file));
118
+ for (const c of compositions)
119
+ container.push(
120
+ ts.factory.createImportDeclaration(
121
+ undefined,
122
+ this.toImportClaude(c),
123
+ ts.factory.createStringLiteral(c.file),
124
+ undefined,
125
+ ),
126
+ );
127
+ };
128
+
129
+ enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
130
+ enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
131
+ return [
132
+ ...external,
133
+ ...(external.length && internal.length ? [FilePrinter.enter()] : []),
134
+ ...internal,
135
+ ];
136
+ }
137
+
138
+ private toImportClaude(c: ICompositeValue): ts.ImportClause {
139
+ if (c.asterisk !== null)
140
+ return ts.factory.createImportClause(
141
+ c.declaration,
142
+ undefined,
143
+ ts.factory.createNamespaceImport(
144
+ ts.factory.createIdentifier(c.asterisk),
145
+ ),
146
+ );
147
+ return ts.factory.createImportClause(
148
+ c.declaration,
149
+ c.default !== null ? ts.factory.createIdentifier(c.default) : undefined,
150
+ c.elements.size() !== 0
151
+ ? ts.factory.createNamedImports(
152
+ Array.from(c.elements).map((elem) =>
153
+ ts.factory.createImportSpecifier(
154
+ false,
155
+ undefined,
156
+ ts.factory.createIdentifier(elem),
157
+ ),
158
+ ),
159
+ )
160
+ : undefined,
161
+ );
162
+ }
163
+ }
164
+ export namespace ImportDictionary {
165
+ export interface IProps {
166
+ type: "default" | "element" | "asterisk";
167
+ file: string;
168
+ name: string;
169
+ declaration: boolean;
170
+ }
171
+ }
172
+
173
+ interface ICompositeKey {
174
+ file: string;
175
+ declaration: boolean;
176
+ asterisk: string | null;
177
+ default: string | null;
178
+ }
179
+ interface ICompositeValue extends ICompositeKey {
180
+ elements: TreeSet<string>;
181
+ }
182
+
183
+ const NODE_MODULES = "node_modules/";
184
+
185
+ const normalize = (file: string): string => {
186
+ file = path.resolve(file);
187
+ if (file.includes(`node_modules${path.sep}`))
188
+ file =
189
+ "node_modules/" +
190
+ file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
191
+ return file;
192
+ };