@nestia/core 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 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) 2022 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/MIGRATION.md

@@ -1,169 +1,169 @@
-# Migration: Go-backed transform
-
-> [!NOTE]
-> This guide covers the **`@next`** line of Nestia, which runs on
-> TypeScript-Go (`@typescript/native-preview`) hosted by `ttsc`. For the
-> stable, stock-TypeScript v6 transform path, follow
-> [setup](https://nestia.io/docs/setup) instead.
-
-Nestia replaces the TypeScript-side transformer pipeline with a Go-backed binary (`ttsc-nestia`) hosted by `ttsc`. Public decorator APIs are unchanged; only your build configuration and tool chain change.
-
-## What stayed the same
-
-- All `@TypedBody`, `@TypedRoute`, `@TypedQuery`, `@TypedHeaders`, `@TypedParam`, `@TypedException`, `@TypedFormData`, `@PlainBody`, `@HumanRoute`, `@EncryptedBody`, `@EncryptedRoute`, `@EncryptedController`, `@EncryptedModule`, `@SwaggerCustomizer`, `@SwaggerExample`, `@WebSocketRoute`, `WebSocketAdaptor`, `DynamicModule`, `ExceptionManager`, `doNotThrowTransformError` — identical signatures.
-- All `IRequest*Validator` / `IResponse*Querifier` / `IResponse*Stringifier` runtime option interfaces — identical shapes.
-- `INestiaConfig` shape, `nestia.config.ts` lookup, and the CLI subcommands (`start`, `template`, `setup`, `dependencies`, `init`, `sdk`, `swagger`, `e2e`, `all`).
-
-## What changed
-
-### 1. `tsconfig.json` plugin entry
-
-```diff
- {
-   "compilerOptions": {
-     "plugins": [
--      { "transform": "@nestia/core/lib/transform" },
-+      { "transform": "@nestia/core/native/transform.cjs" }
-     ]
-   }
- }
-```
-
-### 2. Build command — `ttsc`, not `tsc`
-
-The Go binary is hosted by [`ttsc`](https://www.npmjs.com/package/ttsc), a TypeScript-Go compiler driver. Stock `tsc` cannot host Go plugins.
-
-```diff
- {
-   "scripts": {
--    "build": "tsc"
-+    "build": "ttsc"
-   }
- }
-```
-
-### 3. Dependencies
-
-Keep `@nestia/core`, `@nestia/fetcher`, and `typia` as runtime dependencies.
-**`@nestia/sdk` is now a runtime dependency too** — the Go binary needs to
-resolve it to attach SDK / Swagger / e2e metadata, and projects that serve
-runtime Swagger via `NestiaSwaggerComposer` already needed it at runtime.
-Install `ttsc` and `@typescript/native-preview` as devDependencies, and remove
-`ts-patch` and `typia patch` postinstalls — they are no longer used.
-
-```diff
- {
-   "dependencies": {
-+    "@nestia/sdk": "^11.2.0"
-   },
-   "devDependencies": {
--    "ts-patch": "...",
--    "@nestia/sdk": "...",
-+    "ttsc": "^0.10.2",
-+    "@typescript/native-preview": "..."
-   },
-   "scripts": {
--    "prepare": "ts-patch install && typia patch",
-     "build": "ttsc"
-   }
- }
-```
-
-### 4. TypeScript-Go preview pin
-
-The Go binary hash-locks to a specific TypeScript-Go upstream commit, surfaced through `@typescript/native-preview`. Loose ranges may drift the AST contract.
-
-```diff
-- "typescript": "^5.6.0"
-+ "@typescript/native-preview": "7.0.0-dev.20260505.1"
-```
-
-The legacy `typescript` package is no longer required at runtime; keep it only if your editor language service needs it.
-
-### 5. `npx nestia setup` no longer writes `tsconfig.json` plugins
-
-The wizard still exists — `npx nestia setup` installs the new dep / devDep
-split (`ttsc` + `@typescript/native-preview` as devDependencies; `typia`,
-`@nestia/core`, `@nestia/sdk`, `@nestia/fetcher` as dependencies; `nestia` as
-devDependency). It no longer touches `tsconfig.json` or runs `ts-patch`,
-because `ttsc` auto-discovers the Nestia transform from each package's
-`package.json#ttsc.plugin` block.
-
-You only need `compilerOptions.plugins` if you want to override transform
-options (`stringify`, `llm`, etc.) — see §6.
-
-### 6. Optional plugin composition order
-
-If you do choose to register plugins manually (for example, to pass
-`stringify` or `llm` options), the recommended shape is: typia (host
-tombstone) → `@nestia/sdk/lib/transform` → `@nestia/core/native/transform.cjs`.
-The `typia` entry stays with `enabled: false` — typia runs inside the Go
-binary, but tooling may still inspect the entry.
-
-```jsonc
-"plugins": [
-  { "transform": "typia/lib/transform", "enabled": false },
-  { "transform": "@nestia/sdk/lib/transform" },
-  { "transform": "@nestia/core/native/transform.cjs" }
-]
-```
-
-`@nestia/sdk` ships its plugin as `lib/transform` (a thin descriptor) while `@nestia/core` ships `native/transform.cjs` (the Go binary host). The asymmetry is intentional: the Go binary inside `transform.cjs` recognizes an SDK descriptor by name and runs both transforms in one compiler pass via `composes`, so plugin order in the array does not matter.
-
-### 7. Internal symbols removed
-
-The `INestiaTransformOptions`, `INestiaTransformProject`, `PlainBodyProgrammer`, `TypedBodyProgrammer`, and the `programmers/` / `transformers/` directories were deleted. None were exported from `module.ts`; if your code imported them via deep paths it must be rewritten against the new pipeline or migrated to `@nestia/factory`.
-
-### 8. `@nestia/factory` is a new published package
-
-`@nestia/factory` provides a printer-compatible TypeScript AST factory used by `@nestia/sdk` and `@nestia/migrate`. Third-party code generators that previously reached into `@nestia/core`'s internal `factories/` can depend on `@nestia/factory` directly. The surface tracks internal needs but is publicly consumable.
-
-### 9. Runtime requirement: Go 1.26+ on PATH
-
-Until prebuilt binaries are distributed via optional npm dependencies, the local toolchain must have Go 1.26+ available. CI runners typically have Go preinstalled on Ubuntu images; for deterministic builds, add `actions/setup-go@v5` with `go-version-file: packages/core/native/go.mod` to your workflows.
-
-### 10. Diagnostic format
-
-Compilation failures now surface through `ttsc-nestia: ...` stderr. The `NoTransformConfigurationError` thrown at runtime points back to this document and to https://nestia.io/docs/setup.
-
-### 11. Optional cache profiling: `TTSC_NESTIA_PROFILE`
-
-Set `TTSC_NESTIA_PROFILE=1` before running `ttsc` to print per-pass cache hit / miss counters to stderr:
-
-```bash
-TTSC_NESTIA_PROFILE=1 ttsc
-```
-
-```
-ttsc-nestia profile: core-cache hits=1024 misses=234
-ttsc-nestia profile: sdk-cache hits=567 misses=89
-```
-
-Informational only — the counters do not affect compilation output or exit code. Useful when investigating large-codebase build times.
-
-### 12. Panic stack opt-in: `NESTIA_NATIVE_DEBUG_STACK`
-
-If the Go binary aborts with `nestia.internal.panic`, set `NESTIA_NATIVE_DEBUG_STACK=1` to also print the full Go stack alongside the diagnostic. Off by default to keep build output clean; turn it on only when reproducing a panic for triage.
-
-## Quickest upgrade recipe
-
-```bash
-# 1. Drop the old patch chain
-npm uninstall ts-patch
-
-# 2. Reinstall dependencies in the new order. The runtime set matches what
-#    `npx nestia setup` installs, plus `@nestia/e2e` for projects that emit
-#    the generated e2e bundle (`npx nestia dependencies` adds it separately).
-npm i -D ttsc @typescript/native-preview
-npm i typia
-npm i @nestia/core @nestia/sdk @nestia/e2e @nestia/fetcher
-npm i -D nestia
-
-# 3. Update the build script (see §2)
-#    Optional: if you registered plugins manually, update the entries (§6)
-
-# 4. Build
-npm run build
-```
-
-If `ttsc` exits with `failed to compile`, run `npx ttsc -p tsconfig.json` directly to see the underlying `ttsc-nestia: ...` stderr diagnostic (this is the same output the SDK and CLI consume).
+# Migration: Go-backed transform
+
+> [!NOTE]
+> This guide covers the **`@next`** line of Nestia, which runs on
+> TypeScript-Go (`@typescript/native-preview`) hosted by `ttsc`. For the
+> stable, stock-TypeScript v6 transform path, follow
+> [setup](https://nestia.io/docs/setup) instead.
+
+Nestia replaces the TypeScript-side transformer pipeline with a Go-backed binary (`ttsc-nestia`) hosted by `ttsc`. Public decorator APIs are unchanged; only your build configuration and tool chain change.
+
+## What stayed the same
+
+- All `@TypedBody`, `@TypedRoute`, `@TypedQuery`, `@TypedHeaders`, `@TypedParam`, `@TypedException`, `@TypedFormData`, `@PlainBody`, `@HumanRoute`, `@EncryptedBody`, `@EncryptedRoute`, `@EncryptedController`, `@EncryptedModule`, `@SwaggerCustomizer`, `@SwaggerExample`, `@WebSocketRoute`, `WebSocketAdaptor`, `DynamicModule`, `ExceptionManager`, `doNotThrowTransformError` — identical signatures.
+- All `IRequest*Validator` / `IResponse*Querifier` / `IResponse*Stringifier` runtime option interfaces — identical shapes.
+- `INestiaConfig` shape, `nestia.config.ts` lookup, and the CLI subcommands (`start`, `template`, `setup`, `dependencies`, `init`, `sdk`, `swagger`, `e2e`, `all`).
+
+## What changed
+
+### 1. `tsconfig.json` plugin entry
+
+```diff
+ {
+   "compilerOptions": {
+     "plugins": [
+-      { "transform": "@nestia/core/lib/transform" },
++      { "transform": "@nestia/core/native/transform.cjs" }
+     ]
+   }
+ }
+```
+
+### 2. Build command — `ttsc`, not `tsc`
+
+The Go binary is hosted by [`ttsc`](https://www.npmjs.com/package/ttsc), a TypeScript-Go compiler driver. Stock `tsc` cannot host Go plugins.
+
+```diff
+ {
+   "scripts": {
+-    "build": "tsc"
++    "build": "ttsc"
+   }
+ }
+```
+
+### 3. Dependencies
+
+Keep `@nestia/core`, `@nestia/fetcher`, and `typia` as runtime dependencies.
+**`@nestia/sdk` is now a runtime dependency too** — the Go binary needs to
+resolve it to attach SDK / Swagger / e2e metadata, and projects that serve
+runtime Swagger via `NestiaSwaggerComposer` already needed it at runtime.
+Install `ttsc` and `@typescript/native-preview` as devDependencies, and remove
+`ts-patch` and `typia patch` postinstalls — they are no longer used.
+
+```diff
+ {
+   "dependencies": {
++    "@nestia/sdk": "^11.2.0"
+   },
+   "devDependencies": {
+-    "ts-patch": "...",
+-    "@nestia/sdk": "...",
++    "ttsc": "^0.10.2",
++    "@typescript/native-preview": "..."
+   },
+   "scripts": {
+-    "prepare": "ts-patch install && typia patch",
+     "build": "ttsc"
+   }
+ }
+```
+
+### 4. TypeScript-Go preview pin
+
+The Go binary hash-locks to a specific TypeScript-Go upstream commit, surfaced through `@typescript/native-preview`. Loose ranges may drift the AST contract.
+
+```diff
+- "typescript": "^5.6.0"
++ "@typescript/native-preview": "7.0.0-dev.20260505.1"
+```
+
+The legacy `typescript` package is no longer required at runtime; keep it only if your editor language service needs it.
+
+### 5. `npx nestia setup` no longer writes `tsconfig.json` plugins
+
+The wizard still exists — `npx nestia setup` installs the new dep / devDep
+split (`ttsc` + `@typescript/native-preview` as devDependencies; `typia`,
+`@nestia/core`, `@nestia/sdk`, `@nestia/fetcher` as dependencies; `nestia` as
+devDependency). It no longer touches `tsconfig.json` or runs `ts-patch`,
+because `ttsc` auto-discovers the Nestia transform from each package's
+`package.json#ttsc.plugin` block.
+
+You only need `compilerOptions.plugins` if you want to override transform
+options (`stringify`, `llm`, etc.) — see §6.
+
+### 6. Optional plugin composition order
+
+If you do choose to register plugins manually (for example, to pass
+`stringify` or `llm` options), the recommended shape is: typia (host
+tombstone) → `@nestia/sdk/lib/transform` → `@nestia/core/native/transform.cjs`.
+The `typia` entry stays with `enabled: false` — typia runs inside the Go
+binary, but tooling may still inspect the entry.
+
+```jsonc
+"plugins": [
+  { "transform": "typia/lib/transform", "enabled": false },
+  { "transform": "@nestia/sdk/lib/transform" },
+  { "transform": "@nestia/core/native/transform.cjs" }
+]
+```
+
+`@nestia/sdk` ships its plugin as `lib/transform` (a thin descriptor) while `@nestia/core` ships `native/transform.cjs` (the Go binary host). The asymmetry is intentional: the Go binary inside `transform.cjs` recognizes an SDK descriptor by name and runs both transforms in one compiler pass via `composes`, so plugin order in the array does not matter.
+
+### 7. Internal symbols removed
+
+The `INestiaTransformOptions`, `INestiaTransformProject`, `PlainBodyProgrammer`, `TypedBodyProgrammer`, and the `programmers/` / `transformers/` directories were deleted. None were exported from `module.ts`; if your code imported them via deep paths it must be rewritten against the new pipeline or migrated to `@nestia/factory`.
+
+### 8. `@nestia/factory` is a new published package
+
+`@nestia/factory` provides a printer-compatible TypeScript AST factory used by `@nestia/sdk` and `@nestia/migrate`. Third-party code generators that previously reached into `@nestia/core`'s internal `factories/` can depend on `@nestia/factory` directly. The surface tracks internal needs but is publicly consumable.
+
+### 9. Runtime requirement: Go 1.26+ on PATH
+
+Until prebuilt binaries are distributed via optional npm dependencies, the local toolchain must have Go 1.26+ available. CI runners typically have Go preinstalled on Ubuntu images; for deterministic builds, add `actions/setup-go@v5` with `go-version-file: packages/core/native/go.mod` to your workflows.
+
+### 10. Diagnostic format
+
+Compilation failures now surface through `ttsc-nestia: ...` stderr. The `NoTransformConfigurationError` thrown at runtime points back to this document and to https://nestia.io/docs/setup.
+
+### 11. Optional cache profiling: `TTSC_NESTIA_PROFILE`
+
+Set `TTSC_NESTIA_PROFILE=1` before running `ttsc` to print per-pass cache hit / miss counters to stderr:
+
+```bash
+TTSC_NESTIA_PROFILE=1 ttsc
+```
+
+```
+ttsc-nestia profile: core-cache hits=1024 misses=234
+ttsc-nestia profile: sdk-cache hits=567 misses=89
+```
+
+Informational only — the counters do not affect compilation output or exit code. Useful when investigating large-codebase build times.
+
+### 12. Panic stack opt-in: `NESTIA_NATIVE_DEBUG_STACK`
+
+If the Go binary aborts with `nestia.internal.panic`, set `NESTIA_NATIVE_DEBUG_STACK=1` to also print the full Go stack alongside the diagnostic. Off by default to keep build output clean; turn it on only when reproducing a panic for triage.
+
+## Quickest upgrade recipe
+
+```bash
+# 1. Drop the old patch chain
+npm uninstall ts-patch
+
+# 2. Reinstall dependencies in the new order. The runtime set matches what
+#    `npx nestia setup` installs, plus `@nestia/e2e` for projects that emit
+#    the generated e2e bundle (`npx nestia dependencies` adds it separately).
+npm i -D ttsc @typescript/native-preview
+npm i typia
+npm i @nestia/core @nestia/sdk @nestia/e2e @nestia/fetcher
+npm i -D nestia
+
+# 3. Update the build script (see §2)
+#    Optional: if you registered plugins manually, update the entries (§6)
+
+# 4. Build
+npm run build
+```
+
+If `ttsc` exits with `failed to compile`, run `npx ttsc -p tsconfig.json` directly to see the underlying `ttsc-nestia: ...` stderr diagnostic (this is the same output the SDK and CLI consume).

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/test/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Atest)
-[![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/test/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Atest)
+[![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/adaptors/McpAdaptor.d.ts

@@ -0,0 +1,75 @@
+import { INestApplication } from "@nestjs/common";
+/**
+ * MCP (Model Context Protocol) adaptor.
+ *
+ * `McpAdaptor` exposes every method decorated with {@link McpRoute} as an MCP
+ * tool, reachable by LLM clients through a stateless Streamable HTTP endpoint.
+ *
+ * At bootstrap the adaptor walks the {@link NestContainer}, collects every
+ * controller method carrying `"nestia/McpRoute"` metadata, and caches a tool
+ * registry. A fresh MCP server and transport pair is spun up per incoming HTTP
+ * request, following MCP stateless Streamable HTTP mode. This adaptor
+ * intentionally does not manage `Mcp-Session-Id` state.
+ *
+ * Typia-generated JSON Schemas flow through unchanged; the Zod-based high-level
+ * registration API of `McpServer` is bypassed by accessing the low-level
+ * `.server` handler.
+ *
+ * Error mapping follows the MCP specification:
+ *
+ * - Unknown tool name: JSON-RPC `-32601`.
+ * - Typia validation failure: JSON-RPC `-32602` with structured diagnostics.
+ * - Handler throws {@link HttpException}: success response with `isError: true`,
+ *   so the LLM can read the message and recover.
+ * - Any other throw: JSON-RPC `-32603`.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ * @example
+ *   ```typescript
+ *   import core from "@nestia/core";
+ *   import { NestFactory } from "@nestjs/core";
+ *
+ *   const app = await NestFactory.create(AppModule);
+ *   await core.McpAdaptor.upgrade(app, { path: "/mcp" });
+ *   await app.listen(3000);
+ *   ```;
+ */
+export declare class McpAdaptor {
+    /**
+     * Upgrade a running Nest application with a stateless MCP endpoint.
+     *
+     * Scans the application container for methods decorated with {@link McpRoute},
+     * then registers a catch-all HTTP route at the configured path. Each incoming
+     * request builds a fresh MCP server + transport on demand, wires the
+     * registered tools into it, and delegates handling.
+     *
+     * Must be called after `NestFactory.create(...)` but before `app.listen(...)`
+     * if you want the MCP endpoint to be reachable alongside your regular HTTP
+     * routes.
+     *
+     * @param app Running Nest application instance.
+     * @param options Transport and identity overrides.
+     */
+    static upgrade(app: INestApplication, options?: McpAdaptor.IOptions): Promise<void>;
+}
+export declare namespace McpAdaptor {
+    /** Configuration options for {@link McpAdaptor.upgrade}. */
+    interface IOptions {
+        /**
+         * HTTP path where the MCP endpoint will be mounted.
+         *
+         * @default "/mcp"
+         */
+        path?: string;
+        /**
+         * Identity advertised to MCP clients during the initialize handshake. Shows
+         * up in Claude Desktop / Cursor's MCP panel.
+         *
+         * @default { name: "nestia-mcp", version: "1.0.0" }
+         */
+        serverInfo?: {
+            name: string;
+            version: string;
+        };
+    }
+}