@nestia/sdk 2.2.4 → 2.3.0-dev.20231017

package/lib/generates/E2eGenerator.js

@@ -15,7 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.E2eGenerator = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const NestiaConfigUtil_1 = require("../utils/NestiaConfigUtil");
+const ConfigAnalyzer_1 = require("../analyses/ConfigAnalyzer");
 const E2eFileProgrammer_1 = require("./internal/E2eFileProgrammer");
 var E2eGenerator;
 (function (E2eGenerator) {
@@ -41,7 +41,7 @@ var E2eGenerator;
             return;
         const location = path_1.default.join(__dirname, "..", "..", "assets", "bundle", "e2e", "index.ts");
         const content = yield fs_1.default.promises.readFile(location, "utf8");
-        yield fs_1.default.promises.writeFile(output, content.replace("${input}", JSON.stringify(NestiaConfigUtil_1.NestiaConfigUtil.input(config.input))), "utf8");
+        yield fs_1.default.promises.writeFile(output, content.replace("${input}", JSON.stringify(yield ConfigAnalyzer_1.ConfigAnalyzer.input(config.input))), "utf8");
     });
 })(E2eGenerator || (exports.E2eGenerator = E2eGenerator = {}));
 const mkdir = (location) => __awaiter(void 0, void 0, void 0, function* () {

package/lib/generates/E2eGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"E2eGenerator.js","sourceRoot":"","sources":["../../src/generates/E2eGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAIxB,gEAA6D;AAC7D,oEAAiE;AAEjE,IAAiB,YAAY,CAoD5B;AApDD,WAAiB,YAAY;IACZ,qBAAQ,GACjB,CAAC,MAAqB,EAAE,EAAE,CAC1B,CAAO,SAAmB,EAAiB,EAAE;QACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAE7C,sBAAsB;QACtB,MAAM,MAAM,GAAW,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAI,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAE/D,2BAA2B;QAC3B,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAExD,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,SAAS;YACzB,MAAM,qCAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrC,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAO,CAAC;gBACjC,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC;aAC7D,CAAC,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAA,CAAC;IAEN,MAAM,KAAK,GACP,CAAC,MAAqB,EAAE,EAAE,CAC1B,CAAO,MAAc,EAAiB,EAAE;QACpC,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO;QAElC,MAAM,QAAQ,GAAW,cAAI,CAAC,IAAI,CAC9B,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAU,CACb,CAAC;QACF,MAAM,OAAO,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAC9C,QAAQ,EACR,MAAM,CACT,CAAC;QAEF,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CACvB,MAAM,EACN,OAAO,CAAC,OAAO,CACX,UAAU,EACV,IAAI,CAAC,SAAS,CAAC,mCAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACvD,EACD,MAAM,CACT,CAAC;IACN,CAAC,CAAA,CAAC;AACV,CAAC,EApDgB,YAAY,4BAAZ,YAAY,QAoD5B;AAED,MAAM,KAAK,GAAG,CAAO,QAAgB,EAAiB,EAAE;IACpD,IAAI;QACA,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;KACrC;IAAC,WAAM,GAAE;AACd,CAAC,CAAA,CAAC"}
+{"version":3,"file":"E2eGenerator.js","sourceRoot":"","sources":["../../src/generates/E2eGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAGxB,+DAA4D;AAE5D,oEAAiE;AAEjE,IAAiB,YAAY,CAoD5B;AApDD,WAAiB,YAAY;IACZ,qBAAQ,GACjB,CAAC,MAAqB,EAAE,EAAE,CAC1B,CAAO,SAAmB,EAAiB,EAAE;QACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAE7C,sBAAsB;QACtB,MAAM,MAAM,GAAW,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAI,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAE/D,2BAA2B;QAC3B,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAExD,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,SAAS;YACzB,MAAM,qCAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrC,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAO,CAAC;gBACjC,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC;aAC7D,CAAC,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAA,CAAC;IAEN,MAAM,KAAK,GACP,CAAC,MAAqB,EAAE,EAAE,CAC1B,CAAO,MAAc,EAAiB,EAAE;QACpC,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO;QAElC,MAAM,QAAQ,GAAW,cAAI,CAAC,IAAI,CAC9B,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAU,CACb,CAAC;QACF,MAAM,OAAO,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAC9C,QAAQ,EACR,MAAM,CACT,CAAC;QAEF,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CACvB,MAAM,EACN,OAAO,CAAC,OAAO,CACX,UAAU,EACV,IAAI,CAAC,SAAS,CAAC,MAAM,+BAAc,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC3D,EACD,MAAM,CACT,CAAC;IACN,CAAC,CAAA,CAAC;AACV,CAAC,EApDgB,YAAY,4BAAZ,YAAY,QAoD5B;AAED,MAAM,KAAK,GAAG,CAAO,QAAgB,EAAiB,EAAE;IACpD,IAAI;QACA,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;KACrC;IAAC,WAAM,GAAE;AACd,CAAC,CAAA,CAAC"}

package/lib/structures/IController.d.ts

@@ -3,6 +3,7 @@ export interface IController {
     file: string;
     name: string;
     paths: string[];
+    versions: Array<string | null>;
     functions: IController.IFunction[];
     security: Record<string, string[]>[];
     swaggerTgas: string[];
@@ -12,6 +13,7 @@ export declare namespace IController {
         name: string;
         method: string;
         paths: string[];
+        versions: Array<string | null>;
         encrypted: boolean;
         parameters: IParameter[];
         status?: number;

package/lib/utils/SourceFinder.js

@@ -28,6 +28,10 @@ var SourceFinder;
     });
     const emplace = (filter) => (input) => (closure) => __awaiter(this, void 0, void 0, function* () {
         for (const pattern of input) {
+            if (_Is_file(pattern)) {
+                closure(path_1.default.resolve(pattern));
+                continue;
+            }
             for (const file of yield _Glob(pattern)) {
                 const stats = yield fs_1.default.promises.stat(file);
                 if (stats.isDirectory() === true)
@@ -56,5 +60,8 @@ var SourceFinder;
                 resolve(matches.map((str) => path_1.default.resolve(str)));
         });
     });
+    const _Is_file = (pattern) => pattern.endsWith(".ts") &&
+        !pattern.endsWith(".d.ts") &&
+        fs_1.default.existsSync(pattern);
 })(SourceFinder || (exports.SourceFinder = SourceFinder = {}));
 //# sourceMappingURL=SourceFinder.js.map

package/lib/utils/SourceFinder.js.map

@@ -1 +1 @@
-{"version":3,"file":"SourceFinder.js","sourceRoot":"","sources":["../../src/utils/SourceFinder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,gDAAwB;AAExB,IAAiB,YAAY,CAiD5B;AAjDD,WAAiB,YAAY;IACZ,iBAAI,GAAG,CAAO,KAAa,EAAqB,EAAE;;QAC3D,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;QAEpC,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,IAAI,MAAA,KAAK,CAAC,OAAO,0CAAE,MAAM;YACrB,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAC/C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CACnB,CAAC;QAEN,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACrB,CAAC,CAAA,CAAC;IAEF,MAAM,OAAO,GACT,CAAC,MAAiC,EAAE,EAAE,CACtC,CAAC,KAAe,EAAE,EAAE,CACpB,CAAO,OAAmC,EAAiB,EAAE;QACzD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE;YACzB,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE;gBACrC,MAAM,KAAK,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrD,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI;oBAC5B,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;qBACpC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;aAC1D;SACJ;IACL,CAAC,CAAA,CAAC;IAEN,MAAM,OAAO,GACT,CAAC,MAAqC,EAAE,EAAE,CAC1C,CAAC,OAAmC,EAAE,EAAE,CACxC,CAAO,QAAgB,EAAiB,EAAE;QACtC,MAAM,SAAS,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE;YAC1B,MAAM,IAAI,GAAW,cAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,KAAK,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAErD,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI;gBAC5B,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;iBACpC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;SAC1D;IACL,CAAC,CAAA,CAAC;IAEN,MAAM,KAAK,GAAG,CAAC,OAAe,EAAqB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5B,IAAA,cAAI,EAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YAC3B,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACX,CAAC,EAjDgB,YAAY,4BAAZ,YAAY,QAiD5B"}
+{"version":3,"file":"SourceFinder.js","sourceRoot":"","sources":["../../src/utils/SourceFinder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/sdk",
-  "version": "2.2.4",
+  "version": "2.3.0-dev.20231017",
   "description": "Nestia SDK and Swagger generator",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -35,8 +35,9 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@nestia/fetcher": "^2.2.4",
+    "@nestia/fetcher": "^2.3.0-dev.20231017",
     "cli": "^1.0.1",
+    "get-function-location": "^2.0.0",
     "glob": "^7.2.0",
     "path-to-regexp": "^6.2.1",
     "reflect-metadata": ">=0.1.12",
@@ -44,10 +45,10 @@
     "tsconfck": "^2.0.1",
     "tsconfig-paths": "^4.1.1",
     "tstl": "^2.5.13",
-    "typia": "^5.2.2"
+    "typia": ">=5.2.2 <6.0.0"
   },
   "peerDependencies": {
-    "@nestia/fetcher": ">=2.2.4",
+    "@nestia/fetcher": ">=2.3.0-dev.20231017",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",

package/src/INestiaConfig.ts

@@ -1,3 +1,6 @@
+import type { INestApplication } from "@nestjs/common";
+import type { VersionValue } from "@nestjs/common/interfaces";
+
 import type { ISwagger } from "./structures/ISwagger";
 import type { ISwaggerInfo } from "./structures/ISwaggerInfo";
 import type { ISwaggerSecurityScheme } from "./structures/ISwaggerSecurityScheme";
@@ -16,9 +19,18 @@ export interface INestiaConfig {
     swagger?: INestiaConfig.ISwaggerConfig;
 
     /**
-     * List of files or directories containing the NestJS controller classes.
+     * Accessor of controller classes.
+     *
+     * You can specify it within two ways
+     *
+     *   - Assign `INestApplication` instance or its factory function
+     *   - Specify the path or directory of controller class files
      */
-    input: string | string[] | INestiaConfig.IInput;
+    input:
+        | string
+        | string[]
+        | INestiaConfig.IInput
+        | (() => Promise<INestApplication>);
 
     /**
      * Output directory that SDK would be placed in.
@@ -159,6 +171,22 @@ export namespace INestiaConfig {
          * List of files or directories to be excluded.
          */
         exclude?: string[];
+
+        /**
+         * @internal
+         */
+        globalPrefix?: {
+            prefix: string;
+            exclude?: Array<string | RouteInfo>;
+        };
+
+        /**
+         * @internal
+         */
+        versioning?: {
+            prefix: string;
+            defaultVersion?: VersionValue;
+        };
     }
 
     /**
@@ -213,3 +241,11 @@ export namespace INestiaConfig {
         }): string;
     }
 }
+
+/**
+ * @internal
+ */
+interface RouteInfo {
+    path: string;
+    method: string;
+}

package/src/NestiaSdkApplication.ts

@@ -5,6 +5,7 @@ import ts from "typescript";
 
 import { INestiaConfig } from "./INestiaConfig";
 import { AccessorAnalyzer } from "./analyses/AccessorAnalyzer";
+import { ConfigAnalyzer } from "./analyses/ConfigAnalyzer";
 import { ControllerAnalyzer } from "./analyses/ControllerAnalyzer";
 import { ReflectAnalyzer } from "./analyses/ReflectAnalyzer";
 import { E2eGenerator } from "./generates/E2eGenerator";
@@ -13,7 +14,6 @@ import { SwaggerGenerator } from "./generates/SwaggerGenerator";
 import { IController } from "./structures/IController";
 import { IRoute } from "./structures/IRoute";
 import { ArrayUtil } from "./utils/ArrayUtil";
-import { NestiaConfigUtil } from "./utils/NestiaConfigUtil";
 import { SourceFinder } from "./utils/SourceFinder";
 
 export class NestiaSdkApplication {
@@ -153,13 +153,11 @@ export class NestiaSdkApplication {
         ) => (config: Config) => (routes: IRoute[]) => Promise<void>,
     ): Promise<void> {
         // LOAD CONTROLLER FILES
-        const input: INestiaConfig.IInput = NestiaConfigUtil.input(
-            this.config.input,
-        );
+        this.config.input = await ConfigAnalyzer.input(this.config.input);
         const fileList: string[] = await ArrayUtil.asyncFilter(
             await SourceFinder.find({
-                include: input.include,
-                exclude: input.exclude,
+                include: this.config.input.include,
+                exclude: this.config.input.exclude,
                 filter: (file) =>
                     file.substring(file.length - 3) === ".ts" &&
                     file.substring(file.length - 5) !== ".d.ts",

package/src/analyses/ConfigAnalyzer.ts

@@ -0,0 +1,73 @@
+import { INestApplication, VersioningType } from "@nestjs/common";
+
+import { INestiaConfig } from "../INestiaConfig";
+
+export namespace ConfigAnalyzer {
+    export const input = async (
+        config: INestiaConfig["input"],
+    ): Promise<INestiaConfig.IInput> => {
+        if (Array.isArray(config))
+            return {
+                include: config,
+                exclude: [],
+            };
+        else if (typeof config === "function")
+            return application(await config());
+        else if (typeof config === "object")
+            if (config === null) throw new Error("Invalid input config.");
+            else return config as INestiaConfig.IInput;
+        else if (typeof config === "string")
+            return {
+                include: [config],
+                exclude: [],
+            };
+        else throw new Error("Invalid input config.");
+    };
+
+    const application = async (
+        app: INestApplication,
+    ): Promise<INestiaConfig.IInput> => {
+        const files: string[] = await (async () => {
+            const functions = new Set<Function>();
+            for (const module of (app as any).container.modules.values())
+                for (const controller of module._controllers.keys())
+                    functions.add(controller);
+            const files: Set<string> = new Set();
+            for (const f of functions)
+                files.add(
+                    (await require("get-function-location")(f))?.source ?? "",
+                );
+            return [...files]
+                .filter((str) => str.startsWith("file://"))
+                .map((str) =>
+                    str.substring(str.startsWith("file:///") ? 8 : 7),
+                );
+        })();
+        const versioning = (app as any).config?.versioningOptions;
+
+        return {
+            include: files,
+            exclude: [],
+            globalPrefix:
+                typeof (app as any).config?.globalPrefix === "string"
+                    ? {
+                          prefix: (app as any).config.globalPrefix,
+                          exclude:
+                              (app as any).config.globalPrefixOptions
+                                  ?.exclude ?? {},
+                      }
+                    : undefined,
+            versioning:
+                versioning === undefined ||
+                versioning.type !== VersioningType.URI
+                    ? undefined
+                    : {
+                          prefix:
+                              versioning.prefix === undefined ||
+                              versioning.prefix === false
+                                  ? "v"
+                                  : versioning.prefix,
+                      },
+        };
+    };
+}

package/src/analyses/ControllerAnalyzer.ts

@@ -231,27 +231,46 @@ export namespace ControllerAnalyzer {
         };
 
         // CONFIGURE PATHS
-        const pathList: string[] = [];
-        for (const controllerPath of controller.paths)
-            for (const filePath of func.paths) {
-                const path: string = PathAnalyzer.join(
-                    controllerPath,
-                    filePath,
-                );
-                pathList.push(
-                    PathAnalyzer.espace(
-                        path,
-                        () => "ControllerAnalyzer.analyze()",
-                    ),
-                );
+        const input: INestiaConfig.IInput =
+            config.input as INestiaConfig.IInput;
+        const pathList: Set<string> = new Set();
+        const versions: Set<string | null> = new Set();
+
+        for (const cPath of controller.paths)
+            for (const filePath of func.paths)
+                pathList.add(PathAnalyzer.join(cPath, filePath));
+        if (input.versioning?.prefix.length) {
+            if (input.versioning.defaultVersion !== undefined) {
+                if (typeof input.versioning.defaultVersion === "symbol")
+                    versions.add(null);
+                else if (Array.isArray(input.versioning.defaultVersion))
+                    for (const v of input.versioning.defaultVersion)
+                        if (typeof v === "symbol") versions.add(null);
+                        else versions.add(String(v));
+                else versions.add(String(input.versioning.defaultVersion));
             }
+            for (const cv of input.versioning.prefix) {
+                versions.add(cv);
+                for (const fv of func.versions) versions.add(fv);
+            }
+        } else versions.add(null);
 
-        // RETURNS
-        return pathList.map((path) => ({
-            ...common,
-            path,
-            accessors: [...PathUtil.accessors(path), func.name],
-        }));
+        return [...pathList]
+            .map((individual) =>
+                PathAnalyzer.combinate(input.globalPrefix)([...versions])({
+                    method: func.method,
+                    path: individual,
+                }),
+            )
+            .flat()
+            .map((path) => ({
+                ...common,
+                path: PathAnalyzer.escape(
+                    path,
+                    () => "ControllerAnalyzer.analyze()",
+                ),
+                accessors: [...PathUtil.accessors(path), func.name],
+            }));
     }
 
     function _Analyze_parameter(

package/src/analyses/PathAnalyzer.ts

@@ -1,17 +1,40 @@
 import path from "path";
 import { Token, parse } from "path-to-regexp";
 
+import { INestiaConfig } from "../INestiaConfig";
+
 export namespace PathAnalyzer {
+    export const combinate =
+        (globalPrefix: INestiaConfig.IInput["globalPrefix"]) =>
+        (versions: Array<string | null>) =>
+        (props: { path: string; method: string }): string[] => {
+            const out = (str: string) =>
+                versions.map((v) => (v === null ? str : join(v, str)));
+            if (!globalPrefix?.prefix.length) return out(props.path);
+            else if (!globalPrefix.exclude?.length)
+                return out(props.path).map((str) =>
+                    join(globalPrefix.prefix, str),
+                );
+            return globalPrefix.exclude.some((exclude) =>
+                typeof exclude === "string"
+                    ? RegExp(exclude).test(props.path)
+                    : (exclude.method as string) === props.method &&
+                      RegExp(exclude.path).test(props.path),
+            )
+                ? out(props.path)
+                : out(props.path).map((str) => join(globalPrefix.prefix, str));
+        };
+
     export const join = (...args: string[]) =>
         "/" +
         _Trim(
             path
-                .join(...args)
+                .join(...args.filter((s) => !!s.length))
                 .split("\\")
                 .join("/"),
         );
 
-    export const espace = (str: string, method: () => string) =>
+    export const escape = (str: string, method: () => string) =>
         "/" +
         _Parse(str, method)
             .map((arg) => (arg.type === "param" ? `:${arg.value}` : arg.value))

package/src/analyses/ReflectAnalyzer.ts

@@ -1,4 +1,5 @@
 import * as Constants from "@nestjs/common/constants";
+import { VersionValue } from "@nestjs/common/interfaces";
 import "reflect-metadata";
 import { equal } from "tstl/ranges/module";
 
@@ -82,14 +83,12 @@ export namespace ReflectAnalyzer {
         // CONSTRUCTION
         //----
         // BASIC INFO
-        const paths: string[] = _Get_paths(
-            Reflect.getMetadata(Constants.PATH_METADATA, creator),
-        );
         const meta: IController = {
             file,
             name,
-            paths,
             functions: [],
+            paths: _Get_paths(creator),
+            versions: _Get_versions(creator),
             security: _Get_securities(creator),
             swaggerTgas:
                 Reflect.getMetadata("swagger/apiUseTags", creator) ?? [],
@@ -123,12 +122,31 @@ export namespace ReflectAnalyzer {
         return entries;
     }
 
-    function _Get_paths(value: string | string[]): string[] {
+    function _Get_paths(target: any): string[] {
+        const value: string | string[] = Reflect.getMetadata(
+            Constants.PATH_METADATA,
+            target,
+        );
         if (typeof value === "string") return [value];
         else if (value.length === 0) return [""];
         else return value;
     }
 
+    function _Get_versions(target: any): Array<string | null> {
+        const value: VersionValue | undefined = Reflect.getMetadata(
+            Constants.VERSION_METADATA,
+            target,
+        );
+        if (value === undefined || typeof value === "symbol") return [null];
+        else if (Array.isArray(value))
+            if (value.length === 0) return [null];
+            else
+                return value.map((v) =>
+                    typeof value === "symbol" ? null : v,
+                ) as Array<string | null>;
+        return [String(value)];
+    }
+
     function _Get_securities(value: any): Record<string, string[]>[] {
         const entire: Record<string, string[]>[] | undefined =
             Reflect.getMetadata("swagger/apiSecurity", value);
@@ -218,9 +236,8 @@ export namespace ReflectAnalyzer {
         const meta: IController.IFunction = {
             name,
             method: method === "ALL" ? "POST" : method,
-            paths: _Get_paths(
-                Reflect.getMetadata(Constants.PATH_METADATA, proto),
-            ),
+            paths: _Get_paths(proto),
+            versions: _Get_versions(proto),
             parameters,
             status: Reflect.getMetadata(Constants.HTTP_CODE_METADATA, proto),
             encrypted,

package/src/executable/internal/NestiaConfigLoader.ts

@@ -40,10 +40,11 @@ export namespace NestiaConfigLoader {
     };
 
     export const config = async (
+        file: string,
         options: ts.CompilerOptions,
     ): Promise<INestiaConfig> => {
-        if (fs.existsSync(path.resolve("nestia.config.ts")) === false)
-            throw new Error(`unable to find "nestia.config.ts" file.`);
+        if (fs.existsSync(path.resolve(file)) === false)
+            throw new Error(`Unable to find "${file}" file.`);
 
         register({
             emit: false,
@@ -52,7 +53,7 @@ export namespace NestiaConfigLoader {
         });
 
         const loaded: INestiaConfig & { default?: INestiaConfig } =
-            await import(path.resolve("nestia.config.ts"));
+            await import(path.resolve(file));
         const config: INestiaConfig =
             typeof loaded?.default === "object" && loaded.default !== null
                 ? loaded.default
@@ -62,19 +63,19 @@ export namespace NestiaConfigLoader {
             return typia.assert(config);
         } catch (exp) {
             if (typia.is<typia.TypeGuardError>(exp))
-                exp.message = `invalid "nestia.config.ts" data.`;
+                exp.message = `invalid "${file}" data.`;
             throw exp;
         }
     };
 
-    export const project = async (): Promise<string> => {
+    export const project = async (file: string): Promise<string> => {
         const connector = new WorkerConnector(null, null, "process");
         await connector.connect(
             `${__dirname}/nestia.project.getter.${__filename.substr(-2)}`,
         );
 
         const driver = await connector.getDriver<typeof NestiaProjectGetter>();
-        const project: string = await driver.get();
+        const project: string = await driver.get(file);
         await connector.close();
 
         return project;

package/src/executable/internal/NestiaProjectGetter.ts

@@ -1,8 +1,8 @@
 import { NestiaConfigLoader } from "./NestiaConfigLoader";
 
 export namespace NestiaProjectGetter {
-    export async function get(): Promise<string> {
-        const config = await NestiaConfigLoader.config({
+    export async function get(file: string): Promise<string> {
+        const config = await NestiaConfigLoader.config(file, {
             module: "CommonJS" as any,
             noEmit: true,
         });

package/src/executable/internal/NestiaSdkCommand.ts

@@ -17,10 +17,12 @@ export namespace NestiaSdkCommand {
         task: (app: NestiaSdkApplication) => Promise<void>,
     ) => {
         // LOAD CONFIG INFO
-        const project: string = await NestiaConfigLoader.project();
+        const file: string = getConfigFile() ?? "nestia.config.ts";
+        const project: string = await NestiaConfigLoader.project(file);
         const compilerOptions: ts.CompilerOptions =
             await NestiaConfigLoader.compilerOptions(project);
         const config: INestiaConfig = await NestiaConfigLoader.config(
+            file,
             compilerOptions,
         );
 
@@ -31,4 +33,19 @@ export namespace NestiaSdkCommand {
         );
         await task(app);
     };
+
+    const getConfigFile = (): string | null => {
+        const argv: string[] = process.argv.slice(3);
+        if (argv.length < 1) return null;
+
+        const index: number = argv.findIndex((str) => str === "--config");
+        if (index === -1) return null;
+        else if (argv.length === 1)
+            throw new Error("Config file must be provided");
+
+        const file: string = argv[index + 1];
+        if (file.endsWith(".ts") === false)
+            throw new Error("Config file must be TypeScript file");
+        return file;
+    };
 }

package/src/executable/sdk.ts

@@ -14,9 +14,9 @@ npx @nestia/sdk [command] [options?]
     - npx @nestia/sdk dependencies
     - npx @nestia/sdk dependencies --manager pnpm
   2. npx @nestia/sdk init
-  3. npx @nestia/sdk sdk
-  4. npx @nestia/sdk swagger
-  5. npx @nestia/sdk e2e
+  3. npx @nestia/sdk sdk --config? [config file]
+  4. npx @nestia/sdk swagger --config? [config file]
+  5. npx @nestia/sdk e2e --config? [config file]
 `;
 
 function halt(desc: string): never {

package/src/generates/E2eGenerator.ts

@@ -2,8 +2,8 @@ import fs from "fs";
 import path from "path";
 
 import { INestiaConfig } from "../INestiaConfig";
+import { ConfigAnalyzer } from "../analyses/ConfigAnalyzer";
 import { IRoute } from "../structures/IRoute";
-import { NestiaConfigUtil } from "../utils/NestiaConfigUtil";
 import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
 
 export namespace E2eGenerator {
@@ -53,7 +53,7 @@ export namespace E2eGenerator {
                 output,
                 content.replace(
                     "${input}",
-                    JSON.stringify(NestiaConfigUtil.input(config.input)),
+                    JSON.stringify(await ConfigAnalyzer.input(config.input)),
                 ),
                 "utf8",
             );

package/src/structures/IController.ts

@@ -4,6 +4,7 @@ export interface IController {
     file: string;
     name: string;
     paths: string[];
+    versions: Array<string | null>;
     functions: IController.IFunction[];
     security: Record<string, string[]>[];
     swaggerTgas: string[];
@@ -14,6 +15,7 @@ export namespace IController {
         name: string;
         method: string;
         paths: string[];
+        versions: Array<string | null>;
         encrypted: boolean;
         parameters: IParameter[];
         status?: number;

package/src/utils/SourceFinder.ts

@@ -20,6 +20,10 @@ export namespace SourceFinder {
         (input: string[]) =>
         async (closure: (location: string) => void): Promise<void> => {
             for (const pattern of input) {
+                if (_Is_file(pattern)) {
+                    closure(path.resolve(pattern));
+                    continue;
+                }
                 for (const file of await _Glob(pattern)) {
                     const stats: fs.Stats = await fs.promises.stat(file);
                     if (stats.isDirectory() === true)
@@ -51,6 +55,11 @@ export namespace SourceFinder {
                 else resolve(matches.map((str) => path.resolve(str)));
             });
         });
+
+    const _Is_file = (pattern: string): boolean =>
+        pattern.endsWith(".ts") &&
+        !pattern.endsWith(".d.ts") &&
+        fs.existsSync(pattern);
 }
 
 interface IProps {

package/lib/utils/NestiaConfigUtil.d.ts

@@ -1,4 +0,0 @@
-import { INestiaConfig } from "../INestiaConfig";
-export declare namespace NestiaConfigUtil {
-    const input: (config: INestiaConfig["input"]) => INestiaConfig.IInput;
-}

package/lib/utils/NestiaConfigUtil.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NestiaConfigUtil = void 0;
-var NestiaConfigUtil;
-(function (NestiaConfigUtil) {
-    NestiaConfigUtil.input = (config) => {
-        var _a;
-        return Array.isArray(config)
-            ? {
-                include: config,
-                exclude: [],
-            }
-            : typeof config === "object"
-                ? {
-                    include: config.include,
-                    exclude: (_a = config.exclude) !== null && _a !== void 0 ? _a : [],
-                }
-                : {
-                    include: [config],
-                    exclude: [],
-                };
-    };
-})(NestiaConfigUtil || (exports.NestiaConfigUtil = NestiaConfigUtil = {}));
-//# sourceMappingURL=NestiaConfigUtil.js.map