@nestia/e2e 7.3.3 → 8.0.0-dev.20250829

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2023 Jeongho Nam
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2023 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,93 +1,93 @@
-# Nestia
-![Nestia Logo](https://nestia.io/logo.png)
-
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)
-[![npm version](https://img.shields.io/npm/v/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
-[![Downloads](https://img.shields.io/npm/dm/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
-[![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://nestia.io/docs/)
-[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/nestia)
-[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
-
-Nestia is a set of helper libraries for NestJS, supporting below features:
-
-  - `@nestia/core`:
-    - Super-fast/easy decorators
-    - Advanced WebSocket routes
-  - `@nestia/sdk`:
-    - Swagger generator, more evolved than ever
-    - SDK library generator for clients
-    - Mockup Simulator for client applications
-    - Automatic E2E test functions generator
-  - `@nestia/e2e`: Test program utilizing e2e test functions
-  - `@nestia/benchmark`: Benchmark program using e2e test functions
-  - `@nestia/editor`: Swagger-UI with Online TypeScript Editor
-  - [`@agentica`](https://github.com/wrtnlabs/agentica): Agentic AI library specialized in LLM function calling
-  - [`@autobe`](https://github.com/wrtnlabs/autobe): Vibe coding agent generating NestJS application
-  - `nestia`: Just CLI (command line interface) tool
-
-> [!NOTE]
-> 
-> - **Only one line** required, with pure TypeScript type
-> - Enhance performance **30x** up
->   - Runtime validator is **20,000x faster** than `class-validator`
->   - JSON serialization is **200x faster** than `class-transformer`
-> - Software Development Kit
->   - Collection of typed `fetch` functions with DTO structures like [tRPC](https://trpc.io/)
->   - Mockup simulator means embedded backend simulator in the SDK
->     - similar with [msw](https://mswjs.io/), but fully automated
-
-![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)
-
-> Left is NestJS server code, and right is client (frontend) code utilizing SDK
-
-
-
-
-## Sponsors and Backers
-Thanks for your support.
-
-Your donation would encourage `nestia` development.
-
-[![Backers](https://opencollective.com/nestia/backers.svg?avatarHeight=75&width=600)](https://opencollective.com/nestia)
-
-
-
-
-## Guide Documents
-Check out the document in the [website](https://nestia.io/docs/):
-
-### 🏠 Home
-  - [Introduction](https://nestia.io/docs/)
-  - [Setup](https://nestia.io/docs/setup/)
-  - [Pure TypeScript](https://nestia.io/docs/pure)
-
-### 📖 Features
-  - Core Library
-    - [`@WebSocketRoute`](https://nestia.io/docs/core/WebSocketRoute)
-    - [`@TypedRoute`](https://nestia.io/docs/core/TypedRoute/)
-    - [**`@TypedBody`**](https://nestia.io/docs/core/TypedBody/)
-    - [`@TypedParam`](https://nestia.io/docs/core/TypedParam/)
-    - [`@TypedQuery`](https://nestia.io/docs/core/TypedQuery/)
-    - [`@TypedFormData`](https://nestia.io/docs/core/TypedFormData/)
-    - [`@TypedHeaders`](https://nestia.io/docs/core/TypedHeaders/)
-    - [`@TypedException`](https://nestia.io/docs/core/TypedException/)
-  - Software Development Kit
-    - [SDK Builder](https://nestia.io/docs/sdk/)
-    - [Mockup Simulator](https://nestia.io/docs/sdk/simulate/)
-    - [E2E Test Functions](https://nestia.io/docs/sdk/e2e/)
-    - [Distribution](https://nestia.io/docs/sdk/distribute/)
-  - Swagger Document
-    - [Swagger Builder](https://nestia.io/docs/swagger/)
-    - [**AI Chatbot Development**](https://nestia.io/docs/swagger/chat/)
-    - [Cloud Swagger Editor](https://nestia.io/docs/swagger/editor/)
-    - [Documentation Strategy](https://nestia.io/docs/swagger/strategy/)
-  - E2E Testing
-    - [Why E2E Test?](https://nestia.io/docs/e2e/why/)
-    - [Test Program Development](https://nestia.io/docs/e2e/development/)
-    - [Performance Benchmark](https://nestia.io/docs/e2e/benchmark/)
-
-### 🔗 Appendix
-  - [API Documents](https://nestia.io/api)
-  - [⇲ Benchmark Result](https://github.com/samchon/nestia/tree/master/benchmark/results/11th%20Gen%20Intel(R)%20Core(TM)%20i5-1135G7%20%40%202.40GHz)
-  - [⇲ `dev.to` Articles](https://dev.to/samchon/series/22751)
+# Nestia
+![Nestia Logo](https://nestia.io/logo.png)
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)
+[![npm version](https://img.shields.io/npm/v/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
+[![Downloads](https://img.shields.io/npm/dm/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
+[![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)
+[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://nestia.io/docs/)
+[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/nestia)
+[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
+
+Nestia is a set of helper libraries for NestJS, supporting below features:
+
+  - `@nestia/core`:
+    - Super-fast/easy decorators
+    - Advanced WebSocket routes
+  - `@nestia/sdk`:
+    - Swagger generator, more evolved than ever
+    - SDK library generator for clients
+    - Mockup Simulator for client applications
+    - Automatic E2E test functions generator
+  - `@nestia/e2e`: Test program utilizing e2e test functions
+  - `@nestia/benchmark`: Benchmark program using e2e test functions
+  - `@nestia/editor`: Swagger-UI with Online TypeScript Editor
+  - [`@agentica`](https://github.com/wrtnlabs/agentica): Agentic AI library specialized in LLM function calling
+  - [`@autobe`](https://github.com/wrtnlabs/autobe): Vibe coding agent generating NestJS application
+  - `nestia`: Just CLI (command line interface) tool
+
+> [!NOTE]
+> 
+> - **Only one line** required, with pure TypeScript type
+> - Enhance performance **30x** up
+>   - Runtime validator is **20,000x faster** than `class-validator`
+>   - JSON serialization is **200x faster** than `class-transformer`
+> - Software Development Kit
+>   - Collection of typed `fetch` functions with DTO structures like [tRPC](https://trpc.io/)
+>   - Mockup simulator means embedded backend simulator in the SDK
+>     - similar with [msw](https://mswjs.io/), but fully automated
+
+![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)
+
+> Left is NestJS server code, and right is client (frontend) code utilizing SDK
+
+
+
+
+## Sponsors and Backers
+Thanks for your support.
+
+Your donation would encourage `nestia` development.
+
+[![Backers](https://opencollective.com/nestia/backers.svg?avatarHeight=75&width=600)](https://opencollective.com/nestia)
+
+
+
+
+## Guide Documents
+Check out the document in the [website](https://nestia.io/docs/):
+
+### 🏠 Home
+  - [Introduction](https://nestia.io/docs/)
+  - [Setup](https://nestia.io/docs/setup/)
+  - [Pure TypeScript](https://nestia.io/docs/pure)
+
+### 📖 Features
+  - Core Library
+    - [`@WebSocketRoute`](https://nestia.io/docs/core/WebSocketRoute)
+    - [`@TypedRoute`](https://nestia.io/docs/core/TypedRoute/)
+    - [**`@TypedBody`**](https://nestia.io/docs/core/TypedBody/)
+    - [`@TypedParam`](https://nestia.io/docs/core/TypedParam/)
+    - [`@TypedQuery`](https://nestia.io/docs/core/TypedQuery/)
+    - [`@TypedFormData`](https://nestia.io/docs/core/TypedFormData/)
+    - [`@TypedHeaders`](https://nestia.io/docs/core/TypedHeaders/)
+    - [`@TypedException`](https://nestia.io/docs/core/TypedException/)
+  - Software Development Kit
+    - [SDK Builder](https://nestia.io/docs/sdk/)
+    - [Mockup Simulator](https://nestia.io/docs/sdk/simulate/)
+    - [E2E Test Functions](https://nestia.io/docs/sdk/e2e/)
+    - [Distribution](https://nestia.io/docs/sdk/distribute/)
+  - Swagger Document
+    - [Swagger Builder](https://nestia.io/docs/swagger/)
+    - [**AI Chatbot Development**](https://nestia.io/docs/swagger/chat/)
+    - [Cloud Swagger Editor](https://nestia.io/docs/swagger/editor/)
+    - [Documentation Strategy](https://nestia.io/docs/swagger/strategy/)
+  - E2E Testing
+    - [Why E2E Test?](https://nestia.io/docs/e2e/why/)
+    - [Test Program Development](https://nestia.io/docs/e2e/development/)
+    - [Performance Benchmark](https://nestia.io/docs/e2e/benchmark/)
+
+### 🔗 Appendix
+  - [API Documents](https://nestia.io/api)
+  - [⇲ Benchmark Result](https://github.com/samchon/nestia/tree/master/benchmark/results/11th%20Gen%20Intel(R)%20Core(TM)%20i5-1135G7%20%40%202.40GHz)
+  - [⇲ `dev.to` Articles](https://dev.to/samchon/series/22751)

package/lib/ArrayUtil.d.ts

@@ -3,15 +3,15 @@
  *
  * This namespace contains utility functions for array operations including
  * asynchronous processing, filtering, mapping, and repetition tasks implemented
- * in functional programming style. All functions are implemented using currying
- * to enhance reusability and composability.
+ * in functional programming style. Functions use direct parameter passing for
+ * simplicity while maintaining functional programming principles.
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @example
  *   ```typescript
  *   // Asynchronous filtering example
  *   const numbers = [1, 2, 3, 4, 5];
- *   const evenNumbers = await ArrayUtil.asyncFilter(numbers)(
+ *   const evenNumbers = await ArrayUtil.asyncFilter(numbers,
  *     async (num) => num % 2 === 0
  *   );
  *   console.log(evenNumbers); // [2, 4]
@@ -22,9 +22,9 @@ export declare namespace ArrayUtil {
      * Filters an array by applying an asynchronous predicate function to each
      * element.
      *
-     * This function is implemented in curried form, first taking an array and
-     * then a predicate function. Elements are processed sequentially, ensuring
-     * order is maintained.
+     * Elements are processed sequentially, ensuring order is maintained. The
+     * predicate function receives the element, index, and the full array as
+     * parameters.
      *
      * @example
      *   ```typescript
@@ -34,7 +34,7 @@ export declare namespace ArrayUtil {
      *     { id: 3, name: 'Charlie', active: true }
      *   ];
      *
-     *   const activeUsers = await ArrayUtil.asyncFilter(users)(
+     *   const activeUsers = await ArrayUtil.asyncFilter(users,
      *     async (user) => {
      *       // Async validation logic (e.g., API call)
      *       await new Promise(resolve => setTimeout(resolve, 100));
@@ -46,10 +46,10 @@ export declare namespace ArrayUtil {
      *
      * @template Input - The type of elements in the input array
      * @param elements - The readonly array to filter
-     * @returns A function that takes a predicate and returns a Promise resolving
-     *   to the filtered array
+     * @param pred - The asynchronous predicate function to test each element
+     * @returns A Promise resolving to the filtered array
      */
-    const asyncFilter: <Input>(elements: readonly Input[]) => (pred: (elem: Input, index: number, array: readonly Input[]) => Promise<boolean>) => Promise<Input[]>;
+    const asyncFilter: <Input>(elements: readonly Input[], pred: (elem: Input, index: number, array: readonly Input[]) => Promise<boolean>) => Promise<Input[]>;
     /**
      * Executes an asynchronous function for each element in an array
      * sequentially.
@@ -63,44 +63,45 @@ export declare namespace ArrayUtil {
      *   ```typescript
      *   const urls = ['url1', 'url2', 'url3'];
      *
-     *   await ArrayUtil.asyncForEach(urls)(async (url, index) => {
-     *   console.log(`Processing ${index}: ${url}`);
-     *   const data = await fetch(url);
-     *   await processData(data);
-     *   console.log(`Completed ${index}: ${url}`);
+     *   await ArrayUtil.asyncForEach(urls, async (url, index) => {
+     *     console.log(`Processing ${index}: ${url}`);
+     *     const data = await fetch(url);
+     *     await processData(data);
+     *     console.log(`Completed ${index}: ${url}`);
      *   });
      *   console.log('All URLs processed sequentially');
      *   ```
      *
      * @template Input - The type of elements in the input array
      * @param elements - The readonly array to process
-     * @returns A function that takes an async closure and returns a Promise<void>
+     * @param closure - The asynchronous function to execute for each element
+     * @returns A Promise<void> that resolves when all operations complete
      */
-    const asyncForEach: <Input>(elements: readonly Input[]) => (closure: (elem: Input, index: number, array: readonly Input[]) => Promise<any>) => Promise<void>;
+    const asyncForEach: <Input>(elements: readonly Input[], closure: (elem: Input, index: number, array: readonly Input[]) => Promise<any>) => Promise<void>;
     /**
      * Transforms each element of an array using an asynchronous function to
      * create a new array.
      *
      * Similar to JavaScript's native map but processes asynchronous functions
      * sequentially. Each element's transformation is completed before proceeding
-     * to the next element, ensuring order is maintained.
+     * to the next element, ensuring order is maintained. This function still
+     * maintains the currying pattern for composition.
      *
      * @example
      *   ```typescript
      *   const userIds = [1, 2, 3, 4, 5];
      *
      *   const userDetails = await ArrayUtil.asyncMap(userIds)(
-     *   async (id, index) => {
-     *   console.log(`Fetching user ${id} (${index + 1}/${userIds.length})`);
-     *   const response = await fetch(`/api/users/${id}`);
-     *   return await response.json();
-     *   }
+     *     async (id, index) => {
+     *       console.log(`Fetching user ${id} (${index + 1}/${userIds.length})`);
+     *       const response = await fetch(`/api/users/${id}`);
+     *       return await response.json();
+     *     }
      *   );
      *   console.log('All users fetched:', userDetails);
      *   ```
      *
      * @template Input - The type of elements in the input array
-     * @template Output - The type of elements in the output array
      * @param elements - The readonly array to transform
      * @returns A function that takes a transformation function and returns a
      *   Promise resolving to the transformed array
@@ -116,7 +117,7 @@ export declare namespace ArrayUtil {
      * @example
      *   ```typescript
      *   // Generate random data 5 times
-     *   const randomData = await ArrayUtil.asyncRepeat(5)(async (index) => {
+     *   const randomData = await ArrayUtil.asyncRepeat(5, async (index) => {
      *     await new Promise(resolve => setTimeout(resolve, 100)); // Wait 0.1 seconds
      *     return {
      *       id: index,
@@ -127,17 +128,17 @@ export declare namespace ArrayUtil {
      *   console.log('Generated data:', randomData);
      *   ```;
      *
+     * @template T - The type of the result from each execution
      * @param count - The number of times to repeat (non-negative integer)
-     * @returns A function that takes an async closure and returns a Promise
-     *   resolving to an array of results
+     * @param closure - The asynchronous function to execute repeatedly
+     * @returns A Promise resolving to an array of results
      */
-    const asyncRepeat: (count: number) => <T>(closure: (index: number) => Promise<T>) => Promise<T[]>;
+    const asyncRepeat: <T>(count: number, closure: (index: number) => Promise<T>) => Promise<T[]>;
     /**
      * Checks if at least one element in the array satisfies the given condition.
      *
-     * Similar to JavaScript's native some() method but implemented in curried
-     * form for better compatibility with functional programming style. Returns
-     * true immediately when the first element satisfying the condition is found.
+     * Similar to JavaScript's native some() method. Returns true immediately
+     * when the first element satisfying the condition is found.
      *
      * @example
      *   ```typescript
@@ -148,21 +149,22 @@ export declare namespace ArrayUtil {
      *     { name: 'Orange', price: 80, inStock: true }
      *   ];
      *
-     *   const hasEvenNumber = ArrayUtil.has(numbers)(num => num % 2 === 0);
+     *   const hasEvenNumber = ArrayUtil.has(numbers, num => num % 2 === 0);
      *   console.log(hasEvenNumber); // true (8 exists)
      *
-     *   const hasExpensiveItem = ArrayUtil.has(products)(product => product.price > 90);
+     *   const hasExpensiveItem = ArrayUtil.has(products, product => product.price > 90);
      *   console.log(hasExpensiveItem); // true (Apple costs 100)
      *
-     *   const hasOutOfStock = ArrayUtil.has(products)(product => !product.inStock);
+     *   const hasOutOfStock = ArrayUtil.has(products, product => !product.inStock);
      *   console.log(hasOutOfStock); // true (Banana is out of stock)
      *   ```;
      *
      * @template T - The type of elements in the array
      * @param elements - The readonly array to check
-     * @returns A function that takes a predicate and returns a boolean
+     * @param pred - The predicate function to test elements
+     * @returns Boolean indicating if any element satisfies the condition
      */
-    const has: <T>(elements: readonly T[]) => (pred: (elem: T) => boolean) => boolean;
+    const has: <T>(elements: readonly T[], pred: (elem: T) => boolean) => boolean;
     /**
      * Executes a function a specified number of times and collects the results
      * into an array.
@@ -173,14 +175,14 @@ export declare namespace ArrayUtil {
      * @example
      *   ```typescript
      *   // Generate an array of squares from 1 to 5
-     *   const squares = ArrayUtil.repeat(5)(index => (index + 1) ** 2);
+     *   const squares = ArrayUtil.repeat(5, index => (index + 1) ** 2);
      *   console.log(squares); // [1, 4, 9, 16, 25]
      *
      *   // Generate an array of default user objects
-     *   const users = ArrayUtil.repeat(3)(index => ({
-     *   id: index + 1,
-     *   name: `User${index + 1}`,
-     *   email: `user${index + 1}@example.com`
+     *   const users = ArrayUtil.repeat(3, index => ({
+     *     id: index + 1,
+     *     name: `User${index + 1}`,
+     *     email: `user${index + 1}@example.com`
      *   }));
      *   console.log(users);
      *   // [
@@ -190,10 +192,12 @@ export declare namespace ArrayUtil {
      *   // ]
      *   ```
      *
+     * @template T - The type of the result from each execution
      * @param count - The number of times to repeat (non-negative integer)
-     * @returns A function that takes a closure and returns an array of results
+     * @param closure - The function to execute repeatedly
+     * @returns An array of results
      */
-    const repeat: (count: number) => <T>(closure: (index: number) => T) => T[];
+    const repeat: <T>(count: number, closure: (index: number) => T) => T[];
     /**
      * Generates all possible subsets of a given array.
      *