@nestia/migrate 0.12.1 → 0.13.0-dev.20240411-2

package/src/analyzers/MigrateMethodAnalyzer.ts

@@ -1,71 +1,28 @@
-import typia from "typia";
+import { OpenApi } from "@samchon/openapi";
 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 { OpenApiTypeChecker } from "../utils/OpenApiTypeChecker";
 import { StringUtil } from "../utils/StringUtil";
-import { SwaggerComponentsExplorer } from "../utils/SwaggerComponentsExplorer";
-import { SwaggerTypeChecker } from "../utils/SwaggerTypeChecker";
 
 export namespace MigrateMethodAnalzyer {
   export const analyze =
     (props: Omit<IMigrateProgram.IProps, "dictionary">) =>
     (endpoint: { path: string; method: string }) =>
-    (route: ISwaggerRoute): IMigrateRoute | null => {
+    (route: OpenApi.IOperation): IMigrateRoute | null => {
       const body = emplaceBodySchema("request")(
-        emplaceReference(props.swagger)("body"),
+        emplaceReference(props.document)("body"),
       )(route.requestBody);
       const success = emplaceBodySchema("response")(
-        emplaceReference(props.swagger)("response"),
+        emplaceReference(props.document)("response"),
       )(
-        (() => {
-          const response =
-            route.responses?.["201"] ??
-            route.responses?.["200"] ??
-            route.responses?.default;
-          if (response === undefined) return undefined;
-          return (
-            SwaggerComponentsExplorer.getResponse(props.swagger.components)(
-              response,
-            ) ?? undefined
-          );
-        })(),
+        route.responses?.["201"] ??
+          route.responses?.["200"] ??
+          route.responses?.default,
       );
 
       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.`,
@@ -80,28 +37,18 @@ export namespace MigrateMethodAnalzyer {
         );
 
       const [headers, query] = ["header", "query"].map((type) => {
-        const parameters: ISwaggerRouteParameter[] = (route.parameters ?? [])
-          .filter(
-            (p) =>
-              SwaggerComponentsExplorer.getParameter(props.swagger.components)(
-                p,
-              )?.in === type,
-          )
-          .map(
-            (p) =>
-              SwaggerComponentsExplorer.getParameter(props.swagger.components)(
-                p,
-              )!,
-          );
+        const parameters: OpenApi.IOperation.IParameter[] = (
+          route.parameters ?? []
+        ).filter((p) => p.in === type);
         if (parameters.length === 0) return null;
 
         const objects = parameters
           .map((p) =>
-            SwaggerTypeChecker.isObject(p.schema)
+            OpenApiTypeChecker.isObject(p.schema)
               ? p.schema
-              : SwaggerTypeChecker.isReference(p.schema) &&
-                  SwaggerTypeChecker.isObject(
-                    (props.swagger.components.schemas ?? {})[
+              : OpenApiTypeChecker.isReference(p.schema) &&
+                  OpenApiTypeChecker.isObject(
+                    props.document.components.schemas[
                       p.schema.$ref.replace(`#/components/schemas/`, ``)
                     ] ?? {},
                   )
@@ -111,11 +58,11 @@ export namespace MigrateMethodAnalzyer {
           .filter((s) => !!s);
         const primitives = parameters.filter(
           (p) =>
-            SwaggerTypeChecker.isBoolean(p.schema) ||
-            SwaggerTypeChecker.isNumber(p.schema) ||
-            SwaggerTypeChecker.isInteger(p.schema) ||
-            SwaggerTypeChecker.isString(p.schema) ||
-            SwaggerTypeChecker.isArray(p.schema),
+            OpenApiTypeChecker.isBoolean(p.schema) ||
+            OpenApiTypeChecker.isInteger(p.schema) ||
+            OpenApiTypeChecker.isNumber(p.schema) ||
+            OpenApiTypeChecker.isString(p.schema) ||
+            OpenApiTypeChecker.isArray(p.schema),
         );
         if (objects.length === 1 && primitives.length === 0) return objects[0];
         else if (objects.length > 1) {
@@ -125,23 +72,23 @@ export namespace MigrateMethodAnalzyer {
           return false;
         }
 
-        const dto: ISwaggerSchema.IObject | null = objects[0]
-          ? SwaggerTypeChecker.isObject(objects[0])
+        const dto: OpenApi.IJsonSchema.IObject | null = objects[0]
+          ? OpenApiTypeChecker.isObject(objects[0])
             ? objects[0]
-            : ((props.swagger.components.schemas ?? {})[
-                (objects[0] as ISwaggerSchema.IReference).$ref.replace(
+            : ((props.document.components.schemas ?? {})[
+                (objects[0] as OpenApi.IJsonSchema.IReference).$ref.replace(
                   `#/components/schemas/`,
                   ``,
                 )
-              ] as ISwaggerSchema.IObject)
+              ] as OpenApi.IJsonSchema.IObject)
           : null;
-        const entire: ISwaggerSchema.IObject[] = [
+        const entire: OpenApi.IJsonSchema.IObject[] = [
           ...objects.map((o) =>
-            SwaggerTypeChecker.isObject(o)
+            OpenApiTypeChecker.isObject(o)
               ? o
-              : (props.swagger.components.schemas?.[
+              : (props.document.components.schemas?.[
                   o.$ref.replace(`#/components/schemas/`, ``)
-                ]! as ISwaggerSchema.IObject),
+                ]! as OpenApi.IJsonSchema.IObject),
           ),
           {
             type: "object",
@@ -163,14 +110,14 @@ export namespace MigrateMethodAnalzyer {
         ];
         return parameters.length === 0
           ? null
-          : emplaceReference(props.swagger)(
+          : emplaceReference(props.document)(
               StringUtil.pascal(`I/Api/${endpoint.path}`) +
                 "." +
                 StringUtil.pascal(`${endpoint.method}/${type}`),
             )({
               type: "object",
               properties: Object.fromEntries([
-                ...new Map<string, ISwaggerSchema>(
+                ...new Map<string, OpenApi.IJsonSchema>(
                   entire
                     .map((o) =>
                       Object.entries(o.properties ?? {}).map(
@@ -181,7 +128,7 @@ export namespace MigrateMethodAnalzyer {
                               ...schema,
                               description:
                                 schema.description ?? schema.description,
-                            } as ISwaggerSchema,
+                            } as OpenApi.IJsonSchema,
                           ] as const,
                       ),
                     )
@@ -203,11 +150,7 @@ export namespace MigrateMethodAnalzyer {
         );
       if (
         parameterNames.length !==
-        (route.parameters ?? []).filter(
-          (p) =>
-            SwaggerComponentsExplorer.getParameter(props.swagger.components)(p)
-              ?.in === "path",
-        ).length
+        route.parameters.filter((p) => p.in === "path").length
       )
         failures.push(
           "number of path parameters are not matched with its full path.",
@@ -233,11 +176,8 @@ export namespace MigrateMethodAnalzyer {
               schema: headers,
             }
           : null,
-        parameters: (route.parameters ?? [])
-          .map((p) =>
-            SwaggerComponentsExplorer.getParameter(props.swagger.components)(p),
-          )
-          .filter((p) => p !== null && p.in === "path")
+        parameters: route.parameters
+          .filter((p) => p.in === "path")
           .map((p, i) => ({
             name: parameterNames[i],
             key: (() => {
@@ -265,105 +205,77 @@ export namespace MigrateMethodAnalzyer {
         exceptions: Object.fromEntries(
           Object.entries(route.responses ?? {})
             .filter(
-              ([key, value]) =>
-                key !== "200" &&
-                key !== "201" &&
-                key !== "default" &&
-                !!SwaggerComponentsExplorer.getResponse(
-                  props.swagger.components,
-                )(value)?.content?.["application/json"],
+              ([key]) => key !== "200" && key !== "201" && key !== "default",
             )
-            .map(([key, value]) => {
-              const r = SwaggerComponentsExplorer.getResponse(
-                props.swagger.components,
-              )(value)!;
-              return [
-                key,
-                {
-                  description: r.description,
-                  schema: r.content?.["application/json"]?.schema ?? {},
-                },
-              ];
-            }),
+            .map(([key, value]) => [
+              key,
+              {
+                description: value.description,
+                schema: value.content?.["application/json"]?.schema ?? {},
+              },
+            ]),
         ),
         deprecated: route.deprecated ?? false,
-        comment: () => describe(props.swagger)(route),
+        comment: () => describe(route),
         tags: route.tags ?? [],
       };
     };
 
-  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 ?? []) {
-        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 describe = (route: OpenApi.IOperation): string => {
+    const commentTags: string[] = [];
+    const add = (text: string) => {
+      if (commentTags.every((line) => line !== text)) commentTags.push(text);
     };
 
-  const isNotObjectLiteral = (schema: ISwaggerSchema): boolean =>
-    SwaggerTypeChecker.isReference(schema) ||
-    SwaggerTypeChecker.isBoolean(schema) ||
-    SwaggerTypeChecker.isNumber(schema) ||
-    SwaggerTypeChecker.isString(schema) ||
-    SwaggerTypeChecker.isUnknown(schema) ||
-    (SwaggerTypeChecker.isAnyOf(schema) &&
-      schema.anyOf.every(isNotObjectLiteral)) ||
-    (SwaggerTypeChecker.isOneOf(schema) &&
+    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))
+        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");
+  };
+
+  const isNotObjectLiteral = (schema: OpenApi.IJsonSchema): boolean =>
+    OpenApiTypeChecker.isReference(schema) ||
+    OpenApiTypeChecker.isBoolean(schema) ||
+    OpenApiTypeChecker.isNumber(schema) ||
+    OpenApiTypeChecker.isString(schema) ||
+    OpenApiTypeChecker.isUnknown(schema) ||
+    (OpenApiTypeChecker.isOneOf(schema) &&
       schema.oneOf.every(isNotObjectLiteral)) ||
-    (SwaggerTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
+    (OpenApiTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
 
   const emplaceBodySchema =
     (from: "request" | "response") =>
-    (emplacer: (schema: ISwaggerSchema) => ISwaggerSchema.IReference) =>
+    (
+      emplacer: (schema: OpenApi.IJsonSchema) => OpenApi.IJsonSchema.IReference,
+    ) =>
     (meta?: {
       description?: string;
-      content?: ISwaggerRouteBodyContent;
+      content?: Record<string, OpenApi.IOperation.IMediaType>; // ISwaggerRouteBodyContent;
       "x-nestia-encrypted"?: boolean;
     }): false | null | IMigrateRoute.IBody => {
       if (!meta?.content) return null;
 
-      const entries: [string, { schema: ISwaggerSchema }][] = Object.entries(
+      const entries: [string, OpenApi.IOperation.IMediaType][] = Object.entries(
         meta.content,
-      );
+      ).filter(([_, v]) => !!v);
       const json = entries.find((e) =>
         meta["x-nestia-encrypted"] === true
           ? e[0].includes("text/plain") || e[0].includes("application/json")
@@ -375,7 +287,11 @@ export namespace MigrateMethodAnalzyer {
           type: "application/json",
           name: "body",
           key: "body",
-          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          schema: schema
+            ? isNotObjectLiteral(schema)
+              ? schema
+              : emplacer(schema)
+            : {},
           "x-nestia-encrypted": meta["x-nestia-encrypted"],
         };
       }
@@ -389,7 +305,11 @@ export namespace MigrateMethodAnalzyer {
           type: "application/x-www-form-urlencoded",
           name: "body",
           key: "body",
-          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          schema: schema
+            ? isNotObjectLiteral(schema)
+              ? schema
+              : emplacer(schema)
+            : {},
         };
       }
 
@@ -412,7 +332,11 @@ export namespace MigrateMethodAnalzyer {
             type: "multipart/form-data",
             name: "body",
             key: "body",
-            schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+            schema: schema
+              ? isNotObjectLiteral(schema)
+                ? schema
+                : emplacer(schema)
+              : {},
           };
         }
       }
@@ -420,9 +344,9 @@ export namespace MigrateMethodAnalzyer {
     };
 
   const emplaceReference =
-    (swagger: ISwagger) =>
+    (swagger: OpenApi.IDocument) =>
     (name: string) =>
-    (schema: ISwaggerSchema): ISwaggerSchema.IReference => {
+    (schema: OpenApi.IJsonSchema): OpenApi.IJsonSchema.IReference => {
       swagger.components.schemas ??= {};
       swagger.components.schemas[name] = schema;
       return { $ref: `#/components/schemas/${name}` };

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.2\",\r\n    \"@nestia/sdk\": \"^2.6.4\",\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.6.4\",\r\n    \"@nestia/fetcher\": \"^2.6.4\",\r\n    \"@nestjs/common\": \"^10.3.7\",\r\n    \"@nestjs/core\": \"^10.3.7\",\r\n    \"@nestjs/platform-express\": \"^10.3.7\",\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\": \"^3.0.0\",\r\n    \"typia\": \"^5.5.10\",\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.3\",\r\n    \"@nestia/sdk\": \"^2.6.4\",\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.6.4\",\r\n    \"@nestia/fetcher\": \"^2.6.4\",\r\n    \"@nestjs/common\": \"^10.3.7\",\r\n    \"@nestjs/core\": \"^10.3.7\",\r\n    \"@nestjs/platform-express\": \"^10.3.7\",\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\": \"^3.0.0\",\r\n    \"typia\": \"^5.5.10\",\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",

package/src/factories/TypeLiteralFactory.ts

@@ -21,7 +21,14 @@ export namespace TypeLiteralFactory {
     ts.factory.createLiteralTypeNode(ts.factory.createStringLiteral(str));
 
   const generateNumber = (num: number) =>
-    ts.factory.createLiteralTypeNode(ts.factory.createNumericLiteral(num));
+    ts.factory.createLiteralTypeNode(
+      num < 0
+        ? ts.factory.createPrefixUnaryExpression(
+            ts.SyntaxKind.MinusToken,
+            ts.factory.createNumericLiteral(-num),
+          )
+        : ts.factory.createNumericLiteral(num),
+    );
 
   const generateBoolean = (bool: boolean) =>
     ts.factory.createLiteralTypeNode(

package/src/internal/MigrateCommander.ts

@@ -1,3 +1,4 @@
+import { OpenApi } from "@samchon/openapi";
 import fs from "fs";
 import path from "path";
 import { format } from "prettier";
@@ -5,7 +6,6 @@ import { IValidation } from "typia";
 
 import { MigrateApplication } from "../MigrateApplication";
 import { MigrateFileArchiver } from "../archivers/MigrateFileArchiver";
-import { ISwagger } from "../structures/ISwagger";
 import { MigrateInquirer } from "./MigrateInquirer";
 
 export namespace MigrateCommander {
@@ -23,19 +23,19 @@ export namespace MigrateCommander {
       halt("Output directory's parent is not a directory.");
 
     // READ SWAGGER
-    const swagger: ISwagger = (() => {
+    const document: OpenApi.IDocument = (() => {
       if (fs.existsSync(options.input) === false)
         halt("Unable to find the input swagger.json file.");
       const stats: fs.Stats = fs.statSync(options.input);
       if (stats.isFile() === false)
         halt("The input swagger.json is not a file.");
       const content: string = fs.readFileSync(options.input, "utf-8");
-      const swagger: ISwagger = JSON.parse(content);
+      const swagger: OpenApi.IDocument = JSON.parse(content);
       return swagger;
     })();
 
     const result: IValidation<MigrateApplication> =
-      await MigrateApplication.create(swagger);
+      await MigrateApplication.create(document);
     if (result.success === false) {
       console.log(result.errors);
       throw new Error(

package/src/module.ts

@@ -4,11 +4,5 @@ export * from "./analyzers/MigrateAnalyzer";
 
 export * from "./archivers/MigrateFileArchiver";
 
-export * from "./structures/ISwagger";
-export * from "./structures/ISwaggerComponents";
-export * from "./structures/ISwaggerInfo";
-export * from "./structures/ISwaggerRoute";
-export * from "./structures/ISwaggerSecurityScheme";
-export * from "./structures/ISwaggerSchema";
 export * from "./structures/IMigrateProgram";
 export * from "./structures/IMigrateSchema";

package/src/programmers/MigrateApiFileProgrammer.ts

@@ -1,9 +1,9 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 
 import { IMigrateController } from "../structures/IMigrateController";
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { MigrateApiFunctionProgrammer } from "./MigrateApiFunctionProgrammer";
 import { MigrateApiNamespaceProgrammer } from "./MigrateApiNamespaceProgrammer";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -22,7 +22,7 @@ export namespace MigrateApiFileProgrammer {
 
   export const write =
     (config: IMigrateProgram.IConfig) =>
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (props: IProps): ts.Statement[] => {
       const importer: MigrateImportProgrammer = new MigrateImportProgrammer();
       const statements: ts.Statement[] = props.entries

package/src/programmers/MigrateApiFunctionProgrammer.ts

@@ -1,10 +1,10 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
 
 import { IMigrateController } from "../structures/IMigrateController";
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { FilePrinter } from "../utils/FilePrinter";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
 import { MigrateSchemaProgrammer } from "./MigrateSchemaProgrammer";
@@ -18,7 +18,7 @@ export namespace MigrateApiFunctionProgrammer {
 
   export const write =
     (config: IMigrateProgram.IConfig) =>
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.FunctionDeclaration =>
       FilePrinter.description(
@@ -42,7 +42,7 @@ export namespace MigrateApiFunctionProgrammer {
       );
 
   export const writeParameterDeclarations =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.ParameterDeclaration[] => [
       IdentifierFactory.parameter(

package/src/programmers/MigrateApiNamespaceProgrammer.ts

@@ -1,3 +1,4 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 import { ExpressionFactory } from "typia/lib/factories/ExpressionFactory";
 import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
@@ -7,7 +8,6 @@ import { TypeFactory } from "typia/lib/factories/TypeFactory";
 import { IMigrateController } from "../structures/IMigrateController";
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { FilePrinter } from "../utils/FilePrinter";
 import { MigrateApiSimulatationProgrammer } from "./MigrateApiSimulatationProgrammer";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -22,7 +22,7 @@ export namespace MigrateApiNamespaceProgrammer {
 
   export const write =
     (config: IMigrateProgram.IConfig) =>
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.ModuleDeclaration => {
       const types = writeTypes(components)(importer)(props.route);
@@ -65,7 +65,7 @@ export namespace MigrateApiNamespaceProgrammer {
     );
 
   const writeTypes =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.TypeAliasDeclaration[] => {
       const array: ts.TypeAliasDeclaration[] = [];
@@ -110,7 +110,7 @@ export namespace MigrateApiNamespaceProgrammer {
     };
 
   const writeMetadata =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.VariableStatement =>
       constant("METADATA")(
@@ -178,7 +178,7 @@ export namespace MigrateApiNamespaceProgrammer {
       );
 
   const writePath =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.VariableStatement => {
       const out = (body: ts.ConciseBody) =>

package/src/programmers/MigrateApiProgrammer.ts

@@ -58,14 +58,16 @@ export namespace MigrateApiProgrammer {
       file: "index.ts",
       content: FilePrinter.write({
         statements: MigrateApiFileProgrammer.write(program)(
-          program.swagger.components,
+          program.document.components,
         )(props),
       }),
     }));
     if (program.mode === "sdk")
       output.push(
         ...[
-          ...MigrateDtoProgrammer.compose(program.swagger.components).entries(),
+          ...MigrateDtoProgrammer.compose(
+            program.document.components,
+          ).entries(),
         ].map(([key, value]) => ({
           location: "src/structures",
           file: `${key}.ts`,