@nestia/migrate 0.7.0 → 0.7.2

package/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "@nestia/migrate",
-  "version": "0.7.0",
-  "description": "Migration program from swagger to NestJS",
-  "main": "lib/index.js",
-  "typings": "lib/index.d.ts",
-  "bin": {
-    "@nestia/migrate": "lib/executable/migrate.js"
-  },
-  "scripts": {
-    "build": "rimraf lib && tsc",
-    "bundle": "ts-node src/executable/bundle.ts",
-    "dev": "npm run build -- --watch",
-    "prepare": "ts-patch install && typia patch && npm run bundle",
-    "test": "node lib/test"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/samchon/nestia"
-  },
-  "keywords": [
-    "migration",
-    "swagger",
-    "NestJS",
-    "nestia"
-  ],
-  "author": "Jeongho Nam",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/samchon/nestia/issues"
-  },
-  "homepage": "https://github.com/samchon/nestia#readme",
-  "devDependencies": {
-    "@nestia/core": "2.5.0",
-    "@nestia/fetcher": "2.5.0",
-    "@nestjs/common": "^10.3.1",
-    "@nestjs/core": "^10.3.1",
-    "@nestjs/platform-express": "^10.3.1",
-    "@nestjs/platform-fastify": "^10.3.1",
-    "@types/express": "^4.17.21",
-    "@types/inquirer": "^9.0.7",
-    "@types/node": "^20.3.3",
-    "dotenv": "^16.3.1",
-    "dotenv-expand": "^10.0.0",
-    "rimraf": "^5.0.1",
-    "serialize-error": "^4.1.0",
-    "source-map-support": "^0.5.21",
-    "ts-node": "^10.9.1",
-    "ts-patch": "^3.1.0",
-    "tstl": "^2.5.13",
-    "typescript-transform-paths": "^3.4.6"
-  },
-  "dependencies": {
-    "commander": "10.0.0",
-    "inquirer": "8.2.5",
-    "typescript": "^5.3.3",
-    "typia": "^5.4.1"
-  },
-  "files": [
-    "lib",
-    "src",
-    "!lib/test",
-    "!src/test",
-    "package.json",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "@nestia/migrate",
+  "version": "0.7.2",
+  "description": "Migration program from swagger to NestJS",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "bin": {
+    "@nestia/migrate": "lib/executable/migrate.js"
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc",
+    "bundle": "ts-node src/executable/bundle.ts",
+    "dev": "npm run build -- --watch",
+    "prepare": "ts-patch install && typia patch && npm run bundle",
+    "test": "node lib/test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/nestia"
+  },
+  "keywords": [
+    "migration",
+    "swagger",
+    "NestJS",
+    "nestia"
+  ],
+  "author": "Jeongho Nam",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/nestia/issues"
+  },
+  "homepage": "https://github.com/samchon/nestia#readme",
+  "devDependencies": {
+    "@nestia/core": "2.5.2",
+    "@nestia/fetcher": "2.5.2",
+    "@nestjs/common": "^10.3.1",
+    "@nestjs/core": "^10.3.1",
+    "@nestjs/platform-express": "^10.3.1",
+    "@nestjs/platform-fastify": "^10.3.1",
+    "@types/express": "^4.17.21",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.3.3",
+    "dotenv": "^16.3.1",
+    "dotenv-expand": "^10.0.0",
+    "rimraf": "^5.0.1",
+    "serialize-error": "^4.1.0",
+    "source-map-support": "^0.5.21",
+    "ts-node": "^10.9.1",
+    "ts-patch": "^3.1.0",
+    "tstl": "^2.5.13",
+    "typescript-transform-paths": "^3.4.6"
+  },
+  "dependencies": {
+    "commander": "10.0.0",
+    "inquirer": "8.2.5",
+    "typescript": "^5.3.3",
+    "typia": "^5.4.4"
+  },
+  "files": [
+    "lib",
+    "src",
+    "!lib/test",
+    "!src/test",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/analyzers/MethodAnalyzer.ts

@@ -12,24 +12,28 @@ export namespace MethodAnalzyer {
     (swagger: ISwagger) =>
     (props: { path: string; method: string }) =>
     (route: ISwaggerRoute): IMigrateRoute | null => {
-      const body = emplaceBodySchema(emplaceReference(swagger)("body"))(
-        route.requestBody,
-      );
-      const success = emplaceBodySchema(emplaceReference(swagger)("response"))(
-        route.responses?.["201"] ?? route.responses?.["200"],
-      );
-      if (body === false || success === false) {
-        console.log(
-          `Failed to migrate ${props.method.toUpperCase()} ${
-            props.path
-          }: @nestia/migrate supports only application/json, application/x-www-form-urlencoded or text/plain format yet.`,
+      const body = emplaceBodySchema("request")(
+        emplaceReference(swagger)("body"),
+      )(route.requestBody);
+      const success = emplaceBodySchema("response")(
+        emplaceReference(swagger)("response"),
+      )(route.responses?.["201"] ?? route.responses?.["200"]);
+
+      const failures: string[] = [];
+      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.`,
         );
-        return null;
-      } else if (SUPPORTED_METHODS.has(props.method.toUpperCase()) === false) {
+      if (success === false)
+        failures.push(
+          `supports only "application/json", "application/x-www-form-urlencoded" and "text/plain" content type in the response body.`,
+        );
+      if (SUPPORTED_METHODS.has(props.method.toUpperCase()) === false)
+        failures.push(`does not support ${props.method.toUpperCase()} method.`);
+      if (failures.length) {
         console.log(
-          `Failed to migrate ${props.method.toUpperCase()} ${
-            props.path
-          }: @nestia/migrate does not support ${props.method.toUpperCase()} method.`,
+          `Failed to migrate ${props.method.toUpperCase()} ${props.path}`,
+          ...failures.map((f) => `  - ${f}`),
         );
         return null;
       }
@@ -189,8 +193,8 @@ export namespace MethodAnalzyer {
               schema: query,
             }
           : null,
-        body,
-        success,
+        body: body as IMigrateRoute.IBody,
+        success: success as IMigrateRoute.IBody,
         exceptions: Object.fromEntries(
           Object.entries(route.responses ?? {})
             .filter(
@@ -264,6 +268,7 @@ export namespace MethodAnalzyer {
     (SwaggerTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
 
   const emplaceBodySchema =
+    (from: "request" | "response") =>
     (emplacer: (schema: ISwaggerSchema) => ISwaggerSchema.IReference) =>
     (meta?: {
       description?: string;
@@ -305,6 +310,20 @@ export namespace MethodAnalzyer {
       const text = entries.find((e) => e[0].includes("text/plain"));
       if (text)
         return { type: "text/plain", key: "body", schema: { type: "string" } };
+
+      if (from === "request") {
+        const multipart = entries.find((e) =>
+          e[0].includes("multipart/form-data"),
+        );
+        if (multipart) {
+          const { schema } = multipart[1];
+          return {
+            type: "multipart/form-data",
+            key: "body",
+            schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          };
+        }
+      }
       return false;
     };
 

package/src/bundles/NEST_TEMPLATE.ts

@@ -52,7 +52,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.0\",\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.1\",\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.0\",\r\n    \"@nestia/fetcher\": \"^2.5.0\",\r\n    \"@nestjs/common\": \"^10.3.0\",\r\n    \"@nestjs/core\": \"^10.3.0\",\r\n    \"@nestjs/platform-fastify\": \"^10.3.0\",\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.1\",\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.1\",\r\n    \"@nestia/sdk\": \"^2.5.2\",\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.1\",\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.2\",\r\n    \"@nestia/fetcher\": \"^2.5.2\",\r\n    \"@nestjs/common\": \"^10.3.0\",\r\n    \"@nestjs/core\": \"^10.3.0\",\r\n    \"@nestjs/platform-fastify\": \"^10.3.0\",\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.4\",\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",
@@ -67,12 +67,12 @@ 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.0\",\r\n    \"typia\": \"^5.4.1\"\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.2\",\r\n    \"typia\": \"^5.4.4\"\r\n  }\r\n}"
   },
   {
     "location": "packages/api",
     "file": "README.md",
-    "content": "# SDK Library\r\nThis is a SDK library generated by [`nestia`](https://nestia.io).\r\n\r\nWith this SDK library, you can easily and safely interact with backend server.\r\n\r\nJust import and call some API functions like gif image below:\r\n\r\n![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)\r\n\r\n> Left is server code, and right is client code utilizing the SDK\r\n\r\n\r\n\r\n\r\n# What [`Nestia`](https://nestia.io) is:\r\n![Nestia Logo](https://nestia.io/logo.png)\r\n\r\n[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)\r\n[![npm version](https://img.shields.io/npm/v/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\r\n[![Downloads](https://img.shields.io/npm/dm/nestia.svg)](https://www.npmjs.com/package/nestia)\r\n[![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)\r\n[![Guide Documents](https://img.shields.io/badge/guide-documents-forestgreen)](https://nestia.io/docs/)\r\n\r\n[Nestia](https://nestia.io) is a set of helper libraries for NestJS, supporting below features:\r\n\r\n  - `@nestia/core`: super-fast decorators\r\n  - `@nestia/sdk`\r\n    - SDK generator for clients\r\n    - Swagger generator evolved than ever\r\n    - Automatic E2E test functions generator\r\n  - `nestia`: just CLI (command line interface) tool\r\n\r\n> **Note**\r\n> \r\n> - **Only one line** required, with pure TypeScript type\r\n> - Runtime validator is **20,000x faster** than `class-validator`\r\n> - JSON serialization is **200x faster** than `class-transformer`\r\n> - SDK is similar with [tRPC](https://trpc.io), but much advanced"
+    "content": "# SDK Library\r\nThis is a SDK library generated by [`nestia`](https://nestia.io).\r\n\r\nWith this SDK library, you can easily and safely interact with backend server.\r\n\r\nJust import and call some API functions like gif image below:\r\n\r\n![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)\r\n\r\n> Left is server code, and right is client code utilizing the SDK\r\n\r\n\r\n\r\n\r\n# What [`Nestia`](https://nestia.io) is:\r\n![Nestia Logo](https://nestia.io/logo.png)\r\n\r\n[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)\r\n[![npm version](https://img.shields.io/npm/v/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\r\n[![Downloads](https://img.shields.io/npm/dm/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\r\n[![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)\r\n[![Guide Documents](https://img.shields.io/badge/guide-documents-forestgreen)](https://nestia.io/docs/)\r\n\r\nNestia is a set of helper libraries for NestJS, supporting below features:\r\n\r\n  - `@nestia/core`: super-fast decorators\r\n  - `@nestia/sdk`:\r\n    - Swagger generator evolved than ever\r\n    - SDK library generator for clients\r\n    - Mockup Simulator for client applications\r\n    - Automatic E2E test functions generator\r\n  - `@nestia/migrate`: migration from Swagger to NestJS\r\n  - `nestia`: just CLI (command line interface) tool\r\n\r\n> **Note**\r\n> \r\n> - **Only one line** required, with pure TypeScript type\r\n> - Enhance performance **30x** up\r\n>   - Runtime validator is **20,000x faster** than `class-validator`\r\n>   - JSON serialization is **200x faster** than `class-transformer`\r\n> - Software Development Kit\r\n>   - SDK is a collection of `fetch` functions with type definitions like [tRPC](https://trpc.io/)\r\n>   - Mockup simulator means embedded backend simulator in SDK\r\n>     - similar with [msw](https://mswjs.io/), but fully automated"
   },
   {
     "location": "packages/api",

package/src/bundles/SDK_TEMPLATE.ts

@@ -12,7 +12,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    \"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.0\",\r\n    \"typia\": \"^5.4.1\"\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    \"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.2\",\r\n    \"typia\": \"^5.4.4\"\r\n  }\r\n}"
   },
   {
     "location": "",

package/src/programmers/ApiFunctionProgrammer.ts

@@ -50,7 +50,7 @@ export namespace ApiFunctionProgrammer {
         ts.factory.createTypeReferenceNode(
           importer.external({
             type: "instance",
-            library: "@nestia/Fetcher",
+            library: "@nestia/fetcher",
             name: "IConnection",
           }),
           props.route.headers
@@ -99,8 +99,7 @@ export namespace ApiFunctionProgrammer {
     (importer: ImportProgrammer) =>
     (props: IProps): ts.Statement[] => {
       const encrypted: boolean = !!props.route.success?.["x-nestia-encrypted"];
-      const contentType: string =
-        props.route.success?.type ?? "application/json";
+      const contentType: string = props.route.body?.type ?? "application/json";
 
       const caller = () =>
         ts.factory.createCallExpression(
@@ -115,7 +114,7 @@ export namespace ApiFunctionProgrammer {
           )("fetch"),
           undefined,
           [
-            contentType
+            contentType && contentType !== "multipart/form-data"
               ? ts.factory.createObjectLiteralExpression(
                   [
                     ts.factory.createSpreadAssignment(

package/src/programmers/ApiNamespaceProgrammer.ts

@@ -119,7 +119,7 @@ export namespace ApiNamespaceProgrammer {
                 "request",
                 props.route.body
                   ? LiteralFactory.generate({
-                      type: "application/json",
+                      type: props.route.body.type,
                       encrypted: !!props.route.body["x-nestia-encrypted"],
                     })
                   : ts.factory.createNull(),

package/src/programmers/ApiSimulatationProgrammer.ts

@@ -265,7 +265,7 @@ export namespace ApiSimulatationProgrammer {
                       ts.factory.createTypeReferenceNode(
                         importer.external({
                           type: "instance",
-                          library: "@nestia/Fetcher",
+                          library: "@nestia/fetcher",
                           name: "HttpError",
                         }),
                       ),

package/src/programmers/NestMethodProgrammer.ts

@@ -190,9 +190,17 @@ export namespace NestMethodProgrammer {
       ...(route.body
         ? [
             writeDtoParameter({
-              method: route.body?.["x-nestia-encrypted"]
+              method: route.body["x-nestia-encrypted"]
                 ? "EncryptedBody"
-                : "TypedBody",
+                : route.body.type === "application/json"
+                  ? "TypedBody"
+                  : route.body.type === "application/x-www-form-urlencoded"
+                    ? ["TypedQuery", "Body"]
+                    : route.body.type === "text/plain"
+                      ? "PlainBody"
+                      : route.body.type === "multipart/form-data"
+                        ? ["TypedMultipart", "Body"]
+                        : "TypedBody",
               variable: "body",
             })(components)(importer)(route.body.schema),
           ]
@@ -200,21 +208,27 @@ export namespace NestMethodProgrammer {
     ];
 
   const writeDtoParameter =
-    (accessor: { method: string; variable: string }) =>
+    (accessor: { method: string | [string, string]; variable: string }) =>
     (components: ISwaggerComponents) =>
     (importer: ImportProgrammer) =>
-    (schema: ISwaggerSchema): ts.ParameterDeclaration =>
-      ts.factory.createParameterDeclaration(
+    (schema: ISwaggerSchema): ts.ParameterDeclaration => {
+      const instance = ts.factory.createIdentifier(
+        importer.external({
+          type: "instance",
+          library: "@nestia/core",
+          name:
+            typeof accessor.method === "string"
+              ? accessor.method
+              : accessor.method[0],
+        }),
+      );
+      return ts.factory.createParameterDeclaration(
         [
           ts.factory.createDecorator(
             ts.factory.createCallExpression(
-              ts.factory.createIdentifier(
-                importer.external({
-                  type: "instance",
-                  library: "@nestia/core",
-                  name: accessor.method,
-                }),
-              ),
+              typeof accessor.method === "string"
+                ? instance
+                : IdentifierFactory.access(instance)(accessor.method[1]),
               undefined,
               undefined,
             ),
@@ -225,4 +239,5 @@ export namespace NestMethodProgrammer {
         undefined,
         SchemaProgrammer.write(components)(importer)(schema),
       );
+    };
 }

package/src/programmers/SchemaProgrammer.ts

@@ -117,6 +117,9 @@ export namespace SchemaProgrammer {
   const writeString =
     (importer: ImportProgrammer) =>
     (schema: ISwaggerSchema.IString): ts.TypeNode => {
+      if (schema.format === "binary")
+        return ts.factory.createTypeReferenceNode("File");
+
       const intersection: ts.TypeNode[] = [TypeFactory.keyword("string")];
       if (schema.default !== undefined)
         intersection.push(importer.tag("Default", schema.default));

package/src/structures/IMigrateRoute.ts

@@ -33,7 +33,8 @@ export namespace IMigrateRoute {
     type:
       | "text/plain"
       | "application/json"
-      | "application/x-www-form-urlencoded";
+      | "application/x-www-form-urlencoded"
+      | "multipart/form-data";
     schema: ISwaggerSchema;
     "x-nestia-encrypted"?: boolean;
   }

package/src/structures/ISwaggerRoute.ts

@@ -45,6 +45,9 @@ export namespace ISwaggerRoute {
     "application/x-www-form-urlencoded"?: {
       schema: ISwaggerSchema;
     };
+    "multipart/form-data"?: {
+      schema: ISwaggerSchema;
+    };
     "*/*"?: {
       schema: ISwaggerSchema;
     };

package/lib/bundles/TEMPLATE.d.ts

@@ -1,5 +0,0 @@
-export declare const NESTJS_TEMPLATE: {
-    location: string;
-    file: string;
-    content: string;
-}[];