@nestia/migrate 0.9.6 → 0.10.0

package/src/analyzers/MigrateMethodAnalyzer.ts

@@ -1,12 +1,17 @@
+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 { ISwaggerRouteBodyContent } from "../structures/ISwaggerRouteBodyContent";
+import { ISwaggerRouteParameter } from "../structures/ISwaggerRouteParameter";
+import { ISwaggerRouteResponse } from "../structures/ISwaggerRouteResponse";
 import { ISwaggerSchema } from "../structures/ISwaggerSchema";
 import { StringUtil } from "../utils/StringUtil";
-import { SwaggerSwaggerChecker } from "../utils/SwaggerTypeChecker";
+import { SwaggerComponentsExplorer } from "../utils/SwaggerComponentsExplorer";
+import { SwaggerTypeChecker } from "../utils/SwaggerTypeChecker";
 
 export namespace MigrateMethodAnalzyer {
   export const analyze =
@@ -19,12 +24,46 @@ export namespace MigrateMethodAnalzyer {
       const success = emplaceBodySchema("response")(
         emplaceReference(props.swagger)("response"),
       )(
-        route.responses?.["201"] ??
-          route.responses?.["200"] ??
-          route.responses?.default,
+        (() => {
+          const response =
+            route.responses?.["201"] ??
+            route.responses?.["200"] ??
+            route.responses?.default;
+          if (response === undefined) return undefined;
+          SwaggerComponentsExplorer.getResponse(props.swagger.components)(
+            response,
+          ) ?? undefined;
+        })(),
       );
 
       const failures: string[] = [];
+      for (const p of route.parameters ?? [])
+        if (
+          SwaggerComponentsExplorer.getParameter(props.swagger.components)(
+            p,
+          ) === null
+        )
+          failures.push(
+            `parameter "${(p as ISwaggerRouteParameter.IReference).$ref}" is not defined in "components.parameters".`,
+          );
+      for (const value of Object.values(route.responses ?? {}))
+        if (
+          SwaggerComponentsExplorer.getResponse(props.swagger.components)(
+            value,
+          ) === null
+        )
+          failures.push(
+            `response "${(value as ISwaggerRouteResponse.IReference).$ref}" is not defined in "components.responses".`,
+          );
+      if (
+        route.requestBody &&
+        SwaggerComponentsExplorer.getRequestBody(props.swagger.components)(
+          route.requestBody,
+        ) === null
+      )
+        failures.push(
+          `requestBody "${(route.requestBody as ISwaggerRouteParameter.IReference).$ref}" is not defined in "components.requestBodies".`,
+        );
       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 +78,27 @@ 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) =>
+              SwaggerComponentsExplorer.getParameter(props.swagger.components)(
+                p,
+              )?.in === type,
+          )
+          .map(
+            (p) =>
+              SwaggerComponentsExplorer.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 +109,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 +124,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 +135,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 +201,11 @@ export namespace MigrateMethodAnalzyer {
         );
       if (
         parameterNames.length !==
-        (route.parameters ?? []).filter((p) => p.in === "path").length
+        (route.parameters ?? []).filter(
+          (p) =>
+            SwaggerComponentsExplorer.getParameter(props.swagger.components)(p)
+              ?.in === "path",
+        ).length
       )
         failures.push(
           "number of path parameters are not matched with its full path.",
@@ -179,7 +232,10 @@ export namespace MigrateMethodAnalzyer {
             }
           : null,
         parameters: (route.parameters ?? [])
-          .filter((p) => p.in === "path")
+          .map((p) =>
+            SwaggerComponentsExplorer.getParameter(props.swagger.components)(p),
+          )
+          .filter((p) => p !== null && p.in === "path")
           .map((p, i) => ({
             name: parameterNames[i],
             key: (() => {
@@ -191,8 +247,8 @@ export namespace MigrateMethodAnalzyer {
               }
             })(),
             schema: {
-              ...p.schema,
-              description: p.schema.description ?? p.description,
+              ...p!.schema,
+              description: p!.schema.description ?? p!.description,
             },
           })),
         query: query
@@ -211,74 +267,94 @@ export namespace MigrateMethodAnalzyer {
                 key !== "200" &&
                 key !== "201" &&
                 key !== "default" &&
-                !!value.content?.["application/json"],
+                !!SwaggerComponentsExplorer.getResponse(
+                  props.swagger.components,
+                )(value)?.content?.["application/json"],
             )
-            .map(([key, value]) => [
-              key,
-              {
-                description: value.description,
-                schema: value.content?.["application/json"]?.schema ?? {},
-              },
-            ]),
+            .map(([key, value]) => {
+              const r = SwaggerComponentsExplorer.getResponse(
+                props.swagger.components,
+              )(value)!;
+              return [
+                key,
+                {
+                  description: r.description,
+                  schema: r.content?.["application/json"]?.schema ?? {},
+                },
+              ];
+            }),
         ),
         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") =>
     (emplacer: (schema: ISwaggerSchema) => ISwaggerSchema.IReference) =>
     (meta?: {
       description?: string;
-      content?: ISwaggerRoute.IContent;
+      content?: ISwaggerRouteBodyContent;
       "x-nestia-encrypted"?: boolean;
     }): false | null | IMigrateRoute.IBody => {
       if (!meta?.content) return null;

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.15\",\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.15\",\r\n    \"@nestia/fetcher\": \"^2.5.15\",\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.5.3\",\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.5\",\r\n    \"@nestjs/core\": \"^10.3.5\",\r\n    \"@nestjs/platform-express\": \"^10.3.5\",\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.15\",\r\n    \"typia\": \"^5.5.3\"\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.15\",\r\n    \"typia\": \"^5.5.3\"\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,10 +234,15 @@ 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")
-        : importer.dto(schema.$ref.split("/").at(-1)!, components.namespace);
+        : importer.dto(
+            schema.$ref.split("/").at(-1)!,
+            components["x-nestia-namespace"],
+          );
     };
 
   /* -----------------------------------------------------------

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,8 +1,14 @@
+import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
+import { ISwaggerRouteRequestBody } from "./ISwaggerRouteRequestBody";
+import { ISwaggerRouteResponse } from "./ISwaggerRouteResponse";
 import { ISwaggerSchema } from "./ISwaggerSchema";
 import { ISwaggerSecurityScheme } from "./ISwaggerSecurityScheme";
 
 export interface ISwaggerComponents {
+  parameters?: Record<string, ISwaggerRouteParameter>;
+  requestBodies?: Record<string, ISwaggerRouteRequestBody>;
+  responses?: Record<string, ISwaggerRouteResponse>;
   schemas?: Record<string, ISwaggerSchema>;
   securitySchemes?: Record<string, ISwaggerSecurityScheme>;
-  namespace?: string;
+  "x-nestia-namespace"?: string;
 }

package/src/structures/ISwaggerRoute.ts

@@ -1,11 +1,16 @@
 import { IJsDocTagInfo } from "typia/lib/schemas/metadata/IJsDocTagInfo";
 
-import { ISwaggerSchema } from "./ISwaggerSchema";
+import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
+import { ISwaggerRouteRequestBody } from "./ISwaggerRouteRequestBody";
+import { ISwaggerRouteResponse } from "./ISwaggerRouteResponse";
 
 export interface ISwaggerRoute {
-  parameters?: ISwaggerRoute.IParameter[];
-  requestBody?: ISwaggerRoute.IRequestBody;
-  responses?: ISwaggerRoute.IResponseBody;
+  parameters?: (ISwaggerRouteParameter | ISwaggerRouteParameter.IReference)[];
+  requestBody?: ISwaggerRouteRequestBody;
+  responses?: Record<
+    string,
+    ISwaggerRouteResponse | ISwaggerRouteResponse.IReference
+  >;
   summary?: string;
   description?: string;
   deprecated?: boolean;
@@ -13,43 +18,3 @@ export interface ISwaggerRoute {
   tags?: string[];
   "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;
-    required?: boolean;
-    "x-nestia-encrypted"?: boolean;
-  }
-  export type IResponseBody = Record<
-    string,
-    {
-      description?: string;
-      content?: IContent;
-      "x-nestia-encrypted"?: boolean;
-    }
-  >;
-  export interface IContent {
-    "text/plain"?: {
-      schema: ISwaggerSchema;
-    };
-    "application/json"?: {
-      schema: ISwaggerSchema;
-    };
-    "application/x-www-form-urlencoded"?: {
-      schema: ISwaggerSchema;
-    };
-    "multipart/form-data"?: {
-      schema: ISwaggerSchema;
-    };
-    "*/*"?: {
-      schema: ISwaggerSchema;
-    };
-  }
-}

package/src/structures/ISwaggerRouteBodyContent.ts

@@ -0,0 +1,15 @@
+import { ISwaggerSchema } from "./ISwaggerSchema";
+
+export interface ISwaggerRouteBodyContent {
+  "text/plain"?: ISwaggerRouteBodyContent.IMediaType;
+  "application/json"?: ISwaggerRouteBodyContent.IMediaType;
+  "application/x-www-form-urlencoded"?: ISwaggerRouteBodyContent.IMediaType;
+  "multipart/form-data"?: ISwaggerRouteBodyContent.IMediaType;
+  "*/*"?: ISwaggerRouteBodyContent.IMediaType;
+}
+export namespace ISwaggerRouteBodyContent {
+  export interface IMediaType {
+    schema?: ISwaggerSchema;
+    "x-nestia-encrypted"?: boolean;
+  }
+}

package/src/structures/ISwaggerRouteParameter.ts

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

package/src/structures/ISwaggerRouteRequestBody.ts

@@ -0,0 +1,12 @@
+import { ISwaggerRouteBodyContent } from "./ISwaggerRouteBodyContent";
+
+export interface ISwaggerRouteRequestBody {
+  description?: string;
+  required?: boolean;
+  content?: ISwaggerRouteBodyContent;
+}
+export namespace ISwaggerRouteRequestBody {
+  export interface IReference {
+    $ref: `#/components/requestBodies/${string}`;
+  }
+}

package/src/structures/ISwaggerRouteResponse.ts

@@ -0,0 +1,11 @@
+import { ISwaggerRouteBodyContent } from "./ISwaggerRouteBodyContent";
+
+export interface ISwaggerRouteResponse {
+  description?: string;
+  content?: ISwaggerRouteBodyContent;
+}
+export namespace ISwaggerRouteResponse {
+  export interface IReference {
+    $ref: `#/components/responses/${string}`;
+  }
+}