@nestia/sdk 2.0.0-dev.20230991 → 2.0.1

package/lib/structures/IRoute.d.ts

@@ -1,4 +1,5 @@
 import ts from "typescript";
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
 import { IController } from "./IController";
 export interface IRoute {
     name: string;
@@ -11,10 +12,13 @@ export interface IRoute {
     imports: [string, string[]][];
     output: IRoute.IOutput;
     location: string;
-    symbol: string;
+    symbol: {
+        class: string;
+        function: string;
+    };
     description?: string;
     operationId?: string;
-    tags: ts.JSDocTagInfo[];
+    jsDocTags: ts.JSDocTagInfo[];
     setHeaders: Array<{
         type: "setter";
         source: string;
@@ -25,16 +29,19 @@ export interface IRoute {
     }>;
     security: Record<string, string[]>[];
     exceptions: Record<number | "2XX" | "3XX" | "4XX" | "5XX", IRoute.IOutput>;
+    swaggerTags: string[];
 }
 export declare namespace IRoute {
     type IParameter = IController.IParameter & {
         optional: boolean;
         type: ts.Type;
         typeName: string;
+        metadata?: Metadata;
     };
     interface IOutput {
         type: ts.Type;
         typeName: string;
+        metadata?: Metadata;
         description?: string;
         contentType: "application/json" | "text/plain";
     }

package/lib/utils/ImportDictionary.d.ts

@@ -1,6 +1,5 @@
 export declare class ImportDictionary {
-    private readonly externals_;
-    private readonly internals_;
+    private readonly components_;
     empty(): boolean;
     external(props: ImportDictionary.IExternalProps): string;
     internal(props: ImportDictionary.IInternalProps): string;

package/lib/utils/ImportDictionary.js

@@ -10,16 +10,15 @@ const HashSet_1 = require("tstl/container/HashSet");
 const Pair_1 = require("tstl/utility/Pair");
 class ImportDictionary {
     constructor() {
-        this.externals_ = new HashMap_1.HashMap();
-        this.internals_ = new HashMap_1.HashMap();
+        this.components_ = new HashMap_1.HashMap();
     }
     empty() {
-        return this.internals_.empty() && this.externals_.empty();
+        return this.components_.empty();
     }
     external(props) {
         var _a;
-        const composition = this.externals_.take(new Pair_1.Pair(props.library, props.type), () => ({
-            location: props.library,
+        const composition = this.components_.take(new Pair_1.Pair(props.library, props.type), () => ({
+            location: `node_modules/${props.library}`,
             elements: new HashSet_1.HashSet(),
             default: false,
             type: props.type,
@@ -39,7 +38,7 @@ class ImportDictionary {
                 return props.file.substring(0, props.file.length - 3);
             return props.file;
         })();
-        const composition = this.internals_.take(new Pair_1.Pair(file, props.type), () => ({
+        const composition = this.components_.take(new Pair_1.Pair(file, props.type), () => ({
             location: file,
             elements: new HashSet_1.HashSet(),
             default: false,
@@ -55,11 +54,25 @@ class ImportDictionary {
         return (_a = props.instance) !== null && _a !== void 0 ? _a : file;
     }
     toScript(outDir) {
-        const statements = [];
-        const enroll = (locator) => (dict) => {
+        const external = [];
+        const internal = [];
+        const locator = (str) => {
+            const location = path_1.default
+                .relative(outDir, str)
+                .split("\\")
+                .join("/");
+            const index = location.lastIndexOf(NODE_MODULES);
+            return index === -1
+                ? location.startsWith("..")
+                    ? location
+                    : `./${location}`
+                : location.substring(index + NODE_MODULES.length);
+        };
+        const enroll = (filter) => (container) => {
             var _a;
-            const compositions = dict
+            const compositions = this.components_
                 .toJSON()
+                .filter((c) => filter(c.second.location))
                 .map((e) => (Object.assign(Object.assign({}, e.second), { location: locator(e.second.location) })))
                 .sort((a, b) => a.location.localeCompare(b.location));
             for (const c of compositions) {
@@ -71,23 +84,14 @@ class ImportDictionary {
                         .toJSON()
                         .sort((a, b) => a.localeCompare(b))
                         .join(", ")} }`);
-                statements.push(`import ${c.type ? "type " : ""}${brackets.join(", ")} from "${c.location}";`);
+                container.push(`import ${c.type ? "type " : ""}${brackets.join(", ")} from "${c.location}";`);
             }
         };
-        enroll((str) => str)(this.externals_);
-        if (!this.externals_.empty() && !this.internals_.empty())
-            statements.push("");
-        enroll((str) => {
-            const location = path_1.default
-                .relative(outDir, str)
-                .split("\\")
-                .join("/");
-            const index = location.lastIndexOf(NODE_MODULES);
-            return index === -1
-                ? `./${location}`
-                : location.substring(index + NODE_MODULES.length);
-        })(this.internals_);
-        return statements.join("\n");
+        enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
+        enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
+        if (external.length && internal.length)
+            external.push("");
+        return [...external, ...internal].join("\n");
     }
 }
 exports.ImportDictionary = ImportDictionary;

package/lib/utils/ImportDictionary.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImportDictionary.js","sourceRoot":"","sources":["../../src/utils/ImportDictionary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ImportDictionary.js","sourceRoot":"","sources":["../../src/utils/ImportDictionary.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/sdk",
-  "version": "2.0.0-dev.20230991",
+  "version": "2.0.1",
   "description": "Nestia SDK and Swagger generator",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -35,25 +35,25 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@nestia/fetcher": "^2.0.0-dev.20230991",
+    "@nestia/fetcher": "^2.0.1",
     "cli": "^1.0.1",
     "glob": "^7.2.0",
     "path-to-regexp": "^6.2.1",
-    "reflect-metadata": ">= 0.1.12",
-    "tgrid": "^0.8.7",
+    "reflect-metadata": ">=0.1.12",
+    "tgrid": "^0.8.8",
     "tsconfck": "^2.0.1",
     "tsconfig-paths": "^4.1.1",
     "tstl": "^2.5.13",
-    "typia": "^5.0.1"
+    "typia": "^5.0.2"
   },
   "peerDependencies": {
-    "@nestia/fetcher": ">=2.0.0-dev.20230991",
+    "@nestia/fetcher": ">=2.0.1",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",
     "ts-node": ">=10.6.0",
     "typescript": ">=4.8.0",
-    "typia": ">=5.0.1 <6.0.0"
+    "typia": ">=5.0.2 <6.0.0"
   },
   "devDependencies": {
     "@nestjs/common": ">= 7.0.1",
@@ -73,7 +73,7 @@
     "rimraf": "^3.0.2",
     "ts-node": "^10.9.1",
     "ts-patch": "v3.0.2",
-    "typescript": "^5.1.3",
+    "typescript": "^5.2.2",
     "typescript-transform-paths": "^3.4.4",
     "uuid": "^9.0.0"
   },

package/src/INestiaConfig.ts

@@ -1,9 +1,6 @@
-import type ts from "typescript";
-
 import type { ISwagger } from "./structures/ISwagger";
-import { ISwaggerInfo } from "./structures/ISwaggerInfo";
-import { ISwaggerSecurityScheme } from "./structures/ISwaggerSecurityScheme";
-import type { StripEnums } from "./utils/StripEnums";
+import type { ISwaggerInfo } from "./structures/ISwaggerInfo";
+import type { ISwaggerSecurityScheme } from "./structures/ISwaggerSecurityScheme";
 
 /**
  * Definition for the `nestia.config.ts` file.
@@ -44,6 +41,21 @@ export interface INestiaConfig {
      */
     distribute?: string;
 
+    /**
+     * Allow simulation mode.
+     *
+     * If you configure this property to be `true`, the SDK library would be contain
+     * simulation mode. In the simulation mode, the SDK library would not communicate
+     * with the real backend server, but just returns random mock-up data
+     * with requestion data validation.
+     *
+     * For reference, random mock-up data would be generated by `typia.random<T>()`
+     * function.
+     *
+     * @default false
+     */
+    simulate?: boolean;
+
     /**
      * Target directory that e2e test functions would be placed in.
      *
@@ -56,26 +68,52 @@ export interface INestiaConfig {
     e2e?: string;
 
     /**
-     * Compiler options for the TypeScript.
+     * Whether to use propagation mode or not.
+     *
+     * If being configured, interaction functions of the SDK library would
+     * perform the propagation mode. The propagation mode means that never
+     * throwing exception even when status code is not 200 (or 201), but just
+     * returning the {@link IPropagation} typed instance, which can specify its body
+     * type through discriminated union determined by status code.
+     *
+     * @default false
+     */
+    propagate?: boolean;
+
+    /**
+     * Whether to clone DTO structures or not.
+     *
+     * If being configured, all of DTOs used in the backend server would be cloned
+     * into the `structures` directory, and the SDK library would be refer to the
+     * cloned DTOs instead of the original.
+     *
+     * @default false
+     */
+    clone?: boolean;
+
+    /**
+     * Whether to wrap DTO by primitive type.
+     *
+     * If you don't configure this property as `false`, all of DTOs in the
+     * SDK library would be automatically wrapped by {@link Primitive} type.
      *
-     * If you've omitted this property or the assigned property cannot fully cover the
-     * `tsconfig.json`, the properties from the `tsconfig.json` would be assigned to here.
-     * Otherwise, this property has been configured and it's detailed values are different
-     * with the `tsconfig.json`, this property values would be used instead.
+     * For refenrece, if a DTO type be capsuled by the {@link Primitive} type,
+     * all of methods in the DTO type would be automatically erased. Also, if
+     * the DTO has a `toJSON()` method, the DTO type would be automatically
+     * converted to return type of the `toJSON()` method.
      *
-     * ```typescript
-     * import ts from "typescript";
+     * @default true
+     */
+    primitive?: boolean;
+
+    /**
+     * Location of `tsconfig.json` file.
      *
-     * const tsconfig: ts.TsConfig;
-     * const nestiaConfig: IConfiguration;
+     * If be configured, target file will replace the `tsconfig.json` file.
      *
-     * const compilerOptions: ts.CompilerOptions = {
-     *     ...tsconfig.compilerOptions,
-     *     ...(nestiaConfig.compilerOptions ?? {})
-     * }
-     * ```
+     * @default tsconfig.json
      */
-    compilerOptions?: StripEnums<ts.CompilerOptions>;
+    project?: string;
 
     /**
      * Whether to assert parameter types or not.
@@ -105,36 +143,6 @@ export interface INestiaConfig {
      * @default false
      */
     json?: boolean;
-
-    /**
-     * Whether to wrap DTO by primitive type.
-     *
-     * If you don't configure this property as `false`, all of DTOs in the
-     * SDK library would be automatically wrapped by {@link Primitive} type.
-     *
-     * For refenrece, if a DTO type be capsuled by the {@link Primitive} type,
-     * all of methods in the DTO type would be automatically erased. Also, if
-     * the DTO has a `toJSON()` method, the DTO type would be automatically
-     * converted to return type of the `toJSON()` method.
-     *
-     * @default true
-     */
-    primitive?: boolean;
-
-    /**
-     * Allow simulation mode.
-     *
-     * If you configure this property to be `true`, the SDK library would be contain
-     * simulation mode. In the simulation mode, the SDK library would not communicate
-     * with the real backend server, but just returns random mock-up data
-     * with requestion data validation.
-     *
-     * For reference, random mock-up data would be generated by `typia.random<T>()`
-     * function.
-     *
-     * @default false
-     */
-    simulate?: boolean;
 }
 export namespace INestiaConfig {
     /**
@@ -196,5 +204,12 @@ export namespace INestiaConfig {
          * @default false
          */
         decompose?: boolean;
+
+        operationId?(props: {
+            class: string;
+            function: string;
+            method: "HEAD" | "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+            path: string;
+        }): string;
     }
 }

package/src/NestiaSdkApplication.ts

@@ -1,6 +1,5 @@
 import fs from "fs";
 import path from "path";
-import * as runner from "ts-node";
 import { Pair, Singleton } from "tstl";
 import ts from "typescript";
 
@@ -8,7 +7,6 @@ import { INestiaConfig } from "./INestiaConfig";
 import { AccessorAnalyzer } from "./analyses/AccessorAnalyzer";
 import { ControllerAnalyzer } from "./analyses/ControllerAnalyzer";
 import { ReflectAnalyzer } from "./analyses/ReflectAnalyzer";
-import { NestiaConfigCompilerOptions } from "./executable/internal/NestiaConfigCompilerOptions";
 import { E2eGenerator } from "./generates/E2eGenerator";
 import { SdkGenerator } from "./generates/SdkGenerator";
 import { SwaggerGenerator } from "./generates/SwaggerGenerator";
@@ -19,13 +17,9 @@ import { NestiaConfigUtil } from "./utils/NestiaConfigUtil";
 import { SourceFinder } from "./utils/SourceFinder";
 
 export class NestiaSdkApplication {
-    private readonly bundle_checker_: Singleton<
-        Promise<(str: string) => boolean>
-    >;
-
-    public constructor(private readonly config_: INestiaConfig) {
-        this.bundle_checker_ = new Singleton(async () => {
-            if (!this.config_.output) return () => false;
+    private readonly bundler_: Singleton<Promise<(str: string) => boolean>> =
+        new Singleton(async () => {
+            if (!this.config) return () => false;
 
             const bundles: string[] = await fs.promises.readdir(
                 SdkGenerator.BUNDLE_PATH,
@@ -34,7 +28,7 @@ export class NestiaSdkApplication {
                 bundles,
                 async (file) => {
                     const relative: string = path.join(
-                        this.config_.output!,
+                        this.config!.output!,
                         file,
                     );
                     const location: string = path.join(
@@ -55,14 +49,33 @@ export class NestiaSdkApplication {
                 return false;
             };
         });
+
+    public constructor(
+        private readonly config: INestiaConfig,
+        private readonly compilerOptions: ts.CompilerOptions,
+    ) {}
+
+    private async is_not_excluded(file: string): Promise<boolean> {
+        if (this.config.output)
+            return (
+                file.indexOf(path.join(this.config.output, "functional")) ===
+                    -1 && (await this.bundler_.get())(file) === false
+            );
+
+        const content: string = await fs.promises.readFile(file, "utf8");
+        return (
+            content.indexOf(
+                " * @nestia Generated by Nestia - https://github.com/samchon/nestia",
+            ) === -1
+        );
     }
 
     public async e2e(): Promise<void> {
-        if (!this.config_.output)
+        if (!this.config.output)
             throw new Error(
                 "Error on NestiaApplication.e2e(): output path of SDK is not specified.",
             );
-        else if (!this.config_.e2e)
+        else if (!this.config.e2e)
             throw new Error(
                 "Error on NestiaApplication.e2e(): output path of e2e test files is not specified.",
             );
@@ -77,27 +90,27 @@ export class NestiaSdkApplication {
                         `Error on NestiaApplication.e2e(): output directory of ${title} does not exists.`,
                     );
             };
-        await validate("sdk")(this.config_.output);
-        await validate("e2e")(this.config_.e2e);
+        await validate("sdk")(this.config.output);
+        await validate("e2e")(this.config.e2e);
 
         title("Nestia E2E Generator");
         await this.generate(
             "e2e",
             (config) => config,
-            () => (config) => async (routes) => {
-                await SdkGenerator.generate(config)(routes);
+            (checker) => (config) => async (routes) => {
+                await SdkGenerator.generate(checker)(config)(routes);
                 await E2eGenerator.generate(config)(routes);
             },
         );
     }
 
     public async sdk(): Promise<void> {
-        if (!this.config_.output)
+        if (!this.config.output)
             throw new Error(
                 "Error on NestiaApplication.sdk(): output path is not specified.",
             );
 
-        const parent: string = path.resolve(this.config_.output + "/..");
+        const parent: string = path.resolve(this.config.output + "/..");
         const stats: fs.Stats = await fs.promises.lstat(parent);
         if (stats.isDirectory() === false)
             throw new Error(
@@ -105,23 +118,19 @@ export class NestiaSdkApplication {
             );
 
         title("Nestia SDK Generator");
-        await this.generate(
-            "sdk",
-            (config) => config,
-            () => SdkGenerator.generate,
-        );
+        await this.generate("sdk", (config) => config, SdkGenerator.generate);
     }
 
     public async swagger(): Promise<void> {
-        if (!this.config_.swagger?.output)
+        if (!this.config.swagger?.output)
             throw new Error(
                 `Error on NestiaApplication.swagger(): output path of the "swagger.json" is not specified.`,
             );
 
-        const parsed: path.ParsedPath = path.parse(this.config_.swagger.output);
+        const parsed: path.ParsedPath = path.parse(this.config.swagger.output);
         const directory: string = !!parsed.ext
             ? path.resolve(parsed.dir)
-            : this.config_.swagger.output;
+            : this.config.swagger.output;
         const stats: fs.Stats = await fs.promises.lstat(directory);
         if (stats.isDirectory() === false)
             throw new Error(
@@ -143,12 +152,9 @@ export class NestiaSdkApplication {
             checker: ts.TypeChecker,
         ) => (config: Config) => (routes: IRoute[]) => Promise<void>,
     ): Promise<void> {
-        // MOUNT TS-NODE
-        this.prepare(method);
-
         // LOAD CONTROLLER FILES
         const input: INestiaConfig.IInput = NestiaConfigUtil.input(
-            this.config_.input,
+            this.config.input,
         );
         const fileList: string[] = await ArrayUtil.asyncFilter(
             await SourceFinder.find({
@@ -197,7 +203,7 @@ export class NestiaSdkApplication {
         console.log("Analyzing source codes");
         const program: ts.Program = ts.createProgram(
             controllers.map((c) => c.file),
-            this.config_.compilerOptions || { noEmit: true },
+            this.compilerOptions,
         );
         const checker: ts.TypeChecker = program.getTypeChecker();
 
@@ -224,59 +230,7 @@ export class NestiaSdkApplication {
 
         // DO GENERATE
         AccessorAnalyzer.analyze(routeList);
-        await archiver(checker)(config(this.config_))(routeList);
-    }
-
-    private prepare(method: string): void {
-        // CONSTRUCT OPTIONS
-        if (!this.config_.compilerOptions)
-            this.config_.compilerOptions =
-                NestiaConfigCompilerOptions.DEFAULT_OPTIONS as any;
-        const absoluted: boolean = !!this.config_.compilerOptions?.baseUrl;
-
-        // CHECK STRICT OPTION
-        const strict: boolean =
-            this.config_.compilerOptions?.strictNullChecks !== undefined
-                ? !!this.config_.compilerOptions.strictNullChecks
-                : !!this.config_.compilerOptions?.strict;
-        if (strict === false)
-            throw new Error(
-                `Error on NestiaSdkApplication.${method}(): nestia requires \`compilerOptions.strictNullChecks\` to be true.`,
-            );
-
-        const ttsc: boolean =
-            ts.version < "5.0.0" &&
-            (() => {
-                try {
-                    require.resolve("ttypescript");
-                    return true;
-                } catch (e) {
-                    return false;
-                }
-            })();
-
-        // MOUNT TS-NODE
-        runner.register({
-            emit: false,
-            compiler: ttsc ? "ttypescript" : undefined,
-            compilerOptions: this.config_.compilerOptions,
-            require: absoluted ? ["tsconfig-paths/register"] : undefined,
-        });
-    }
-
-    private async is_not_excluded(file: string): Promise<boolean> {
-        if (this.config_.output)
-            return (
-                file.indexOf(path.join(this.config_.output, "functional")) ===
-                    -1 && (await this.bundle_checker_.get())(file) === false
-            );
-
-        const content: string = await fs.promises.readFile(file, "utf8");
-        return (
-            content.indexOf(
-                " * @nestia Generated by Nestia - https://github.com/samchon/nestia",
-            ) === -1
-        );
+        await archiver(checker)(config(this.config))(routeList);
     }
 }
 
@@ -301,4 +255,5 @@ const is_implicit_return_typed = (route: IRoute): boolean => {
         else if (VARIABLE.test(name[i])) return false;
     return true;
 };
+
 const VARIABLE = /[a-zA-Z_$0-9]/;

package/src/analyses/ControllerAnalyzer.ts

@@ -145,11 +145,11 @@ export namespace ControllerAnalyzer {
             .map((pair) => [pair.first, pair.second.toJSON()]);
 
         // PARSE COMMENT TAGS
-        const tags = signature.getJsDocTags();
+        const jsDocTags = signature.getJsDocTags();
         const security: Record<string, string[]>[] = SecurityAnalyzer.merge(
             ...controller.security,
             ...func.security,
-            ...tags
+            ...jsDocTags
                 .filter((tag) => tag.name === "security")
                 .map((tag) =>
                     (tag.text ?? []).map((text) => {
@@ -177,8 +177,10 @@ export namespace ControllerAnalyzer {
             },
             imports,
             status: func.status,
-
-            symbol: `${controller.name}.${func.name}()`,
+            symbol: {
+                class: controller.name,
+                function: func.name,
+            },
             location: (() => {
                 const file = declaration.getSourceFile();
                 const { line, character } = file.getLineAndCharacterOfPosition(
@@ -189,12 +191,12 @@ export namespace ControllerAnalyzer {
                 }:${character + 1}`;
             })(),
             description: CommentFactory.description(symbol),
-            operationId: tags
-                .find(({ name }) => name === "operation")
+            operationId: jsDocTags
+                .find(({ name }) => name === "operationId")
                 ?.text!?.[0].text.split(" ")[0]
                 .trim(),
-            tags,
-            setHeaders: tags
+            jsDocTags: jsDocTags,
+            setHeaders: jsDocTags
                 .filter(
                     (t) =>
                         t.text?.length &&

package/src/analyses/ReflectAnalyzer.ts

@@ -90,6 +90,8 @@ export namespace ReflectAnalyzer {
             paths,
             functions: [],
             security: _Get_securities(creator),
+            swaggerTgas:
+                Reflect.getMetadata("swagger/apiUseTags", creator) ?? [],
         };
 
         // PARSE CHILDREN DATA
@@ -228,6 +230,12 @@ export namespace ReflectAnalyzer {
                   )?.value ?? "application/json",
             security: _Get_securities(proto),
             exceptions: _Get_exceptions(proto),
+            swaggerTags: [
+                ...new Set([
+                    ...controller.swaggerTgas,
+                    ...(Reflect.getMetadata("swagger/apiUseTags", proto) ?? []),
+                ]),
+            ],
         };
 
         // VALIDATE PATH ARGUMENTS