@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.
- package/LICENSE +21 -21
- package/README.md +93 -93
- package/assets/bundle/api/HttpError.ts +1 -1
- package/assets/bundle/api/IConnection.ts +1 -1
- package/assets/bundle/api/Primitive.ts +1 -1
- package/assets/bundle/api/Resolved.ts +1 -1
- package/assets/bundle/api/index.ts +4 -4
- package/assets/bundle/api/module.ts +6 -6
- package/assets/bundle/distribute/README.md +37 -37
- package/assets/bundle/distribute/package.json +28 -28
- package/assets/bundle/distribute/tsconfig.json +109 -109
- package/assets/bundle/e2e/index.ts +42 -42
- package/assets/config/nestia.config.ts +97 -97
- package/lib/executable/internal/NestiaConfigLoader.js +5 -5
- package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
- package/package.json +8 -8
- package/src/INestiaConfig.ts +267 -267
- package/src/NestiaSdkApplication.ts +307 -307
- package/src/NestiaSwaggerComposer.ts +143 -143
- package/src/analyses/AccessorAnalyzer.ts +67 -67
- package/src/analyses/DtoAnalyzer.ts +260 -260
- package/src/analyses/ImportAnalyzer.ts +126 -126
- package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
- package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +72 -72
- package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +350 -350
- package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +126 -126
- package/src/analyses/TypedHttpRouteAnalyzer.ts +208 -208
- package/src/executable/internal/NestiaConfigLoader.ts +85 -85
- package/src/executable/internal/NestiaSdkCommand.ts +107 -107
- package/src/generates/SwaggerGenerator.ts +291 -291
- package/src/generates/internal/E2eFileProgrammer.ts +196 -196
- package/src/generates/internal/FilePrinter.ts +64 -64
- package/src/generates/internal/ImportDictionary.ts +192 -192
- package/src/generates/internal/SdkAliasCollection.ts +260 -260
- package/src/generates/internal/SdkFileProgrammer.ts +110 -110
- package/src/generates/internal/SdkHttpCloneProgrammer.ts +126 -126
- package/src/generates/internal/SdkHttpCloneReferencer.ts +77 -77
- package/src/generates/internal/SdkHttpFunctionProgrammer.ts +278 -278
- package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +502 -502
- package/src/generates/internal/SdkHttpRouteProgrammer.ts +109 -109
- package/src/generates/internal/SdkHttpSimulationProgrammer.ts +312 -312
- package/src/generates/internal/SdkImportWizard.ts +62 -62
- package/src/generates/internal/SdkTypeProgrammer.ts +388 -388
- package/src/generates/internal/SdkTypeTagProgrammer.ts +114 -114
- package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +379 -379
- package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +302 -302
- package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
- package/src/generates/internal/SwaggerOperationParameterComposer.ts +161 -161
- package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
- package/src/module.ts +4 -4
- package/src/structures/IReflectHttpOperationException.ts +18 -18
- package/src/structures/IReflectHttpOperationParameter.ts +79 -79
- package/src/structures/IReflectHttpOperationSuccess.ts +21 -21
- package/src/structures/ITypedApplication.ts +11 -11
- package/src/structures/ITypedHttpRouteException.ts +15 -15
- package/src/structures/ITypedHttpRouteParameter.ts +41 -41
- package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
- package/src/transformers/IOperationMetadata.ts +46 -46
- package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
- package/src/transformers/SdkOperationProgrammer.ts +240 -240
- package/src/transformers/SdkOperationTransformer.ts +248 -248
- package/src/transformers/TextPlainValidator.ts +17 -17
- package/src/utils/MetadataUtil.ts +26 -26
- package/src/validators/HttpHeadersValidator.ts +40 -40
- 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
|
+
};
|