@nestia/migrate 0.9.5 → 0.9.7

package/lib/structures/ISwaggerRoute.d.ts

@@ -1,7 +1,8 @@
 import { IJsDocTagInfo } from "typia/lib/schemas/metadata/IJsDocTagInfo";
+import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
 import { ISwaggerSchema } from "./ISwaggerSchema";
 export interface ISwaggerRoute {
-    parameters?: ISwaggerRoute.IParameter[];
+    parameters?: (ISwaggerRouteParameter | ISwaggerRouteParameter.IReference)[];
     requestBody?: ISwaggerRoute.IRequestBody;
     responses?: ISwaggerRoute.IResponseBody;
     summary?: string;
@@ -12,13 +13,6 @@ export interface ISwaggerRoute {
     "x-nestia-jsDocTags"?: IJsDocTagInfo[];
 }
 export declare namespace ISwaggerRoute {
-    interface IParameter {
-        name?: string;
-        in: "path" | "query" | "header" | "cookie";
-        schema: ISwaggerSchema;
-        required?: boolean;
-        description?: string;
-    }
     interface IRequestBody {
         description?: string;
         content: IContent;

package/lib/structures/ISwaggerRouteParameter.d.ts

@@ -0,0 +1,13 @@
+import { ISwaggerSchema } from "./ISwaggerSchema";
+export interface ISwaggerRouteParameter {
+    name?: string;
+    in: "path" | "query" | "header" | "cookie";
+    schema: ISwaggerSchema;
+    required?: boolean;
+    description?: string;
+}
+export declare namespace ISwaggerRouteParameter {
+    interface IReference {
+        $ref: `#/components/parameters/${string}`;
+    }
+}

package/lib/structures/ISwaggerRouteParameter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISwaggerRouteParameter.js.map

package/lib/structures/ISwaggerRouteParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISwaggerRouteParameter.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRouteParameter.ts"],"names":[],"mappings":""}

package/lib/utils/FilePrinter.d.ts

@@ -1,6 +1,6 @@
 import ts from "typescript";
 export declare namespace FilePrinter {
-    const description: <Node_1 extends ts.Node>(node: Node_1, comment: string) => Node_1;
+    const description: <Node extends ts.Node>(node: Node, comment: string) => Node;
     const newLine: () => ts.ExpressionStatement;
     const write: (props: {
         statements: ts.Statement[];

package/lib/utils/SwaggerTypeChecker.d.ts

@@ -1,6 +1,7 @@
-import { ISwaggerSchema } from "../structures/ISwaggerSchema";
 import { ISwaggerComponents } from "../structures/ISwaggerComponents";
-export declare namespace SwaggerSwaggerChecker {
+import { ISwaggerRouteParameter } from "../structures/ISwaggerRouteParameter";
+import { ISwaggerSchema } from "../structures/ISwaggerSchema";
+export declare namespace SwaggerTypeChecker {
     const isAnyOf: (schema: ISwaggerSchema) => schema is ISwaggerSchema.IAnyOf;
     const isOneOf: (schema: ISwaggerSchema) => schema is ISwaggerSchema.IOneOf;
     const isNullOnly: (schema: ISwaggerSchema) => schema is ISwaggerSchema.INullOnly;
@@ -13,4 +14,5 @@ export declare namespace SwaggerSwaggerChecker {
     const isReference: (schema: ISwaggerSchema) => schema is ISwaggerSchema.IReference;
     const isUnknown: (schema: ISwaggerSchema) => schema is ISwaggerSchema.IUnknown;
     const isNullable: (components: ISwaggerComponents) => (schema: ISwaggerSchema) => boolean;
+    const getParameter: (components: ISwaggerComponents) => (schema: ISwaggerRouteParameter | ISwaggerRouteParameter.IReference) => ISwaggerRouteParameter | null;
 }

package/lib/utils/SwaggerTypeChecker.js

@@ -1,34 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SwaggerSwaggerChecker = void 0;
-var SwaggerSwaggerChecker;
-(function (SwaggerSwaggerChecker) {
-    SwaggerSwaggerChecker.isAnyOf = (schema) => schema.anyOf !== undefined;
-    SwaggerSwaggerChecker.isOneOf = (schema) => schema.oneOf !== undefined;
-    SwaggerSwaggerChecker.isNullOnly = (schema) => schema.type === "null";
-    SwaggerSwaggerChecker.isBoolean = (schema) => schema.type === "boolean";
-    SwaggerSwaggerChecker.isInteger = (schema) => schema.type === "integer";
-    SwaggerSwaggerChecker.isNumber = (schema) => schema.type === "number";
-    SwaggerSwaggerChecker.isString = (schema) => schema.type === "string";
-    SwaggerSwaggerChecker.isArray = (schema) => schema.type === "array";
-    SwaggerSwaggerChecker.isObject = (schema) => schema.type === "object";
-    SwaggerSwaggerChecker.isReference = (schema) => schema.$ref !== undefined;
-    SwaggerSwaggerChecker.isUnknown = (schema) => schema.type === undefined &&
-        !SwaggerSwaggerChecker.isAnyOf(schema) &&
-        !SwaggerSwaggerChecker.isOneOf(schema) &&
-        !SwaggerSwaggerChecker.isReference(schema);
-    SwaggerSwaggerChecker.isNullable = (components) => (schema) => {
+exports.SwaggerTypeChecker = void 0;
+var SwaggerTypeChecker;
+(function (SwaggerTypeChecker) {
+    SwaggerTypeChecker.isAnyOf = (schema) => schema.anyOf !== undefined;
+    SwaggerTypeChecker.isOneOf = (schema) => schema.oneOf !== undefined;
+    SwaggerTypeChecker.isNullOnly = (schema) => schema.type === "null";
+    SwaggerTypeChecker.isBoolean = (schema) => schema.type === "boolean";
+    SwaggerTypeChecker.isInteger = (schema) => schema.type === "integer";
+    SwaggerTypeChecker.isNumber = (schema) => schema.type === "number";
+    SwaggerTypeChecker.isString = (schema) => schema.type === "string";
+    SwaggerTypeChecker.isArray = (schema) => schema.type === "array";
+    SwaggerTypeChecker.isObject = (schema) => schema.type === "object";
+    SwaggerTypeChecker.isReference = (schema) => schema.$ref !== undefined;
+    SwaggerTypeChecker.isUnknown = (schema) => schema.type === undefined &&
+        !SwaggerTypeChecker.isAnyOf(schema) &&
+        !SwaggerTypeChecker.isOneOf(schema) &&
+        !SwaggerTypeChecker.isReference(schema);
+    SwaggerTypeChecker.isNullable = (components) => (schema) => {
         var _a;
-        if (SwaggerSwaggerChecker.isAnyOf(schema))
-            return schema.anyOf.some(SwaggerSwaggerChecker.isNullable(components));
-        else if (SwaggerSwaggerChecker.isOneOf(schema))
-            return schema.oneOf.some(SwaggerSwaggerChecker.isNullable(components));
-        else if (SwaggerSwaggerChecker.isReference(schema)) {
+        if (SwaggerTypeChecker.isAnyOf(schema))
+            return schema.anyOf.some(SwaggerTypeChecker.isNullable(components));
+        else if (SwaggerTypeChecker.isOneOf(schema))
+            return schema.oneOf.some(SwaggerTypeChecker.isNullable(components));
+        else if (SwaggerTypeChecker.isReference(schema)) {
             const $id = schema.$ref.replace("#/components/schemas/", "");
             const target = ((_a = components.schemas) !== null && _a !== void 0 ? _a : {})[$id];
-            return target === undefined ? false : SwaggerSwaggerChecker.isNullable(components)(target);
+            return target === undefined ? false : SwaggerTypeChecker.isNullable(components)(target);
         }
         return schema.nullable === true;
     };
-})(SwaggerSwaggerChecker || (exports.SwaggerSwaggerChecker = SwaggerSwaggerChecker = {}));
+    SwaggerTypeChecker.getParameter = (components) => (schema) => {
+        var _a, _b;
+        return SwaggerTypeChecker.isReference(schema) && schema.$ref.startsWith("#/components/parameters/")
+            ? (_b = (_a = components.parameters) === null || _a === void 0 ? void 0 : _a[schema.$ref.replace("#/components/parameters/", "")]) !== null && _b !== void 0 ? _b : null
+            : schema;
+    };
+})(SwaggerTypeChecker || (exports.SwaggerTypeChecker = SwaggerTypeChecker = {}));
 //# sourceMappingURL=SwaggerTypeChecker.js.map

package/lib/utils/SwaggerTypeChecker.js.map

@@ -1 +1 @@
-{"version":3,"file":"SwaggerTypeChecker.js","sourceRoot":"","sources":["../../src/utils/SwaggerTypeChecker.ts"],"names":[],"mappings":";;;AAGA,IAAiB,qBAAqB,CA+DrC;AA/DD,WAAiB,qBAAqB;IACvB,6BAAO,GAAG,CACrB,MAAsB,EACW,EAAE,CAAE,MAAc,CAAC,KAAK,KAAK,SAAS,CAAC;IAE7D,6BAAO,GAAG,CACrB,MAAsB,EACW,EAAE,CAAE,MAAc,CAAC,KAAK,KAAK,SAAS,CAAC;IAE7D,gCAAU,GAAG,CACxB,MAAsB,EACc,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,MAAM,CAAC;IAE5D,+BAAS,GAAG,CACvB,MAAsB,EACa,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,SAAS,CAAC;IAE9D,+BAAS,GAAG,CACvB,MAAsB,EACa,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,SAAS,CAAC;IAE9D,8BAAQ,GAAG,CACtB,MAAsB,EACY,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,QAAQ,CAAC;IAE5D,8BAAQ,GAAG,CACtB,MAAsB,EACY,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,QAAQ,CAAC;IAE5D,6BAAO,GAAG,CACrB,MAAsB,EACW,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,OAAO,CAAC;IAE1D,8BAAQ,GAAG,CACtB,MAAsB,EACY,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,QAAQ,CAAC;IAE5D,iCAAW,GAAG,CACzB,MAAsB,EACe,EAAE,CAAE,MAAc,CAAC,IAAI,KAAK,SAAS,CAAC;IAEhE,+BAAS,GAAG,CACvB,MAAsB,EACa,EAAE,CACpC,MAAc,CAAC,IAAI,KAAK,SAAS;QAClC,CAAC,sBAAA,OAAO,CAAC,MAAM,CAAC;QAChB,CAAC,sBAAA,OAAO,CAAC,MAAM,CAAC;QAChB,CAAC,sBAAA,WAAW,CAAC,MAAM,CAAC,CAAC;IAEV,gCAAU,GACrB,CAAC,UAA8B,EAAE,EAAE,CACnC,CAAC,MAAsB,EAAW,EAAE;;QAClC,IAAI,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;YACvC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAA,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;aAC9C,IAAI,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAA,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;aAC9C,IAAI,qBAAqB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,CAAC,MAAA,UAAU,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAA,UAAU,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;QACD,OAAQ,MAAiC,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC9D,CAAC,CAAC;AACN,CAAC,EA/DgB,qBAAqB,qCAArB,qBAAqB,QA+DrC"}
+{"version":3,"file":"SwaggerTypeChecker.js","sourceRoot":"","sources":["../../src/utils/SwaggerTypeChecker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/migrate",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "Migration program from swagger to NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -34,9 +34,9 @@
   },
   "homepage": "https://nestia.io",
   "devDependencies": {
-    "@nestia/core": "^2.5.8",
+    "@nestia/core": "^2.5.15",
     "@nestia/e2e": "^0.4.1",
-    "@nestia/fetcher": "^2.5.8",
+    "@nestia/fetcher": "^2.5.15",
     "@nestjs/common": "^10.3.3",
     "@nestjs/core": "^10.3.3",
     "@nestjs/platform-express": "^10.3.3",
@@ -59,8 +59,8 @@
     "inquirer": "8.2.5",
     "prettier": "^3.2.5",
     "tstl": "^2.5.13",
-    "typescript": "^5.3.3",
-    "typia": "^5.5.0"
+    "typescript": "^5.4.2",
+    "typia": "^5.5.7"
   },
   "files": [
     "lib",

package/src/analyzers/MigrateControllerAnalyzer.ts

@@ -20,6 +20,8 @@ export namespace MigrateControllerAnalyzer {
 
     // GATHER ROUTES
     for (const [path, collection] of Object.entries(props.swagger.paths)) {
+      if (collection === undefined) continue;
+
       // PREPARE DIRECTORIES
       const location: string = StringUtil.splitWithNormalization(path)
         .filter((str) => str[0] !== "{" && str[0] !== ":")
@@ -29,6 +31,11 @@ export namespace MigrateControllerAnalyzer {
       // INSERT ROUTES TO THE LAST DIRECTORY
       const routes: IEntry[] = MapUtil.take(endpoints)(location)(() => []);
       for (const [method, value] of Object.entries(collection)) {
+        if (
+          value === undefined ||
+          ["get", "post", "patch", "put", "delete"].includes(method) === false
+        )
+          continue;
         const r: IMigrateRoute | null = MigrateMethodAnalzyer.analyze(props)({
           path,
           method,

package/src/analyzers/MigrateMethodAnalyzer.ts

@@ -1,12 +1,14 @@
+import typia from "typia";
 import { Escaper } from "typia/lib/utils/Escaper";
 
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
 import { ISwagger } from "../structures/ISwagger";
 import { ISwaggerRoute } from "../structures/ISwaggerRoute";
+import { ISwaggerRouteParameter } from "../structures/ISwaggerRouteParameter";
 import { ISwaggerSchema } from "../structures/ISwaggerSchema";
 import { StringUtil } from "../utils/StringUtil";
-import { SwaggerSwaggerChecker } from "../utils/SwaggerTypeChecker";
+import { SwaggerTypeChecker } from "../utils/SwaggerTypeChecker";
 
 export namespace MigrateMethodAnalzyer {
   export const analyze =
@@ -25,6 +27,13 @@ export namespace MigrateMethodAnalzyer {
       );
 
       const failures: string[] = [];
+      for (const p of route.parameters ?? [])
+        if (
+          SwaggerTypeChecker.getParameter(props.swagger.components)(p) === null
+        )
+          failures.push(
+            `parameter "${(p as ISwaggerRouteParameter.IReference).$ref}" is not defined in "components.parameters".`,
+          );
       if (body === false)
         failures.push(
           `supports only "application/json", "application/x-www-form-urlencoded", "multipart/form-data" and "text/plain" content type in the request body.`,
@@ -39,17 +48,24 @@ export namespace MigrateMethodAnalzyer {
         );
 
       const [headers, query] = ["header", "query"].map((type) => {
-        const parameters = (route.parameters ?? []).filter(
-          (p) => p.in === type,
-        );
+        const parameters: ISwaggerRouteParameter[] = (route.parameters ?? [])
+          .filter(
+            (p) =>
+              SwaggerTypeChecker.getParameter(props.swagger.components)(p)
+                ?.in === type,
+          )
+          .map(
+            (p) =>
+              SwaggerTypeChecker.getParameter(props.swagger.components)(p)!,
+          );
         if (parameters.length === 0) return null;
 
         const objects = parameters
           .map((p) =>
-            SwaggerSwaggerChecker.isObject(p.schema)
+            SwaggerTypeChecker.isObject(p.schema)
               ? p.schema
-              : SwaggerSwaggerChecker.isReference(p.schema) &&
-                  SwaggerSwaggerChecker.isObject(
+              : SwaggerTypeChecker.isReference(p.schema) &&
+                  SwaggerTypeChecker.isObject(
                     (props.swagger.components.schemas ?? {})[
                       p.schema.$ref.replace(`#/components/schemas/`, ``)
                     ] ?? {},
@@ -60,11 +76,11 @@ export namespace MigrateMethodAnalzyer {
           .filter((s) => !!s);
         const primitives = parameters.filter(
           (p) =>
-            SwaggerSwaggerChecker.isBoolean(p.schema) ||
-            SwaggerSwaggerChecker.isNumber(p.schema) ||
-            SwaggerSwaggerChecker.isInteger(p.schema) ||
-            SwaggerSwaggerChecker.isString(p.schema) ||
-            SwaggerSwaggerChecker.isArray(p.schema),
+            SwaggerTypeChecker.isBoolean(p.schema) ||
+            SwaggerTypeChecker.isNumber(p.schema) ||
+            SwaggerTypeChecker.isInteger(p.schema) ||
+            SwaggerTypeChecker.isString(p.schema) ||
+            SwaggerTypeChecker.isArray(p.schema),
         );
         if (objects.length === 1 && primitives.length === 0) return objects[0];
         else if (objects.length > 1) {
@@ -75,7 +91,7 @@ export namespace MigrateMethodAnalzyer {
         }
 
         const dto: ISwaggerSchema.IObject | null = objects[0]
-          ? SwaggerSwaggerChecker.isObject(objects[0])
+          ? SwaggerTypeChecker.isObject(objects[0])
             ? objects[0]
             : ((props.swagger.components.schemas ?? {})[
                 (objects[0] as ISwaggerSchema.IReference).$ref.replace(
@@ -86,7 +102,7 @@ export namespace MigrateMethodAnalzyer {
           : null;
         const entire: ISwaggerSchema.IObject[] = [
           ...objects.map((o) =>
-            SwaggerSwaggerChecker.isObject(o)
+            SwaggerTypeChecker.isObject(o)
               ? o
               : (props.swagger.components.schemas?.[
                   o.$ref.replace(`#/components/schemas/`, ``)
@@ -152,7 +168,11 @@ export namespace MigrateMethodAnalzyer {
         );
       if (
         parameterNames.length !==
-        (route.parameters ?? []).filter((p) => p.in === "path").length
+        (route.parameters ?? []).filter(
+          (p) =>
+            SwaggerTypeChecker.getParameter(props.swagger.components)(p)?.in ===
+            "path",
+        ).length
       )
         failures.push(
           "number of path parameters are not matched with its full path.",
@@ -179,7 +199,10 @@ export namespace MigrateMethodAnalzyer {
             }
           : null,
         parameters: (route.parameters ?? [])
-          .filter((p) => p.in === "path")
+          .map((p) =>
+            SwaggerTypeChecker.getParameter(props.swagger.components)(p),
+          )
+          .filter((p) => p !== null && p.in === "path")
           .map((p, i) => ({
             name: parameterNames[i],
             key: (() => {
@@ -191,8 +214,8 @@ export namespace MigrateMethodAnalzyer {
               }
             })(),
             schema: {
-              ...p.schema,
-              description: p.schema.description ?? p.description,
+              ...p!.schema,
+              description: p!.schema.description ?? p!.description,
             },
           })),
         query: query
@@ -222,56 +245,69 @@ export namespace MigrateMethodAnalzyer {
             ]),
         ),
         deprecated: route.deprecated ?? false,
-        comment: () => describe(route),
+        comment: () => describe(props.swagger)(route),
         tags: route.tags ?? [],
       };
     };
 
-  const describe = (route: ISwaggerRoute): string => {
-    const commentTags: string[] = [];
-    const add = (text: string) => {
-      if (commentTags.every((line) => line !== text)) commentTags.push(text);
-    };
+  const describe =
+    (swagger: ISwagger) =>
+    (route: ISwaggerRoute): string => {
+      const commentTags: string[] = [];
+      const add = (text: string) => {
+        if (commentTags.every((line) => line !== text)) commentTags.push(text);
+      };
 
-    let description: string = route.description ?? "";
-    if (route.summary) {
-      const emended: string = route.summary.endsWith(".")
-        ? route.summary
-        : route.summary + ".";
-      if (
-        !!description.length &&
-        !description.startsWith(route.summary) &&
-        !route["x-nestia-jsDocTags"]?.some((t) => t.name === "summary")
-      )
-        description = `${emended}\n${description}`;
-    }
-    for (const p of route.parameters ?? [])
-      if (p.description) add(`@param ${p.name} ${p.description}`);
-    if (route.requestBody?.description)
-      add(`@param body ${route.requestBody.description}`);
-    for (const security of route.security ?? [])
-      for (const [name, scopes] of Object.entries(security))
-        add(`@security ${[name, ...scopes].join("")}`);
-    if (route.tags) route.tags.forEach((name) => add(`@tag ${name}`));
-    if (route.deprecated) add("@deprecated");
-    return description.length
-      ? commentTags.length
-        ? `${description}\n\n${commentTags.join("\n")}`
-        : description
-      : commentTags.join("\n");
-  };
+      let description: string = route.description ?? "";
+      if (route.summary) {
+        const emended: string = route.summary.endsWith(".")
+          ? route.summary
+          : route.summary + ".";
+        if (
+          !!description.length &&
+          !description.startsWith(route.summary) &&
+          !route["x-nestia-jsDocTags"]?.some((t) => t.name === "summary")
+        )
+          description = `${emended}\n${description}`;
+      }
+      for (const p of route.parameters ?? []) {
+        const param: ISwaggerRouteParameter | null = (() => {
+          if (!typia.is<ISwaggerRouteParameter.IReference>(p))
+            return typia.is<ISwaggerRouteParameter>(p) ? p : null;
+          return (
+            swagger.components.parameters?.[
+              p.$ref.replace(`#/components/parameters/`, ``)
+            ] ?? null
+          );
+        })();
+        if (param !== null && param.description)
+          add(`@param ${param.name} ${param.description}`);
+      }
+      if (route.requestBody?.description)
+        add(`@param body ${route.requestBody.description}`);
+      for (const security of route.security ?? [])
+        for (const [name, scopes] of Object.entries(security))
+          add(`@security ${[name, ...scopes].join("")}`);
+      if (route.tags) route.tags.forEach((name) => add(`@tag ${name}`));
+      if (route.deprecated) add("@deprecated");
+      return description.length
+        ? commentTags.length
+          ? `${description}\n\n${commentTags.join("\n")}`
+          : description
+        : commentTags.join("\n");
+    };
 
   const isNotObjectLiteral = (schema: ISwaggerSchema): boolean =>
-    SwaggerSwaggerChecker.isReference(schema) ||
-    SwaggerSwaggerChecker.isBoolean(schema) ||
-    SwaggerSwaggerChecker.isNumber(schema) ||
-    SwaggerSwaggerChecker.isString(schema) ||
-    SwaggerSwaggerChecker.isUnknown(schema) ||
-    (SwaggerSwaggerChecker.isAnyOf(schema) &&
+    SwaggerTypeChecker.isReference(schema) ||
+    SwaggerTypeChecker.isBoolean(schema) ||
+    SwaggerTypeChecker.isNumber(schema) ||
+    SwaggerTypeChecker.isString(schema) ||
+    SwaggerTypeChecker.isUnknown(schema) ||
+    (SwaggerTypeChecker.isAnyOf(schema) &&
       schema.anyOf.every(isNotObjectLiteral)) ||
-    (SwaggerSwaggerChecker.isOneOf(schema) &&
+    (SwaggerTypeChecker.isOneOf(schema) &&
       schema.oneOf.every(isNotObjectLiteral)) ||
-    (SwaggerSwaggerChecker.isArray(schema) && isNotObjectLiteral(schema.items));
+    (SwaggerTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
 
   const emplaceBodySchema =
     (from: "request" | "response") =>

package/src/bundles/NEST_TEMPLATE.ts

@@ -47,7 +47,7 @@ export const NEST_TEMPLATE = [
   {
     "location": "",
     "file": "package.json",
-    "content": "{\r\n  \"private\": true,\r\n  \"name\": \"@ORGANIZATION/PROJECT\",\r\n  \"version\": \"0.1.0\",\r\n  \"description\": \"Starter kit of Nestia\",\r\n  \"main\": \"lib/index.js\",\r\n  \"scripts\": {\r\n    \"test\": \"node bin/test\",\r\n    \"test:webpack\": \"npm run webpack && node bin/test/webpack.js\",\r\n    \"------------------------BUILDS------------------------\": \"\",\r\n    \"build\": \"npm run build:sdk && npm run build:main && npm run build:test\",\r\n    \"build:api\": \"rimraf packages/api/lib && npm run build:sdk && tsc -p packages/api/tsconfig.json\",\r\n    \"build:main\": \"rimraf lib && tsc\",\r\n    \"build:sdk\": \"rimraf src/api/functional && nestia sdk\",\r\n    \"build:swagger\": \"npx nestia swagger\",\r\n    \"build:test\": \"rimraf bin && tsc -p test/tsconfig.json\",\r\n    \"dev\": \"npm run build:test -- --watch\",\r\n    \"eslint\": \"eslint src && eslint test\",\r\n    \"eslint:fix\": \"eslint --fix src && eslint --fix test\",\r\n    \"prepare\": \"ts-patch install && typia patch\",\r\n    \"prettier\": \"prettier src --write && prettier test --write\",\r\n    \"------------------------WEBPACK------------------------\": \"\",\r\n    \"webpack\": \"rimraf dist && webpack\",\r\n    \"webpack:start\": \"cd dist && node dist/server\",\r\n    \"------------------------DEPLOYS------------------------\": \"\",\r\n    \"package:api\": \"npm run build:swagger && npm run build:api && cd packages/api && npm publish\",\r\n    \"start\": \"node lib/executable/server\",\r\n    \"start:swagger\": \"ts-node src/executable/swagger.ts\"\r\n  },\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"https://github.com/samchon/nestia-start\"\r\n  },\r\n  \"keywords\": [\r\n    \"nestia\",\r\n    \"template\",\r\n    \"boilerplate\"\r\n  ],\r\n  \"author\": \"AUTHOR\",\r\n  \"license\": \"MIT\",\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/samchon/nestia-start/issues\"\r\n  },\r\n  \"homepage\": \"https://github.com/samchon/nestia-start#readme\",\r\n  \"devDependencies\": {\r\n    \"@nestia/e2e\": \"^0.4.1\",\r\n    \"@nestia/sdk\": \"^2.5.12\",\r\n    \"@trivago/prettier-plugin-sort-imports\": \"^4.3.0\",\r\n    \"@types/cli\": \"^0.11.21\",\r\n    \"@types/express\": \"^4.17.21\",\r\n    \"@types/inquirer\": \"^8.2.5\",\r\n    \"@types/node\": \"^18.11.0\",\r\n    \"@types/uuid\": \"^8.3.4\",\r\n    \"@typescript-eslint/eslint-plugin\": \"^6.19.1\",\r\n    \"@typescript-eslint/parser\": \"^6.19.1\",\r\n    \"chalk\": \"^4.1.0\",\r\n    \"cli\": \"^1.0.1\",\r\n    \"copy-webpack-plugin\": \"^11.0.0\",\r\n    \"eslint-plugin-deprecation\": \"^2.0.0\",\r\n    \"express\": \"^4.18.2\",\r\n    \"nestia\": \"^5.2.2\",\r\n    \"prettier\": \"^3.2.4\",\r\n    \"prettier-plugin-prisma\": \"^5.0.0\",\r\n    \"rimraf\": \"^3.0.2\",\r\n    \"source-map-support\": \"^0.5.21\",\r\n    \"swagger-ui-express\": \"^5.0.0\",\r\n    \"ts-loader\": \"^9.5.1\",\r\n    \"ts-node\": \"^10.9.1\",\r\n    \"ts-patch\": \"^3.0.2\",\r\n    \"typescript\": \"^5.3.2\",\r\n    \"typescript-transform-paths\": \"^3.4.6\",\r\n    \"webpack\": \"^5.89.0\",\r\n    \"webpack-cli\": \"^5.1.4\",\r\n    \"write-file-webpack-plugin\": \"^4.5.1\"\r\n  },\r\n  \"dependencies\": {\r\n    \"@nestia/core\": \"^2.5.12\",\r\n    \"@nestia/fetcher\": \"^2.5.12\",\r\n    \"@nestjs/common\": \"^10.3.3\",\r\n    \"@nestjs/core\": \"^10.3.3\",\r\n    \"@nestjs/platform-express\": \"^10.3.3\",\r\n    \"commander\": \"10.0.0\",\r\n    \"dotenv\": \"^16.3.1\",\r\n    \"dotenv-expand\": \"^10.0.0\",\r\n    \"inquirer\": \"8.2.5\",\r\n    \"serialize-error\": \"^4.1.0\",\r\n    \"tstl\": \"^2.5.13\",\r\n    \"typia\": \"^5.4.14\",\r\n    \"uuid\": \"^9.0.0\"\r\n  },\r\n  \"stackblitz\": {\r\n    \"startCommand\": \"npm run prepare && npm run build:test && npm run test\"\r\n  }\r\n}"
+    "content": "{\r\n  \"private\": true,\r\n  \"name\": \"@ORGANIZATION/PROJECT\",\r\n  \"version\": \"0.1.0\",\r\n  \"description\": \"Starter kit of Nestia\",\r\n  \"main\": \"lib/index.js\",\r\n  \"scripts\": {\r\n    \"test\": \"node bin/test\",\r\n    \"test:webpack\": \"npm run webpack && node bin/test/webpack.js\",\r\n    \"------------------------BUILDS------------------------\": \"\",\r\n    \"build\": \"npm run build:sdk && npm run build:main && npm run build:test\",\r\n    \"build:api\": \"rimraf packages/api/lib && npm run build:sdk && tsc -p packages/api/tsconfig.json\",\r\n    \"build:main\": \"rimraf lib && tsc\",\r\n    \"build:sdk\": \"rimraf src/api/functional && nestia sdk\",\r\n    \"build:swagger\": \"npx nestia swagger\",\r\n    \"build:test\": \"rimraf bin && tsc -p test/tsconfig.json\",\r\n    \"dev\": \"npm run build:test -- --watch\",\r\n    \"eslint\": \"eslint src && eslint test\",\r\n    \"eslint:fix\": \"eslint --fix src && eslint --fix test\",\r\n    \"prepare\": \"ts-patch install && typia patch\",\r\n    \"prettier\": \"prettier src --write && prettier test --write\",\r\n    \"------------------------WEBPACK------------------------\": \"\",\r\n    \"webpack\": \"rimraf dist && webpack\",\r\n    \"webpack:start\": \"cd dist && node dist/server\",\r\n    \"------------------------DEPLOYS------------------------\": \"\",\r\n    \"package:api\": \"npm run build:swagger && npm run build:api && cd packages/api && npm publish\",\r\n    \"start\": \"node lib/executable/server\",\r\n    \"start:swagger\": \"ts-node src/executable/swagger.ts\"\r\n  },\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"https://github.com/samchon/nestia-start\"\r\n  },\r\n  \"keywords\": [\r\n    \"nestia\",\r\n    \"template\",\r\n    \"boilerplate\"\r\n  ],\r\n  \"author\": \"AUTHOR\",\r\n  \"license\": \"MIT\",\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/samchon/nestia-start/issues\"\r\n  },\r\n  \"homepage\": \"https://github.com/samchon/nestia-start#readme\",\r\n  \"devDependencies\": {\r\n    \"@nestia/e2e\": \"^0.4.2\",\r\n    \"@nestia/sdk\": \"^2.5.16\",\r\n    \"@trivago/prettier-plugin-sort-imports\": \"^4.3.0\",\r\n    \"@types/cli\": \"^0.11.21\",\r\n    \"@types/express\": \"^4.17.21\",\r\n    \"@types/inquirer\": \"^8.2.5\",\r\n    \"@types/node\": \"^18.11.0\",\r\n    \"@types/uuid\": \"^8.3.4\",\r\n    \"@typescript-eslint/eslint-plugin\": \"^6.19.1\",\r\n    \"@typescript-eslint/parser\": \"^6.19.1\",\r\n    \"chalk\": \"^4.1.0\",\r\n    \"cli\": \"^1.0.1\",\r\n    \"copy-webpack-plugin\": \"^11.0.0\",\r\n    \"eslint-plugin-deprecation\": \"^2.0.0\",\r\n    \"express\": \"^4.18.2\",\r\n    \"nestia\": \"^5.3.0\",\r\n    \"prettier\": \"^3.2.4\",\r\n    \"prettier-plugin-prisma\": \"^5.0.0\",\r\n    \"rimraf\": \"^3.0.2\",\r\n    \"source-map-support\": \"^0.5.21\",\r\n    \"swagger-ui-express\": \"^5.0.0\",\r\n    \"ts-loader\": \"^9.5.1\",\r\n    \"ts-node\": \"^10.9.1\",\r\n    \"ts-patch\": \"^3.0.2\",\r\n    \"typescript\": \"^5.3.2\",\r\n    \"typescript-transform-paths\": \"^3.4.6\",\r\n    \"webpack\": \"^5.89.0\",\r\n    \"webpack-cli\": \"^5.1.4\",\r\n    \"write-file-webpack-plugin\": \"^4.5.1\"\r\n  },\r\n  \"dependencies\": {\r\n    \"@nestia/core\": \"^2.5.16\",\r\n    \"@nestia/fetcher\": \"^2.5.16\",\r\n    \"@nestjs/common\": \"^10.3.4\",\r\n    \"@nestjs/core\": \"^10.3.4\",\r\n    \"@nestjs/platform-express\": \"^10.3.4\",\r\n    \"commander\": \"10.0.0\",\r\n    \"dotenv\": \"^16.3.1\",\r\n    \"dotenv-expand\": \"^10.0.0\",\r\n    \"inquirer\": \"8.2.5\",\r\n    \"serialize-error\": \"^4.1.0\",\r\n    \"tstl\": \"^2.5.13\",\r\n    \"typia\": \"^5.5.7\",\r\n    \"uuid\": \"^9.0.0\"\r\n  },\r\n  \"stackblitz\": {\r\n    \"startCommand\": \"npm run prepare && npm run build:test && npm run test\"\r\n  }\r\n}"
   },
   {
     "location": "packages/api",
@@ -62,7 +62,7 @@ export const NEST_TEMPLATE = [
   {
     "location": "packages/api",
     "file": "package.json",
-    "content": "{\r\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\r\n  \"version\": \"0.1.0\",\r\n  \"description\": \"SDK library generated by Nestia\",\r\n  \"main\": \"lib/index.js\",\r\n  \"typings\": \"lib/index.d.ts\",\r\n  \"scripts\": {\r\n    \"build\": \"npm run build:sdk && npm run compile\",\r\n    \"build:sdk\": \"rimraf ../../src/api/functional && cd ../.. && npx nestia sdk && cd packages/api\",\r\n    \"compile\": \"rimraf lib && tsc\",\r\n    \"deploy\": \"npm run build && npm publish\",\r\n    \"prepare\": \"ts-patch install && typia patch\"\r\n  },\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"https://github.com/samchon/nestia\"\r\n  },\r\n  \"author\": \"Jeongho Nam\",\r\n  \"license\": \"MIT\",\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/samchon/nestia/issues\"\r\n  },\r\n  \"homepage\": \"https://nestia.io\",\r\n  \"files\": [\r\n    \"lib\",\r\n    \"swagger.json\",\r\n    \"package.json\",\r\n    \"README.md\"\r\n  ],\r\n  \"devDependencies\": {\r\n    \"rimraf\": \"^5.0.5\",\r\n    \"ts-node\": \"^10.9.2\",\r\n    \"ts-patch\": \"^3.1.2\",\r\n    \"typescript\": \"^5.3.3\"\r\n  },\r\n  \"dependencies\": {\r\n    \"@nestia/fetcher\": \"^2.5.12\",\r\n    \"typia\": \"^5.4.14\"\r\n  }\r\n}"
+    "content": "{\r\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\r\n  \"version\": \"0.1.0\",\r\n  \"description\": \"SDK library generated by Nestia\",\r\n  \"main\": \"lib/index.js\",\r\n  \"typings\": \"lib/index.d.ts\",\r\n  \"scripts\": {\r\n    \"build\": \"npm run build:sdk && npm run compile\",\r\n    \"build:sdk\": \"rimraf ../../src/api/functional && cd ../.. && npx nestia sdk && cd packages/api\",\r\n    \"compile\": \"rimraf lib && tsc\",\r\n    \"deploy\": \"npm run build && npm publish\",\r\n    \"prepare\": \"ts-patch install && typia patch\"\r\n  },\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"https://github.com/samchon/nestia\"\r\n  },\r\n  \"author\": \"Jeongho Nam\",\r\n  \"license\": \"MIT\",\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/samchon/nestia/issues\"\r\n  },\r\n  \"homepage\": \"https://nestia.io\",\r\n  \"files\": [\r\n    \"lib\",\r\n    \"swagger.json\",\r\n    \"package.json\",\r\n    \"README.md\"\r\n  ],\r\n  \"devDependencies\": {\r\n    \"rimraf\": \"^5.0.5\",\r\n    \"ts-node\": \"^10.9.2\",\r\n    \"ts-patch\": \"^3.1.2\",\r\n    \"typescript\": \"^5.3.3\"\r\n  },\r\n  \"dependencies\": {\r\n    \"@nestia/fetcher\": \"^2.5.16\",\r\n    \"typia\": \"^5.5.7\"\r\n  }\r\n}"
   },
   {
     "location": "packages/api",

package/src/bundles/SDK_TEMPLATE.ts

@@ -22,7 +22,7 @@ export const SDK_TEMPLATE = [
   {
     "location": "",
     "file": "package.json",
-    "content": "{\r\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\r\n  \"version\": \"0.1.0\",\r\n  \"description\": \"SDK library generated by Nestia\",\r\n  \"main\": \"lib/index.js\",\r\n  \"typings\": \"lib/index.d.ts\",\r\n  \"scripts\": {\r\n    \"build\": \"rimraf lib && tsc\",\r\n    \"build:test\": \"rimraf bin && tsc --project test/tsconfig.json\",\r\n    \"deploy\": \"npm run build && npm publish\",\r\n    \"dev\": \"npm run build:test -- --watch\",\r\n    \"prepare\": \"ts-patch install && typia patch\",\r\n    \"start\": \"npx ts-node test/start.ts\",\r\n    \"test\": \"npx ts-node test/index.ts\",\r\n    \"test:simulate\": \"npx ts-node test/index.ts --simulate true\"\r\n  },\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"https://github.com/samchon/nestia\"\r\n  },\r\n  \"author\": \"Jeongho Nam\",\r\n  \"license\": \"MIT\",\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/samchon/nestia/issues\"\r\n  },\r\n  \"homepage\": \"https://nestia.io\",\r\n  \"files\": [\r\n    \"lib\",\r\n    \"swagger.json\",\r\n    \"package.json\",\r\n    \"README.md\"\r\n  ],\r\n  \"devDependencies\": {\r\n    \"@nestia/e2e\": \"^0.4.1\",\r\n    \"@types/inquirer\": \"8.2.5\",\r\n    \"commander\": \"^10.0.0\",\r\n    \"inquirer\": \"8.2.5\",\r\n    \"prettier\": \"^3.2.5\",\r\n    \"rimraf\": \"^5.0.5\",\r\n    \"ts-node\": \"^10.9.2\",\r\n    \"ts-patch\": \"^3.1.2\",\r\n    \"typescript\": \"^5.3.3\",\r\n    \"typescript-transform-paths\": \"^3.4.6\"\r\n  },\r\n  \"dependencies\": {\r\n    \"@nestia/fetcher\": \"^2.5.12\",\r\n    \"typia\": \"^5.4.14\"\r\n  }\r\n}"
+    "content": "{\r\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\r\n  \"version\": \"0.1.0\",\r\n  \"description\": \"SDK library generated by Nestia\",\r\n  \"main\": \"lib/index.js\",\r\n  \"typings\": \"lib/index.d.ts\",\r\n  \"scripts\": {\r\n    \"build\": \"rimraf lib && tsc\",\r\n    \"build:test\": \"rimraf bin && tsc --project test/tsconfig.json\",\r\n    \"deploy\": \"npm run build && npm publish\",\r\n    \"dev\": \"npm run build:test -- --watch\",\r\n    \"prepare\": \"ts-patch install && typia patch\",\r\n    \"start\": \"npx ts-node test/start.ts\",\r\n    \"test\": \"npx ts-node test/index.ts\",\r\n    \"test:simulate\": \"npx ts-node test/index.ts --simulate true\"\r\n  },\r\n  \"repository\": {\r\n    \"type\": \"git\",\r\n    \"url\": \"https://github.com/samchon/nestia\"\r\n  },\r\n  \"author\": \"Jeongho Nam\",\r\n  \"license\": \"MIT\",\r\n  \"bugs\": {\r\n    \"url\": \"https://github.com/samchon/nestia/issues\"\r\n  },\r\n  \"homepage\": \"https://nestia.io\",\r\n  \"files\": [\r\n    \"lib\",\r\n    \"swagger.json\",\r\n    \"package.json\",\r\n    \"README.md\"\r\n  ],\r\n  \"devDependencies\": {\r\n    \"@nestia/e2e\": \"^0.4.1\",\r\n    \"@types/inquirer\": \"8.2.5\",\r\n    \"commander\": \"^10.0.0\",\r\n    \"inquirer\": \"8.2.5\",\r\n    \"prettier\": \"^3.2.5\",\r\n    \"rimraf\": \"^5.0.5\",\r\n    \"ts-node\": \"^10.9.2\",\r\n    \"ts-patch\": \"^3.1.2\",\r\n    \"typescript\": \"^5.3.3\",\r\n    \"typescript-transform-paths\": \"^3.4.6\"\r\n  },\r\n  \"dependencies\": {\r\n    \"@nestia/fetcher\": \"^2.5.16\",\r\n    \"typia\": \"^5.5.7\"\r\n  }\r\n}"
   },
   {
     "location": "",

package/src/programmers/MigrateSchemaProgrammer.ts

@@ -7,7 +7,7 @@ import { Escaper } from "typia/lib/utils/Escaper";
 import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { ISwaggerSchema } from "../structures/ISwaggerSchema";
 import { FilePrinter } from "../utils/FilePrinter";
-import { SwaggerSwaggerChecker } from "../utils/SwaggerTypeChecker";
+import { SwaggerTypeChecker } from "../utils/SwaggerTypeChecker";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
 
 export namespace MigrateSchemaProgrammer {
@@ -19,34 +19,32 @@ export namespace MigrateSchemaProgrammer {
     (importer: MigrateImportProgrammer) =>
     (schema: ISwaggerSchema): ts.TypeNode => {
       const union: ts.TypeNode[] = [];
-      if (SwaggerSwaggerChecker.isUnknown(schema))
+      if (SwaggerTypeChecker.isUnknown(schema))
         return TypeFactory.keyword("any");
-      else if (SwaggerSwaggerChecker.isNullOnly(schema))
-        return createNode("null");
-      else if (SwaggerSwaggerChecker.isNullable(components)(schema))
+      else if (SwaggerTypeChecker.isNullOnly(schema)) return createNode("null");
+      else if (SwaggerTypeChecker.isNullable(components)(schema))
         union.push(createNode("null"));
 
       const type: ts.TypeNode = (() => {
         // ATOMIC
-        if (SwaggerSwaggerChecker.isBoolean(schema))
-          return writeBoolean(schema);
-        else if (SwaggerSwaggerChecker.isInteger(schema))
+        if (SwaggerTypeChecker.isBoolean(schema)) return writeBoolean(schema);
+        else if (SwaggerTypeChecker.isInteger(schema))
           return writeInteger(importer)(schema);
-        else if (SwaggerSwaggerChecker.isNumber(schema))
+        else if (SwaggerTypeChecker.isNumber(schema))
           return writeNumber(importer)(schema);
         // INSTANCES
-        else if (SwaggerSwaggerChecker.isString(schema))
+        else if (SwaggerTypeChecker.isString(schema))
           return writeString(importer)(schema);
-        else if (SwaggerSwaggerChecker.isArray(schema))
+        else if (SwaggerTypeChecker.isArray(schema))
           return writeArray(components)(importer)(schema);
-        else if (SwaggerSwaggerChecker.isObject(schema))
+        else if (SwaggerTypeChecker.isObject(schema))
           return writeObject(components)(importer)(schema);
-        else if (SwaggerSwaggerChecker.isReference(schema))
+        else if (SwaggerTypeChecker.isReference(schema))
           return writeReference(components)(importer)(schema);
         // NESTED UNION
-        else if (SwaggerSwaggerChecker.isAnyOf(schema))
+        else if (SwaggerTypeChecker.isAnyOf(schema))
           return writeUnion(components)(importer)(schema.anyOf);
-        else if (SwaggerSwaggerChecker.isOneOf(schema))
+        else if (SwaggerTypeChecker.isOneOf(schema))
           return writeUnion(components)(importer)(schema.oneOf);
         else return TypeFactory.keyword("any");
       })();
@@ -236,6 +234,8 @@ export namespace MigrateSchemaProgrammer {
     (
       schema: ISwaggerSchema.IReference,
     ): ts.TypeReferenceNode | ts.KeywordTypeNode => {
+      if (schema.$ref.startsWith("#/components/schemas") === false)
+        return TypeFactory.keyword("any");
       const name: string = schema.$ref.split("/").at(-1)!;
       return name === ""
         ? TypeFactory.keyword("any")

package/src/structures/ISwagger.ts

@@ -16,5 +16,8 @@ export namespace ISwagger {
     url: string;
     description?: string;
   }
-  export type IPath = Record<string, ISwaggerRoute>;
+  export type IPath = Record<
+    "get" | "post" | "patch" | "put" | "delete",
+    ISwaggerRoute | undefined
+  >;
 }

package/src/structures/ISwaggerComponents.ts

@@ -1,7 +1,9 @@
+import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
 import { ISwaggerSchema } from "./ISwaggerSchema";
 import { ISwaggerSecurityScheme } from "./ISwaggerSecurityScheme";
 
 export interface ISwaggerComponents {
+  parameters?: Record<string, ISwaggerRouteParameter>;
   schemas?: Record<string, ISwaggerSchema>;
   securitySchemes?: Record<string, ISwaggerSecurityScheme>;
   namespace?: string;

package/src/structures/ISwaggerRoute.ts

@@ -1,9 +1,10 @@
 import { IJsDocTagInfo } from "typia/lib/schemas/metadata/IJsDocTagInfo";
 
+import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
 import { ISwaggerSchema } from "./ISwaggerSchema";
 
 export interface ISwaggerRoute {
-  parameters?: ISwaggerRoute.IParameter[];
+  parameters?: (ISwaggerRouteParameter | ISwaggerRouteParameter.IReference)[];
   requestBody?: ISwaggerRoute.IRequestBody;
   responses?: ISwaggerRoute.IResponseBody;
   summary?: string;
@@ -14,13 +15,6 @@ export interface ISwaggerRoute {
   "x-nestia-jsDocTags"?: IJsDocTagInfo[];
 }
 export namespace ISwaggerRoute {
-  export interface IParameter {
-    name?: string;
-    in: "path" | "query" | "header" | "cookie";
-    schema: ISwaggerSchema;
-    required?: boolean;
-    description?: string;
-  }
   export interface IRequestBody {
     description?: string;
     content: IContent;