Merge pull request #962 from samchon/features/propagate

Add `MigrateFetcher.propagate()` function.

package.json

@@ -1,7 +1,7 @@
 {
  "private": true,
  "name": "@nestia/station",
- "version": "3.7.0",
+ "version": "3.7.1",
  "description": "Nestia station",
  "scripts": {
  "build": "node build/index.js",

packages/core/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@nestia/core",
- "version": "3.7.0",
+ "version": "3.7.1",
  "description": "Super-fast validation decorators of NestJS",
  "main": "lib/index.js",
  "typings": "lib/index.d.ts",
@@ -36,7 +36,7 @@
  },
  "homepage": "https://nestia.io",
  "dependencies": {
- "@nestia/fetcher": "../fetcher/nestia-fetcher-3.7.0.tgz",
+ "@nestia/fetcher": "^3.7.1",
  "@nestjs/common": ">=7.0.1",
  "@nestjs/core": ">=7.0.1",
  "@samchon/openapi": "^0.4.1",
@@ -53,7 +53,7 @@
  "ws": "^7.5.3"
  },
  "peerDependencies": {
- "@nestia/fetcher": ">=3.7.0",
+ "@nestia/fetcher": ">=3.7.1",
  "@nestjs/common": ">=7.0.1",
  "@nestjs/core": ">=7.0.1",
  "reflect-metadata": ">=0.1.12",

packages/fetcher/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@nestia/fetcher",
- "version": "3.7.0",
+ "version": "3.7.1",
  "description": "Fetcher library of Nestia SDK",
  "main": "lib/index.js",
  "typings": "lib/index.d.ts",

packages/fetcher/src/MigrateFetcher.ts

@@ -1,6 +1,7 @@
 import { IMigrateRoute } from "@samchon/openapi";
 
 import { IConnection } from "./IConnection";
+import { IPropagation } from "./IPropagation";
 import { PlainFetcher } from "./PlainFetcher";
 
 export namespace MigrateFetcher {
@@ -48,6 +49,46 @@ export namespace MigrateFetcher {
  );
  }
 
+ export async function propagate(
+ props: IProps,
+ ): Promise<IPropagation.IBranch<boolean, number, any>> {
+ const length: number =
+ props.route.parameters.length +
+ (props.route.query ? 1 : 0) +
+ (props.route.body ? 1 : 0);
+ if (props.arguments.length !== length)
+ throw new Error(
+ `Error on MigrateFetcher.propagate(): arguments length is not matched with the route (expected: ${length}, actual: ${props.arguments.length}).`,
+ );
+ else if (
+ props.route.body?.["x-nestia-encrypted"] === true ||
+ props.route.success?.["x-nestia-encrypted"] === true
+ )
+ throw new Error(
+ `Error on MigrateFetcher.propagate(): encrypted API is not supported yet.`,
+ );
+ return PlainFetcher.propagate(
+ props.connection,
+ {
+ method: props.route.method.toUpperCase() as "POST",
+ path: getPath(props),
+ template: props.route.path,
+ status: null,
+ request: props.route.body
+ ? {
+ encrypted: false,
+ type: props.route.body.type,
+ }
+ : null,
+ response: {
+ encrypted: false,
+ type: props.route.success?.type ?? "application/json",
+ },
+ },
+ props.route.body ? props.arguments.at(-1) : undefined,
+ ) as Promise<IPropagation.IBranch<boolean, number, any>>;
+ }
+
  function getPath(props: Pick<IProps, "arguments" | "route">): string {
  let path: string = props.route.emendedPath;
  props.route.parameters.forEach((p, i) => {

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@nestia/sdk",
- "version": "3.7.0",
+ "version": "3.7.1",
  "description": "Nestia SDK and Swagger generator",
  "main": "lib/index.js",
  "typings": "lib/index.d.ts",
@@ -32,8 +32,8 @@
  },
  "homepage": "https://nestia.io",
  "dependencies": {
- "@nestia/fetcher": "../fetcher/nestia-fetcher-3.7.0.tgz",
- "@nestia/core": "../core/nestia-core-3.7.0.tgz",
+ "@nestia/fetcher": "^3.7.1",
+ "@nestia/core": "^3.7.1",
  "@samchon/openapi": "^0.4.1",
  "cli": "^1.0.1",
  "get-function-location": "^2.0.0",
@@ -47,8 +47,8 @@
  "typia": "^6.5.0"
  },
  "peerDependencies": {
- "@nestia/fetcher": ">=3.7.0",
- "@nestia/core": ">=3.7.0",
+ "@nestia/fetcher": ">=3.7.1",
+ "@nestia/core": ">=3.7.1",
  "@nestjs/common": ">=7.0.1",
  "@nestjs/core": ">=7.0.1",
  "reflect-metadata": ">=0.1.12",

test/features/migrate/migrate.json

@@ -9,8 +9,8 @@
  "articles",
  "post"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": null,
  "body": {
  "type": "application/json",
@@ -39,14 +39,14 @@
  "articles",
  "patch"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": {
- "name": "query",
- "key": "query",
  "schema": {
  "$ref": "#/components/schemas/IApiBbsArticles.PatchQuery"
- }
+ },
+ "name": "query",
+ "key": "query"
  },
  "body": null,
  "success": {
@@ -68,18 +68,17 @@
  "articles",
  "getById"
  ],
- "headers": null,
  "parameters": [
  {
  "name": "id",
  "key": "id",
  "schema": {
  "type": "string",
- "format": "uuid",
- "description": ""
+ "format": "uuid"
  }
  }
  ],
+ "headers": null,
  "query": null,
  "body": null,
  "success": {
@@ -101,18 +100,17 @@
  "articles",
  "putById"
  ],
- "headers": null,
  "parameters": [
  {
  "name": "id",
  "key": "id",
  "schema": {
  "type": "string",
- "format": "uuid",
- "description": ""
+ "format": "uuid"
  }
  }
  ],
+ "headers": null,
  "query": null,
  "body": {
  "type": "application/json",
@@ -133,8 +131,8 @@
  "multipart",
  "post"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": null,
  "body": {
  "type": "multipart/form-data",
@@ -163,14 +161,14 @@
  "typed",
  "get"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": {
- "name": "query",
- "key": "query",
  "schema": {
  "$ref": "#/components/schemas/IApiQueryTyped.GetQuery"
- }
+ },
+ "name": "query",
+ "key": "query"
  },
  "body": null,
  "success": {
@@ -192,14 +190,14 @@
  "nest",
  "get"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": {
- "name": "query",
- "key": "query",
  "schema": {
  "$ref": "#/components/schemas/IApiQueryNest.GetQuery"
- }
+ },
+ "name": "query",
+ "key": "query"
  },
  "body": null,
  "success": {
@@ -221,14 +219,14 @@
  "individual",
  "get"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": {
- "name": "query",
- "key": "query",
  "schema": {
  "$ref": "#/components/schemas/IApiQueryIndividual.GetQuery"
- }
+ },
+ "name": "query",
+ "key": "query"
  },
  "body": null,
  "success": {
@@ -250,14 +248,14 @@
  "composite",
  "get"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": {
- "name": "query",
- "key": "query",
  "schema": {
  "$ref": "#/components/schemas/IApiQueryComposite.GetQuery"
- }
+ },
+ "name": "query",
+ "key": "query"
  },
  "body": null,
  "success": {
@@ -279,8 +277,8 @@
  "body",
  "post"
  ],
- "headers": null,
  "parameters": [],
+ "headers": null,
  "query": null,
  "body": {
  "type": "application/x-www-form-urlencoded",

test/features/migrate/src/test/features/api/test_api_bbs_article_at.ts

@@ -1,3 +1,4 @@
+import { IPropagation } from "@nestia/fetcher";
 import { MigrateFetcher } from "@nestia/fetcher/lib/MigrateFetcher";
 import typia from "typia";
 import { v4 } from "uuid";
@@ -15,4 +16,12 @@ export const test_api_bbs_article_at = async (
  arguments: [v4()],
  });
  typia.assert(article);
+
+ const propa: IPropagation.IBranch<boolean, number, any> =
+ await MigrateFetcher.propagate({
+ route: props.route("get", "/bbs/articles/{id}"),
+ connection: props.connection,
+ arguments: [v4()],
+ });
+ typia.assert(propa);
 };

test/features/propagate/src/test/features/api/automated/test_api_members_login.ts

@@ -7,12 +7,15 @@ import type { IMember } from "../../../../api/structures/IMember";
 import type { INotFound } from "../../../../api/structures/INotFound";
 
 export const test_api_members_login = async (connection: api.IConnection) => {
- const output: IPropagation<{
- 201: IMember;
- 403: IForbidden;
- 404: INotFound;
- 422: IForbidden.IExpired;
- }> = await api.functional.members.login(
+ const output: IPropagation<
+ {
+ 201: IMember;
+ 403: IForbidden;
+ 404: INotFound;
+ 422: IForbidden.IExpired;
+ },
+ 201
+ > = await api.functional.members.login(
  connection,
  typia.random<IMember.ILogin>(),
  );

test/package.json

@@ -1,7 +1,7 @@
 {
  "private": true,
  "name": "@samchon/nestia-test",
- "version": "3.7.0",
+ "version": "3.7.1",
  "description": "Test program of Nestia",
  "main": "index.js",
  "scripts": {
@@ -26,7 +26,7 @@
  },
  "homepage": "https://nestia.io",
  "devDependencies": {
- "@nestia/sdk": "../packages/sdk/nestia-sdk-3.7.0.tgz",
+ "@nestia/sdk": "^3.7.1",
  "@nestjs/swagger": "^7.1.2",
  "@samchon/openapi": "^0.4.1",
  "@types/express": "^4.17.17",
@@ -40,9 +40,9 @@
  },
  "dependencies": {
  "@fastify/multipart": "^8.1.0",
- "@nestia/core": "../packages/core/nestia-core-3.7.0.tgz",
+ "@nestia/core": "^3.7.1",
  "@nestia/e2e": "^0.7.0",
- "@nestia/fetcher": "../packages/fetcher/nestia-fetcher-3.7.0.tgz",
+ "@nestia/fetcher": "^3.7.1",
  "@nestjs/common": "^10.3.5",
  "@nestjs/core": "^10.3.5",
  "@nestjs/platform-express": "^10.3.5",