@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.
- package/LICENSE +21 -21
- package/README.md +92 -92
- 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 +4 -4
- package/lib/executable/sdk.js +12 -12
- package/package.json +5 -5
- package/src/INestiaConfig.ts +269 -269
- package/src/NestiaSdkApplication.ts +307 -307
- package/src/NestiaSwaggerComposer.ts +138 -138
- package/src/analyses/AccessorAnalyzer.ts +67 -67
- package/src/analyses/ConfigAnalyzer.ts +155 -155
- package/src/analyses/ExceptionAnalyzer.ts +154 -154
- package/src/analyses/GenericAnalyzer.ts +49 -49
- package/src/analyses/ImportAnalyzer.ts +171 -171
- package/src/analyses/PathAnalyzer.ts +69 -69
- package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
- package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
- package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +71 -71
- package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +348 -348
- package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +127 -127
- package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
- package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
- package/src/analyses/SecurityAnalyzer.ts +25 -25
- package/src/analyses/TypedHttpRouteAnalyzer.ts +204 -204
- package/src/analyses/TypedWebSocketRouteAnalyzer.ts +33 -33
- package/src/decorators/OperationMetadata.ts +15 -15
- package/src/executable/internal/CommandParser.ts +15 -15
- package/src/executable/internal/NestiaConfigLoader.ts +78 -78
- package/src/executable/internal/NestiaSdkCommand.ts +103 -103
- package/src/executable/sdk.ts +75 -75
- package/src/generates/CloneGenerator.ts +66 -66
- package/src/generates/E2eGenerator.ts +32 -32
- package/src/generates/SdkGenerator.ts +160 -160
- package/src/generates/SwaggerGenerator.ts +284 -284
- package/src/generates/internal/E2eFileProgrammer.ts +205 -205
- package/src/generates/internal/FilePrinter.ts +53 -53
- package/src/generates/internal/ImportDictionary.ts +163 -163
- package/src/generates/internal/SdkAliasCollection.ts +255 -255
- package/src/generates/internal/SdkDistributionComposer.ts +103 -103
- package/src/generates/internal/SdkFileProgrammer.ts +116 -116
- package/src/generates/internal/SdkHttpCloneProgrammer.ts +124 -124
- package/src/generates/internal/SdkHttpCloneReferencer.ts +75 -75
- package/src/generates/internal/SdkHttpFunctionProgrammer.ts +276 -276
- package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +500 -500
- package/src/generates/internal/SdkHttpParameterProgrammer.ts +178 -178
- package/src/generates/internal/SdkHttpRouteProgrammer.ts +107 -107
- package/src/generates/internal/SdkHttpSimulationProgrammer.ts +340 -340
- package/src/generates/internal/SdkImportWizard.ts +55 -55
- package/src/generates/internal/SdkRouteDirectory.ts +18 -18
- package/src/generates/internal/SdkTypeProgrammer.ts +384 -384
- package/src/generates/internal/SdkTypeTagProgrammer.ts +102 -102
- package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +366 -366
- package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +87 -87
- package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +279 -279
- package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
- package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
- package/src/generates/internal/SwaggerOperationParameterComposer.ts +177 -177
- package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
- package/src/index.ts +4 -4
- package/src/module.ts +3 -3
- package/src/structures/INestiaProject.ts +13 -13
- package/src/structures/INestiaSdkInput.ts +20 -20
- package/src/structures/IReflectApplication.ts +8 -8
- package/src/structures/IReflectController.ts +15 -15
- package/src/structures/IReflectHttpOperation.ts +26 -26
- package/src/structures/IReflectHttpOperationException.ts +19 -19
- package/src/structures/IReflectHttpOperationParameter.ts +81 -81
- package/src/structures/IReflectHttpOperationSuccess.ts +22 -22
- package/src/structures/IReflectOperationError.ts +26 -26
- package/src/structures/IReflectType.ts +4 -4
- package/src/structures/IReflectTypeImport.ts +4 -4
- package/src/structures/IReflectWebSocketOperation.ts +17 -17
- package/src/structures/IReflectWebSocketOperationParameter.ts +38 -38
- package/src/structures/ITypedApplication.ts +11 -11
- package/src/structures/ITypedHttpRoute.ts +41 -41
- package/src/structures/ITypedHttpRouteException.ts +15 -15
- package/src/structures/ITypedHttpRouteParameter.ts +41 -41
- package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
- package/src/structures/ITypedWebSocketRoute.ts +24 -24
- package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
- package/src/structures/MethodType.ts +5 -5
- package/src/structures/ParamCategory.ts +1 -1
- package/src/structures/TypeEntry.ts +22 -22
- package/src/transform.ts +9 -9
- package/src/transformers/IOperationMetadata.ts +44 -44
- package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
- package/src/transformers/SdkOperationProgrammer.ts +209 -209
- package/src/transformers/SdkOperationTransformer.ts +253 -253
- package/src/transformers/TextPlainValidator.ts +17 -17
- package/src/typings/get-function-location.d.ts +7 -7
- package/src/utils/ArrayUtil.ts +26 -26
- package/src/utils/FileRetriever.ts +22 -22
- package/src/utils/MapUtil.ts +14 -14
- package/src/utils/MetadataUtil.ts +26 -26
- package/src/utils/PathUtil.ts +10 -10
- package/src/utils/SourceFinder.ts +66 -66
- package/src/utils/StringUtil.ts +17 -17
- package/src/utils/StripEnums.ts +5 -5
- package/src/utils/VersioningStrategy.ts +28 -28
- package/src/validators/HttpHeadersValidator.ts +34 -34
- package/src/validators/HttpQueryValidator.ts +34 -34
|
@@ -1,163 +1,163 @@
|
|
|
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, 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
|
+
};
|