@nestia/core 4.5.0-dev.20241218-2 → 4.5.0

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/README.md

@@ -1,87 +1,87 @@
-# 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/)
-[![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 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/migrate`: OpenAPI generator from Swagger to NestJS/SDK
-  - `@nestia/editor`: Swagger-UI with Online TypeScript Editor
-  - `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/)
-    - [TypedHeaders](https://nestia.io/docs/core/TypedHeaders/)
-    - [TypedException](https://nestia.io/docs/core/TypedException/)
-  - Generators
-    - [Swagger Documents](https://nestia.io/docs/sdk/swagger/)
-    - [Software Development Kit](https://nestia.io/docs/sdk/sdk/)
-    - [E2E Functions](https://nestia.io/docs/sdk/e2e/)
-    - [Mockup Simulator](https://nestia.io/docs/sdk/simulator/)
-  - 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/)
-  - [Swagger to NestJS](https://nestia.io/docs/migrate/)
-  - [TypeScript Swagger Editor](https://nestia.io/docs/editor/)
-
-### 🔗 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/)
+[![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 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/migrate`: OpenAPI generator from Swagger to NestJS/SDK
+  - `@nestia/editor`: Swagger-UI with Online TypeScript Editor
+  - `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/)
+    - [TypedHeaders](https://nestia.io/docs/core/TypedHeaders/)
+    - [TypedException](https://nestia.io/docs/core/TypedException/)
+  - Generators
+    - [Swagger Documents](https://nestia.io/docs/sdk/swagger/)
+    - [Software Development Kit](https://nestia.io/docs/sdk/sdk/)
+    - [E2E Functions](https://nestia.io/docs/sdk/e2e/)
+    - [Mockup Simulator](https://nestia.io/docs/sdk/simulator/)
+  - 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/)
+  - [Swagger to NestJS](https://nestia.io/docs/migrate/)
+  - [TypeScript Swagger Editor](https://nestia.io/docs/editor/)
+
+### 🔗 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/decorators/HumanRoute.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Human only API marking.
+ *
+ * This decorator marks the API for human only, so that LLM function calling
+ * schema composer (of [`@samchon/openapi`](https://github.com/samchon/openapi))
+ * excludes the API.
+ *
+ * In other words, if you adjust the `@HumanRoute()` decorator to the API,
+ * the API never participates in the LLM function calling. When calling the
+ * {@link HttpLlm.application} function, matched {@link IHttpLlmFunction} data
+ * never be composed.
+ *
+ * @returns Method decorator
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare function HumanRoute(): MethodDecorator;

package/lib/decorators/HumanRoute.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HumanRoute = HumanRoute;
+const SwaggerCustomizer_1 = require("./SwaggerCustomizer");
+/**
+ * Human only API marking.
+ *
+ * This decorator marks the API for human only, so that LLM function calling
+ * schema composer (of [`@samchon/openapi`](https://github.com/samchon/openapi))
+ * excludes the API.
+ *
+ * In other words, if you adjust the `@HumanRoute()` decorator to the API,
+ * the API never participates in the LLM function calling. When calling the
+ * {@link HttpLlm.application} function, matched {@link IHttpLlmFunction} data
+ * never be composed.
+ *
+ * @returns Method decorator
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+function HumanRoute() {
+    return (0, SwaggerCustomizer_1.SwaggerCustomizer)((props) => {
+        props.route["x-samchon-human"] = true;
+    });
+}
+//# sourceMappingURL=HumanRoute.js.map

package/lib/decorators/HumanRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HumanRoute.js","sourceRoot":"","sources":["../../src/decorators/HumanRoute.ts"],"names":[],"mappings":";;AAiBA,gCAIC;AArBD,2DAAwD;AAExD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,UAAU;IACxB,OAAO,IAAA,qCAAiB,EAAC,CAAC,KAAK,EAAE,EAAE;QACjC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/module.d.ts

@@ -1,5 +1,6 @@
 export * from "./decorators/DynamicModule";
 export * from "./utils/ExceptionManager";
+export * from "./decorators/HumanRoute";
 export * from "./decorators/TypedRoute";
 export * from "./decorators/TypedBody";
 export * from "./decorators/TypedQuery";

package/lib/module.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./decorators/DynamicModule"), exports);
 __exportStar(require("./utils/ExceptionManager"), exports);
+__exportStar(require("./decorators/HumanRoute"), exports);
 __exportStar(require("./decorators/TypedRoute"), exports);
 __exportStar(require("./decorators/TypedBody"), exports);
 __exportStar(require("./decorators/TypedQuery"), exports);

package/lib/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,2DAAyC;AAEzC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AACxC,8DAA4C;AAC5C,4DAA0C;AAC1C,6DAA2C;AAC3C,0DAAwC;AAExC,mEAAiD;AACjD,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C;AAC7C,yDAAuC;AACvC,iEAA+C;AAC/C,8DAA4C;AAE5C,8DAA4C;AAC5C,8DAA4C"}
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,2DAAyC;AAEzC,0DAAwC;AACxC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AACxC,8DAA4C;AAC5C,4DAA0C;AAC1C,6DAA2C;AAC3C,0DAAwC;AAExC,mEAAiD;AACjD,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C;AAC7C,yDAAuC;AACvC,iEAA+C;AAC/C,8DAA4C;AAE5C,8DAA4C;AAC5C,8DAA4C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/core",
-  "version": "4.5.0-dev.20241218-2",
+  "version": "4.5.0",
   "description": "Super-fast validation decorators of NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -36,10 +36,10 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@nestia/fetcher": "^4.5.0-dev.20241218-2",
+    "@nestia/fetcher": "^4.5.0",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
-    "@samchon/openapi": "^2.3.0-dev.20241218",
+    "@samchon/openapi": "^2.3.0",
     "detect-ts-node": "^1.0.5",
     "get-function-location": "^2.0.0",
     "glob": "^7.2.0",
@@ -48,16 +48,16 @@
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
     "tgrid": "^1.1.0",
-    "typia": "^7.5.0-dev.20241218",
+    "typia": "^7.5.0",
     "ws": "^7.5.3"
   },
   "peerDependencies": {
-    "@nestia/fetcher": ">=4.5.0-dev.20241218-2",
+    "@nestia/fetcher": ">=4.5.0",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
-    "typia": ">=7.5.0-dev.20241218 <8.0.0"
+    "typia": ">=7.5.0 <8.0.0"
   },
   "devDependencies": {
     "@nestjs/common": "^10.4.13",