Merge pull request #1371 from samchon/feat/e2e

Enhance `@nestia/e2e` types

Author: samchon

package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "@nestia/station",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "description": "Nestia station",
   "scripts": {
     "build": "node deploy build",

packages/benchmark/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/benchmark",
-  "version": "7.1.1-dev.20250714",
+  "version": "8.0.1-dev.20250831",
   "description": "NestJS Performance Benchmark Program",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "7.1.1-dev.20250714",
+  "version": "8.0.1-dev.20250831",
   "description": "Nestia CLI tool",
   "main": "bin/index.js",
   "bin": {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/core",
-  "version": "7.1.1-dev.20250714",
+  "version": "8.0.1-dev.20250831",
   "description": "Super-fast validation decorators of NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -52,7 +52,7 @@
     "ws": "^7.5.3"
   },
   "peerDependencies": {
-    "@nestia/fetcher": ">=7.1.1-dev.20250714",
+    "@nestia/fetcher": ">=8.0.1-dev.20250831",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "@samchon/openapi": ">=4.5.0 <5.0.0",

packages/e2e/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/e2e",
-  "version": "7.1.1-dev.20250714",
+  "version": "8.0.1-dev.20250831",
   "description": "E2E test utilify functions",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

packages/e2e/src/RandomGenerator.ts

@@ -130,7 +130,8 @@ export namespace RandomGenerator {
    *   ```
    *
    * @param length - Number of words in the name (default: random between 2-3)
-   * @returns A space-separated string of random words (each 3-7 chars by default)
+   * @returns A space-separated string of random words (each 3-7 chars by
+   *   default)
    */
   export const name = (length: number = randint(2, 3)): string =>
     paragraph({
@@ -322,7 +323,7 @@ export namespace RandomGenerator {
    * @example
    *   ```typescript
    *   RandomGenerator.mobile();        // e.g. "0103341234" or "01012345678"
-   *   RandomGenerator.mobile("011");   // e.g. "0119876543" or "01112345678" 
+   *   RandomGenerator.mobile("011");   // e.g. "0119876543" or "01112345678"
    *   RandomGenerator.mobile("+82");   // e.g. "+823341234" or "+8212345678"
    *
    *   // Generate test user phone numbers
@@ -480,7 +481,8 @@ export namespace RandomGenerator {
    * @param array - The source array to pick an element from
    * @returns A randomly selected element from the array
    */
-  export const pick = <T>(array: T[]): T => array[randint(0, array.length - 1)];
+  export const pick = <T>(array: readonly T[]): T =>
+    array[randint(0, array.length - 1)];
 }
 
 /** @internal */

packages/e2e/src/TestValidator.ts

@@ -118,25 +118,25 @@ export namespace TestValidator {
    *   ```;
    *
    * @param title - Descriptive title used in error messages when values differ
-   * @param x - The first value to compare
+   * @param X - The first value to compare
    * @param y - The second value to compare (can be null or undefined)
    * @param exception - Optional filter function to exclude specific keys from
    *   comparison
    * @throws Error with detailed diff information when values are not equal
    */
-  export function equals<T>(
+  export function equals<X, Y extends X>(
     title: string,
-    x: T,
-    y: T | null | undefined,
+    X: X,
+    y: Y | null | undefined,
     exception?: (key: string) => boolean,
   ): void {
-    const diff: string[] = json_equal_to(exception ?? (() => false))(x)(y);
+    const diff: string[] = json_equal_to(exception ?? (() => false))(X)(y);
     if (diff.length)
       throw new Error(
         [
           `Bug on ${title}: found different values - [${diff.join(", ")}]:`,
           "\n",
-          JSON.stringify({ x, y }, null, 2),
+          JSON.stringify({ x: X, y }, null, 2),
         ].join("\n"),
       );
   }
@@ -175,10 +175,10 @@ export namespace TestValidator {
    *   comparison
    * @throws Error when values are equal (indicating validation failure)
    */
-  export function notEquals<T>(
+  export function notEquals<X, Y extends X>(
     title: string,
-    x: T,
-    y: T | null | undefined,
+    x: X,
+    y: Y | null | undefined,
     exception?: (key: string) => boolean,
   ): void {
     const diff: string[] = json_equal_to(exception ?? (() => false))(x)(y);
@@ -349,10 +349,10 @@ export namespace TestValidator {
    * @param trace - Optional flag to enable debug logging (default: false)
    * @throws Error when entity order differs between expected and actual results
    */
-  export const index = <Summary extends IEntity<any>>(
+  export const index = <X extends IEntity<any>, Y extends X>(
     title: string,
-    expected: Summary[],
-    gotten: Summary[],
+    expected: X[],
+    gotten: Y[],
     trace: boolean = false,
   ): void => {
     const length: number = Math.min(expected.length, gotten.length);

packages/e2e/test/features/test_validate_xy.ts

@@ -0,0 +1,16 @@
+import { TestValidator } from "@nestia/e2e";
+
+export const test_validate_xy = (): void => {
+  interface IExplicit {
+    id: string;
+    name: string;
+  }
+  TestValidator.equals("xy", { id: "1" }, {
+    id: "1",
+    name: "John Doe",
+  } satisfies IExplicit as IExplicit);
+  TestValidator.notEquals("xy", { id: "1" }, {
+    id: "2",
+    name: "Kevin",
+  } satisfies IExplicit as IExplicit);
+};

packages/fetcher/package.json

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

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/sdk",
-  "version": "7.1.1-dev.20250714",
+  "version": "8.0.1-dev.20250831",
   "description": "Nestia SDK and Swagger generator",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -47,7 +47,7 @@
     "typia": "^9.6.1"
   },
   "peerDependencies": {
-    "@nestia/core": ">=7.1.1-dev.20250714"
+    "@nestia/core": ">=8.0.1-dev.20250831"
   },
   "devDependencies": {
     "@nestjs/common": "^11.0.13",