@nestia/fetcher 9.0.0-dev.20251107-3 → 9.0.1

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/package.json

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

package/src/AesPkcs5.ts

@@ -1,49 +1,49 @@
-import crypto from "crypto";
-
-/**
- * Utility class for the AES-128/256 encryption.
- *
- * - AES-128/256
- * - CBC mode
- * - PKCS#5 Padding
- * - Base64 Encoding
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace AesPkcs5 {
-  /**
-   * Encrypt data
-   *
-   * @param data Target data
-   * @param key Key value of the encryption.
-   * @param iv Initializer Vector for the encryption
-   * @returns Encrypted data
-   */
-  export function encrypt(data: string, key: string, iv: string): string {
-    const bytes: number = key.length * 8;
-    const cipher: crypto.Cipher = crypto.createCipheriv(
-      `AES-${bytes}-CBC`,
-      key,
-      iv,
-    );
-    return cipher.update(data, "utf8", "base64") + cipher.final("base64");
-  }
-
-  /**
-   * Decrypt data.
-   *
-   * @param data Target data
-   * @param key Key value of the decryption.
-   * @param iv Initializer Vector for the decryption
-   * @returns Decrypted data.
-   */
-  export function decrypt(data: string, key: string, iv: string): string {
-    const bytes: number = key.length * 8;
-    const decipher: crypto.Decipher = crypto.createDecipheriv(
-      `AES-${bytes}-CBC`,
-      key,
-      iv,
-    );
-    return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
-  }
-}
+import crypto from "crypto";
+
+/**
+ * Utility class for the AES-128/256 encryption.
+ *
+ * - AES-128/256
+ * - CBC mode
+ * - PKCS#5 Padding
+ * - Base64 Encoding
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace AesPkcs5 {
+  /**
+   * Encrypt data
+   *
+   * @param data Target data
+   * @param key Key value of the encryption.
+   * @param iv Initializer Vector for the encryption
+   * @returns Encrypted data
+   */
+  export function encrypt(data: string, key: string, iv: string): string {
+    const bytes: number = key.length * 8;
+    const cipher: crypto.Cipher = crypto.createCipheriv(
+      `AES-${bytes}-CBC`,
+      key,
+      iv,
+    );
+    return cipher.update(data, "utf8", "base64") + cipher.final("base64");
+  }
+
+  /**
+   * Decrypt data.
+   *
+   * @param data Target data
+   * @param key Key value of the decryption.
+   * @param iv Initializer Vector for the decryption
+   * @returns Decrypted data.
+   */
+  export function decrypt(data: string, key: string, iv: string): string {
+    const bytes: number = key.length * 8;
+    const decipher: crypto.Decipher = crypto.createDecipheriv(
+      `AES-${bytes}-CBC`,
+      key,
+      iv,
+    );
+    return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
+  }
+}

package/src/EncryptedFetcher.ts

@@ -1,176 +1,176 @@
-import { AesPkcs5 } from "./AesPkcs5";
-import { IConnection } from "./IConnection";
-import { IEncryptionPassword } from "./IEncryptionPassword";
-import { IFetchRoute } from "./IFetchRoute";
-import { IPropagation } from "./IPropagation";
-import { FetcherBase } from "./internal/FetcherBase";
-
-/**
- * Utility class for `fetch` functions used in `@nestia/sdk` with encryption.
- *
- * `EncryptedFetcher` is a utility class designed for SDK functions generated by
- * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
- * HTTP API encrypted by AES-PKCS algorithm. In other words, this is a
- * collection of dedicated `fetch()` functions for `@nestia/sdk` with
- * encryption.
- *
- * For reference, `EncryptedFetcher` class being used only when target
- * controller method is encrypting body data by `@EncryptedRoute` or
- * `@EncryptedBody` decorators. If those decorators are not used,
- * {@link PlainFetcher} class would be used instead.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace EncryptedFetcher {
-  /**
-   * Fetch function only for `HEAD` method.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @returns Nothing because of `HEAD` method
-   */
-  export function fetch(
-    connection: IConnection,
-    route: IFetchRoute<"HEAD">,
-  ): Promise<void>;
-
-  /**
-   * Fetch function only for `GET` method.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @returns Response body data from the remote API
-   */
-  export function fetch<Output>(
-    connection: IConnection,
-    route: IFetchRoute<"GET">,
-  ): Promise<Output>;
-
-  /**
-   * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @returns Response body data from the remote API
-   */
-  export function fetch<Input, Output>(
-    connection: IConnection,
-    route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output>;
-
-  export async function fetch<Input, Output>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output> {
-    if (
-      (route.request?.encrypted === true || route.response?.encrypted) &&
-      connection.encryption === undefined
-    )
-      throw new Error(
-        "Error on EncryptedFetcher.fetch(): the encryption password has not been configured.",
-      );
-    const closure =
-      typeof connection.encryption === "function"
-        ? (direction: "encode" | "decode") =>
-            (
-              headers: Record<string, IConnection.HeaderValue | undefined>,
-              body: string,
-            ) =>
-              (connection.encryption as IEncryptionPassword.Closure)({
-                headers,
-                body,
-                direction,
-              })
-        : () => () => connection.encryption as IEncryptionPassword;
-
-    return FetcherBase.request({
-      className: "EncryptedFetcher",
-      encode:
-        route.request?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("encode")(headers, input);
-              return AesPkcs5.encrypt(
-                (stringify ?? JSON.stringify)(input),
-                p.key,
-                p.iv,
-              );
-            }
-          : (input) => input,
-      decode:
-        route.response?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("decode")(headers, input);
-              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
-              return s.length ? JSON.parse(s) : s;
-            }
-          : (input) => input,
-    })(connection, route, input, stringify);
-  }
-
-  export function propagate<Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"GET" | "HEAD">,
-  ): Promise<Output>;
-
-  export function propagate<Input, Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output>;
-
-  export async function propagate<Input, Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output> {
-    if (
-      (route.request?.encrypted === true || route.response?.encrypted) &&
-      connection.encryption === undefined
-    )
-      throw new Error(
-        "Error on EncryptedFetcher.propagate(): the encryption password has not been configured.",
-      );
-    const closure =
-      typeof connection.encryption === "function"
-        ? (direction: "encode" | "decode") =>
-            (
-              headers: Record<string, IConnection.HeaderValue | undefined>,
-              body: string,
-            ) =>
-              (connection.encryption as IEncryptionPassword.Closure)({
-                headers,
-                body,
-                direction,
-              })
-        : () => () => connection.encryption as IEncryptionPassword;
-
-    return FetcherBase.propagate({
-      className: "EncryptedFetcher",
-      encode:
-        route.request?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("encode")(headers, input);
-              return AesPkcs5.encrypt(
-                (stringify ?? JSON.stringify)(input),
-                p.key,
-                p.iv,
-              );
-            }
-          : (input) => input,
-      decode:
-        route.response?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("decode")(headers, input);
-              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
-              return s.length ? JSON.parse(s) : s;
-            }
-          : (input) => input,
-    })(connection, route, input, stringify) as Promise<Output>;
-  }
-}
+import { AesPkcs5 } from "./AesPkcs5";
+import { IConnection } from "./IConnection";
+import { IEncryptionPassword } from "./IEncryptionPassword";
+import { IFetchRoute } from "./IFetchRoute";
+import { IPropagation } from "./IPropagation";
+import { FetcherBase } from "./internal/FetcherBase";
+
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk` with encryption.
+ *
+ * `EncryptedFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP API encrypted by AES-PKCS algorithm. In other words, this is a
+ * collection of dedicated `fetch()` functions for `@nestia/sdk` with
+ * encryption.
+ *
+ * For reference, `EncryptedFetcher` class being used only when target
+ * controller method is encrypting body data by `@EncryptedRoute` or
+ * `@EncryptedBody` decorators. If those decorators are not used,
+ * {@link PlainFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace EncryptedFetcher {
+  /**
+   * Fetch function only for `HEAD` method.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @returns Nothing because of `HEAD` method
+   */
+  export function fetch(
+    connection: IConnection,
+    route: IFetchRoute<"HEAD">,
+  ): Promise<void>;
+
+  /**
+   * Fetch function only for `GET` method.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @returns Response body data from the remote API
+   */
+  export function fetch<Output>(
+    connection: IConnection,
+    route: IFetchRoute<"GET">,
+  ): Promise<Output>;
+
+  /**
+   * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @returns Response body data from the remote API
+   */
+  export function fetch<Input, Output>(
+    connection: IConnection,
+    route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output>;
+
+  export async function fetch<Input, Output>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output> {
+    if (
+      (route.request?.encrypted === true || route.response?.encrypted) &&
+      connection.encryption === undefined
+    )
+      throw new Error(
+        "Error on EncryptedFetcher.fetch(): the encryption password has not been configured.",
+      );
+    const closure =
+      typeof connection.encryption === "function"
+        ? (direction: "encode" | "decode") =>
+            (
+              headers: Record<string, IConnection.HeaderValue | undefined>,
+              body: string,
+            ) =>
+              (connection.encryption as IEncryptionPassword.Closure)({
+                headers,
+                body,
+                direction,
+              })
+        : () => () => connection.encryption as IEncryptionPassword;
+
+    return FetcherBase.request({
+      className: "EncryptedFetcher",
+      encode:
+        route.request?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("encode")(headers, input);
+              return AesPkcs5.encrypt(
+                (stringify ?? JSON.stringify)(input),
+                p.key,
+                p.iv,
+              );
+            }
+          : (input) => input,
+      decode:
+        route.response?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("decode")(headers, input);
+              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
+              return s.length ? JSON.parse(s) : s;
+            }
+          : (input) => input,
+    })(connection, route, input, stringify);
+  }
+
+  export function propagate<Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"GET" | "HEAD">,
+  ): Promise<Output>;
+
+  export function propagate<Input, Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output>;
+
+  export async function propagate<Input, Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output> {
+    if (
+      (route.request?.encrypted === true || route.response?.encrypted) &&
+      connection.encryption === undefined
+    )
+      throw new Error(
+        "Error on EncryptedFetcher.propagate(): the encryption password has not been configured.",
+      );
+    const closure =
+      typeof connection.encryption === "function"
+        ? (direction: "encode" | "decode") =>
+            (
+              headers: Record<string, IConnection.HeaderValue | undefined>,
+              body: string,
+            ) =>
+              (connection.encryption as IEncryptionPassword.Closure)({
+                headers,
+                body,
+                direction,
+              })
+        : () => () => connection.encryption as IEncryptionPassword;
+
+    return FetcherBase.propagate({
+      className: "EncryptedFetcher",
+      encode:
+        route.request?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("encode")(headers, input);
+              return AesPkcs5.encrypt(
+                (stringify ?? JSON.stringify)(input),
+                p.key,
+                p.iv,
+              );
+            }
+          : (input) => input,
+      decode:
+        route.response?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("decode")(headers, input);
+              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
+              return s.length ? JSON.parse(s) : s;
+            }
+          : (input) => input,
+    })(connection, route, input, stringify) as Promise<Output>;
+  }
+}