@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,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
+ };