@nestia/sdk 11.0.0-dev.20260312 → 11.0.0-dev.20260313
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/assets/bundle/distribute/package.json +1 -1
- package/lib/INestiaConfig.d.ts +2 -2
- package/lib/NestiaSwaggerComposer.d.ts +1 -2
- package/lib/NestiaSwaggerComposer.js +6 -2
- package/lib/NestiaSwaggerComposer.js.map +1 -1
- package/lib/executable/internal/NestiaConfigLoader.js +8 -63
- package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
- package/lib/executable/sdk.js +12 -12
- package/lib/generates/SwaggerGenerator.js +6 -5
- package/lib/generates/SwaggerGenerator.js.map +1 -1
- package/package.json +8 -8
- package/src/analyses/ConfigAnalyzer.ts +155 -155
- package/src/analyses/ExceptionAnalyzer.ts +154 -154
- package/src/analyses/GenericAnalyzer.ts +49 -49
- package/src/analyses/PathAnalyzer.ts +69 -69
- package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
- package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
- package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
- package/src/analyses/SecurityAnalyzer.ts +25 -25
- 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/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/internal/SdkDistributionComposer.ts +103 -103
- package/src/generates/internal/SdkHttpParameterProgrammer.ts +178 -178
- package/src/generates/internal/SdkRouteDirectory.ts +18 -18
- package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +87 -87
- package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
- package/src/index.ts +4 -4
- 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/IReflectImport.ts +6 -6
- package/src/structures/IReflectOperationError.ts +26 -26
- package/src/structures/IReflectType.ts +4 -4
- package/src/structures/IReflectWebSocketOperation.ts +17 -17
- package/src/structures/IReflectWebSocketOperationParameter.ts +36 -36
- package/src/structures/ITypedHttpRoute.ts +41 -41
- 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/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/PathUtil.ts +10 -10
- package/src/utils/SourceFinder.ts +63 -63
- package/src/utils/StringUtil.ts +17 -17
- package/src/utils/StripEnums.ts +5 -5
- package/src/utils/VersioningStrategy.ts +28 -28
package/src/executable/sdk.ts
CHANGED
|
@@ -1,75 +1,75 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import cp from "child_process";
|
|
3
|
-
import fs from "fs";
|
|
4
|
-
import process from "process";
|
|
5
|
-
|
|
6
|
-
import { CommandParser } from "./internal/CommandParser";
|
|
7
|
-
import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
|
|
8
|
-
|
|
9
|
-
const USAGE = `Wrong command has been detected. Use like below:
|
|
10
|
-
|
|
11
|
-
npx @nestia/sdk [command] [options?]
|
|
12
|
-
|
|
13
|
-
1. npx @nestia/sdk dependencies --manager (npm|pnpm|yarn)
|
|
14
|
-
- npx @nestia/sdk dependencies
|
|
15
|
-
- npx @nestia/sdk dependencies --manager pnpm
|
|
16
|
-
2. npx @nestia/sdk init
|
|
17
|
-
3. npx @nestia/sdk sdk --config? [config file] --project? [project file]
|
|
18
|
-
4. npx @nestia/sdk swagger --config? [config file] --project? [project file]
|
|
19
|
-
5. npx @nestia/sdk e2e --config? [config file] --project? [project file]
|
|
20
|
-
6. npx @nestia/sdk generate --config? [config file] --project? [project file]
|
|
21
|
-
`;
|
|
22
|
-
|
|
23
|
-
function halt(desc: string): never {
|
|
24
|
-
console.error(desc);
|
|
25
|
-
process.exit(-1);
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
function dependencies(argv: string[]): void {
|
|
29
|
-
// INSTALL DEPENDENCIES
|
|
30
|
-
const module = CommandParser.parse(argv).module ?? "npm";
|
|
31
|
-
const prefix: string = module === "yarn" ? "yarn add" : `${module} install`;
|
|
32
|
-
|
|
33
|
-
for (const lib of ["@nestia/fetcher", "typia"]) {
|
|
34
|
-
const command: string = `${prefix} ${lib}`;
|
|
35
|
-
console.log(`\n$ ${command}`);
|
|
36
|
-
cp.execSync(command, { stdio: "inherit" });
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
async function initialize(): Promise<void> {
|
|
41
|
-
if (fs.existsSync("nestia.config.ts") === true)
|
|
42
|
-
halt(
|
|
43
|
-
`Error on nestia.sdk.initialize(): "nestia.config.ts" file already has been configured.`,
|
|
44
|
-
);
|
|
45
|
-
await fs.promises.copyFile(
|
|
46
|
-
`${__dirname}/../../assets/config/nestia.config.ts`,
|
|
47
|
-
"nestia.config.ts",
|
|
48
|
-
);
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
async function execute(
|
|
52
|
-
closure: (commander: typeof NestiaSdkCommand) => Promise<void>,
|
|
53
|
-
): Promise<void> {
|
|
54
|
-
const module = await import("./internal/NestiaSdkCommand");
|
|
55
|
-
await closure(module.NestiaSdkCommand);
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
async function main() {
|
|
59
|
-
const type: string | undefined = process.argv[2];
|
|
60
|
-
const argv: string[] = process.argv.slice(3);
|
|
61
|
-
|
|
62
|
-
if (type === "dependencies") dependencies(argv);
|
|
63
|
-
else if (type === "init") await initialize();
|
|
64
|
-
else if (type === "sdk") await execute((c) => c.sdk());
|
|
65
|
-
else if (type === "swagger") await execute((c) => c.swagger());
|
|
66
|
-
else if (type === "e2e") await execute((c) => c.e2e());
|
|
67
|
-
else if (type === "all") await execute((c) => c.all());
|
|
68
|
-
else halt(USAGE);
|
|
69
|
-
|
|
70
|
-
process.exit(0);
|
|
71
|
-
}
|
|
72
|
-
main().catch((exp) => {
|
|
73
|
-
console.log(exp);
|
|
74
|
-
process.exit(-1);
|
|
75
|
-
});
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import cp from "child_process";
|
|
3
|
+
import fs from "fs";
|
|
4
|
+
import process from "process";
|
|
5
|
+
|
|
6
|
+
import { CommandParser } from "./internal/CommandParser";
|
|
7
|
+
import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
|
|
8
|
+
|
|
9
|
+
const USAGE = `Wrong command has been detected. Use like below:
|
|
10
|
+
|
|
11
|
+
npx @nestia/sdk [command] [options?]
|
|
12
|
+
|
|
13
|
+
1. npx @nestia/sdk dependencies --manager (npm|pnpm|yarn)
|
|
14
|
+
- npx @nestia/sdk dependencies
|
|
15
|
+
- npx @nestia/sdk dependencies --manager pnpm
|
|
16
|
+
2. npx @nestia/sdk init
|
|
17
|
+
3. npx @nestia/sdk sdk --config? [config file] --project? [project file]
|
|
18
|
+
4. npx @nestia/sdk swagger --config? [config file] --project? [project file]
|
|
19
|
+
5. npx @nestia/sdk e2e --config? [config file] --project? [project file]
|
|
20
|
+
6. npx @nestia/sdk generate --config? [config file] --project? [project file]
|
|
21
|
+
`;
|
|
22
|
+
|
|
23
|
+
function halt(desc: string): never {
|
|
24
|
+
console.error(desc);
|
|
25
|
+
process.exit(-1);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function dependencies(argv: string[]): void {
|
|
29
|
+
// INSTALL DEPENDENCIES
|
|
30
|
+
const module = CommandParser.parse(argv).module ?? "npm";
|
|
31
|
+
const prefix: string = module === "yarn" ? "yarn add" : `${module} install`;
|
|
32
|
+
|
|
33
|
+
for (const lib of ["@nestia/fetcher", "typia"]) {
|
|
34
|
+
const command: string = `${prefix} ${lib}`;
|
|
35
|
+
console.log(`\n$ ${command}`);
|
|
36
|
+
cp.execSync(command, { stdio: "inherit" });
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
async function initialize(): Promise<void> {
|
|
41
|
+
if (fs.existsSync("nestia.config.ts") === true)
|
|
42
|
+
halt(
|
|
43
|
+
`Error on nestia.sdk.initialize(): "nestia.config.ts" file already has been configured.`,
|
|
44
|
+
);
|
|
45
|
+
await fs.promises.copyFile(
|
|
46
|
+
`${__dirname}/../../assets/config/nestia.config.ts`,
|
|
47
|
+
"nestia.config.ts",
|
|
48
|
+
);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
async function execute(
|
|
52
|
+
closure: (commander: typeof NestiaSdkCommand) => Promise<void>,
|
|
53
|
+
): Promise<void> {
|
|
54
|
+
const module = await import("./internal/NestiaSdkCommand");
|
|
55
|
+
await closure(module.NestiaSdkCommand);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
async function main() {
|
|
59
|
+
const type: string | undefined = process.argv[2];
|
|
60
|
+
const argv: string[] = process.argv.slice(3);
|
|
61
|
+
|
|
62
|
+
if (type === "dependencies") dependencies(argv);
|
|
63
|
+
else if (type === "init") await initialize();
|
|
64
|
+
else if (type === "sdk") await execute((c) => c.sdk());
|
|
65
|
+
else if (type === "swagger") await execute((c) => c.swagger());
|
|
66
|
+
else if (type === "e2e") await execute((c) => c.e2e());
|
|
67
|
+
else if (type === "all") await execute((c) => c.all());
|
|
68
|
+
else halt(USAGE);
|
|
69
|
+
|
|
70
|
+
process.exit(0);
|
|
71
|
+
}
|
|
72
|
+
main().catch((exp) => {
|
|
73
|
+
console.log(exp);
|
|
74
|
+
process.exit(-1);
|
|
75
|
+
});
|
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
import fs from "fs";
|
|
2
|
-
import ts from "typescript";
|
|
3
|
-
|
|
4
|
-
import { INestiaProject } from "../structures/INestiaProject";
|
|
5
|
-
import { ITypedApplication } from "../structures/ITypedApplication";
|
|
6
|
-
import { FilePrinter } from "./internal/FilePrinter";
|
|
7
|
-
import { ImportDictionary } from "./internal/ImportDictionary";
|
|
8
|
-
import { SdkHttpCloneProgrammer } from "./internal/SdkHttpCloneProgrammer";
|
|
9
|
-
import { SdkHttpCloneReferencer } from "./internal/SdkHttpCloneReferencer";
|
|
10
|
-
|
|
11
|
-
export namespace CloneGenerator {
|
|
12
|
-
export const write = async (app: ITypedApplication): Promise<void> => {
|
|
13
|
-
const dict: Map<string, SdkHttpCloneProgrammer.IModule> =
|
|
14
|
-
SdkHttpCloneProgrammer.write(app);
|
|
15
|
-
if (dict.size === 0) return;
|
|
16
|
-
|
|
17
|
-
SdkHttpCloneReferencer.replace(app);
|
|
18
|
-
try {
|
|
19
|
-
await fs.promises.mkdir(`${app.project.config.output}/structures`);
|
|
20
|
-
} catch {}
|
|
21
|
-
for (const [key, value] of dict)
|
|
22
|
-
await writeDtoFile(app.project)(key, value);
|
|
23
|
-
};
|
|
24
|
-
|
|
25
|
-
const writeDtoFile =
|
|
26
|
-
(project: INestiaProject) =>
|
|
27
|
-
async (
|
|
28
|
-
key: string,
|
|
29
|
-
value: SdkHttpCloneProgrammer.IModule,
|
|
30
|
-
): Promise<void> => {
|
|
31
|
-
const location: string = `${project.config.output}/structures/${key}.ts`;
|
|
32
|
-
const importer: ImportDictionary = new ImportDictionary(location);
|
|
33
|
-
const statements: ts.Statement[] = iterate(importer)(value);
|
|
34
|
-
if (statements.length === 0) return;
|
|
35
|
-
|
|
36
|
-
await FilePrinter.write({
|
|
37
|
-
location,
|
|
38
|
-
statements: [
|
|
39
|
-
...importer.toStatements(`${project.config.output}/structures`),
|
|
40
|
-
...(importer.empty() ? [] : [FilePrinter.enter()]),
|
|
41
|
-
...statements,
|
|
42
|
-
],
|
|
43
|
-
});
|
|
44
|
-
};
|
|
45
|
-
|
|
46
|
-
const iterate =
|
|
47
|
-
(importer: ImportDictionary) =>
|
|
48
|
-
(modulo: SdkHttpCloneProgrammer.IModule): ts.Statement[] => {
|
|
49
|
-
const output: ts.Statement[] = [];
|
|
50
|
-
if (modulo.programmer !== null) output.push(modulo.programmer(importer));
|
|
51
|
-
if (modulo.children.size) {
|
|
52
|
-
const internal: ts.Statement[] = [];
|
|
53
|
-
for (const child of modulo.children.values())
|
|
54
|
-
internal.push(...iterate(importer)(child));
|
|
55
|
-
output.push(
|
|
56
|
-
ts.factory.createModuleDeclaration(
|
|
57
|
-
[ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
|
|
58
|
-
ts.factory.createIdentifier(modulo.name),
|
|
59
|
-
ts.factory.createModuleBlock(internal),
|
|
60
|
-
ts.NodeFlags.Namespace,
|
|
61
|
-
),
|
|
62
|
-
);
|
|
63
|
-
}
|
|
64
|
-
return output;
|
|
65
|
-
};
|
|
66
|
-
}
|
|
1
|
+
import fs from "fs";
|
|
2
|
+
import ts from "typescript";
|
|
3
|
+
|
|
4
|
+
import { INestiaProject } from "../structures/INestiaProject";
|
|
5
|
+
import { ITypedApplication } from "../structures/ITypedApplication";
|
|
6
|
+
import { FilePrinter } from "./internal/FilePrinter";
|
|
7
|
+
import { ImportDictionary } from "./internal/ImportDictionary";
|
|
8
|
+
import { SdkHttpCloneProgrammer } from "./internal/SdkHttpCloneProgrammer";
|
|
9
|
+
import { SdkHttpCloneReferencer } from "./internal/SdkHttpCloneReferencer";
|
|
10
|
+
|
|
11
|
+
export namespace CloneGenerator {
|
|
12
|
+
export const write = async (app: ITypedApplication): Promise<void> => {
|
|
13
|
+
const dict: Map<string, SdkHttpCloneProgrammer.IModule> =
|
|
14
|
+
SdkHttpCloneProgrammer.write(app);
|
|
15
|
+
if (dict.size === 0) return;
|
|
16
|
+
|
|
17
|
+
SdkHttpCloneReferencer.replace(app);
|
|
18
|
+
try {
|
|
19
|
+
await fs.promises.mkdir(`${app.project.config.output}/structures`);
|
|
20
|
+
} catch {}
|
|
21
|
+
for (const [key, value] of dict)
|
|
22
|
+
await writeDtoFile(app.project)(key, value);
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
const writeDtoFile =
|
|
26
|
+
(project: INestiaProject) =>
|
|
27
|
+
async (
|
|
28
|
+
key: string,
|
|
29
|
+
value: SdkHttpCloneProgrammer.IModule,
|
|
30
|
+
): Promise<void> => {
|
|
31
|
+
const location: string = `${project.config.output}/structures/${key}.ts`;
|
|
32
|
+
const importer: ImportDictionary = new ImportDictionary(location);
|
|
33
|
+
const statements: ts.Statement[] = iterate(importer)(value);
|
|
34
|
+
if (statements.length === 0) return;
|
|
35
|
+
|
|
36
|
+
await FilePrinter.write({
|
|
37
|
+
location,
|
|
38
|
+
statements: [
|
|
39
|
+
...importer.toStatements(`${project.config.output}/structures`),
|
|
40
|
+
...(importer.empty() ? [] : [FilePrinter.enter()]),
|
|
41
|
+
...statements,
|
|
42
|
+
],
|
|
43
|
+
});
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
const iterate =
|
|
47
|
+
(importer: ImportDictionary) =>
|
|
48
|
+
(modulo: SdkHttpCloneProgrammer.IModule): ts.Statement[] => {
|
|
49
|
+
const output: ts.Statement[] = [];
|
|
50
|
+
if (modulo.programmer !== null) output.push(modulo.programmer(importer));
|
|
51
|
+
if (modulo.children.size) {
|
|
52
|
+
const internal: ts.Statement[] = [];
|
|
53
|
+
for (const child of modulo.children.values())
|
|
54
|
+
internal.push(...iterate(importer)(child));
|
|
55
|
+
output.push(
|
|
56
|
+
ts.factory.createModuleDeclaration(
|
|
57
|
+
[ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
|
|
58
|
+
ts.factory.createIdentifier(modulo.name),
|
|
59
|
+
ts.factory.createModuleBlock(internal),
|
|
60
|
+
ts.NodeFlags.Namespace,
|
|
61
|
+
),
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
return output;
|
|
65
|
+
};
|
|
66
|
+
}
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
import fs from "fs";
|
|
2
|
-
import path from "path";
|
|
3
|
-
|
|
4
|
-
import { ITypedApplication } from "../structures/ITypedApplication";
|
|
5
|
-
import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
|
|
6
|
-
|
|
7
|
-
export namespace E2eGenerator {
|
|
8
|
-
export const generate = async (app: ITypedApplication): Promise<void> => {
|
|
9
|
-
console.log("Generating E2E Test Functions");
|
|
10
|
-
|
|
11
|
-
// PREPARE DIRECTORIES
|
|
12
|
-
const output: string = path.resolve(app.project.config.e2e!);
|
|
13
|
-
await mkdir(output);
|
|
14
|
-
await mkdir(path.join(output, "features"));
|
|
15
|
-
await mkdir(path.join(output, "features", "api"));
|
|
16
|
-
await mkdir(path.join(output, "features", "api", "automated"));
|
|
17
|
-
|
|
18
|
-
// GENERATE EACH TEST FILES
|
|
19
|
-
for (const route of app.routes)
|
|
20
|
-
if (route.protocol === "http")
|
|
21
|
-
await E2eFileProgrammer.generate(app.project)({
|
|
22
|
-
api: path.resolve(app.project.config.output!),
|
|
23
|
-
current: path.join(output, "features", "api", "automated"),
|
|
24
|
-
})(route);
|
|
25
|
-
};
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
const mkdir = async (location: string): Promise<void> => {
|
|
29
|
-
try {
|
|
30
|
-
await fs.promises.mkdir(location);
|
|
31
|
-
} catch {}
|
|
32
|
-
};
|
|
1
|
+
import fs from "fs";
|
|
2
|
+
import path from "path";
|
|
3
|
+
|
|
4
|
+
import { ITypedApplication } from "../structures/ITypedApplication";
|
|
5
|
+
import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
|
|
6
|
+
|
|
7
|
+
export namespace E2eGenerator {
|
|
8
|
+
export const generate = async (app: ITypedApplication): Promise<void> => {
|
|
9
|
+
console.log("Generating E2E Test Functions");
|
|
10
|
+
|
|
11
|
+
// PREPARE DIRECTORIES
|
|
12
|
+
const output: string = path.resolve(app.project.config.e2e!);
|
|
13
|
+
await mkdir(output);
|
|
14
|
+
await mkdir(path.join(output, "features"));
|
|
15
|
+
await mkdir(path.join(output, "features", "api"));
|
|
16
|
+
await mkdir(path.join(output, "features", "api", "automated"));
|
|
17
|
+
|
|
18
|
+
// GENERATE EACH TEST FILES
|
|
19
|
+
for (const route of app.routes)
|
|
20
|
+
if (route.protocol === "http")
|
|
21
|
+
await E2eFileProgrammer.generate(app.project)({
|
|
22
|
+
api: path.resolve(app.project.config.output!),
|
|
23
|
+
current: path.join(output, "features", "api", "automated"),
|
|
24
|
+
})(route);
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
const mkdir = async (location: string): Promise<void> => {
|
|
29
|
+
try {
|
|
30
|
+
await fs.promises.mkdir(location);
|
|
31
|
+
} catch {}
|
|
32
|
+
};
|