typia 3.4.9 → 3.4.10

package/README.md

@@ -41,6 +41,16 @@ Also, as `typia` performs AOT (Ahead of Time) compilation skill, its performance
 
 
 
+## Sponsors and Backers
+Thanks for your support.
+
+Your donation would encourage `typia` development.
+
+[![Backers](https://opencollective.com/typia/backers.svg?width=1000)](https://opencollective.com/typia)
+
+
+
+
 ## Setup
 ### Setup Wizard
 ```bash
@@ -78,7 +88,7 @@ If you want to install and setup `typia` manually, read [Guide Documents - Setup
 
 Also, the [Guide Documents - Setup](https://github.com/samchon/typia/wiki/Setup), you can learn how to use pure TypeScript compiler `tsc` instead of installing the `ttypescript` compiler with `ttsc` command.
 
-### vite
+### Vite
 When you want to setup `typia` on your frontend project with [`vite`](https://vitejs.dev/), just configure `vite.config.ts` like below.
 
 For reference, don't forget running [Setup Wizard](#setup-wizard) before.
@@ -203,104 +213,36 @@ export function createAssertStringify<T>(): (input: T) => string;
 
 ## Appendix
 ### Nestia
-https://github.com/samchon/nestia
-
-Automatic `SDK` and `Swagger` generator for `NestJS`, evolved than ever.
-
-`nestia` is an evolved `SDK` and `Swagger` generator, which analyzes your `NestJS` server code in the compilation level. With `nestia` and compilation level analyzer, you don't need to write any swagger or class-validator decorators.
-
-Reading below table and example code, feel how the "compilation level" makes `nestia` stronger.
-
-Components | `nestia`::SDK | `nestia`::swagger | `@nestjs/swagger`
------------|---|---|---
-Pure DTO interface | ✔ | ✔ | ❌
-Description comments | ✔ | ✔ | ❌
-Simple structure | ✔ | ✔ | ✔
-Generic type | ✔ | ✔ | ❌
-Union type | ✔ | ✔ | ▲
-Intersection type | ✔ | ✔ | ▲
-Conditional type | ✔ | ▲ | ❌
-Auto completion | ✔ | ❌ | ❌
-Type hints | ✔ | ❌ | ❌
-5x faster `JSON.stringify()` | ✔ | ❌ | ❌
-Ensure type safety | ✅ | ❌ | ❌
-
-```typescript
-// IMPORT SDK LIBRARY GENERATED BY NESTIA
-import api from "@samchon/shopping-api";
-import { IPage } from "@samchon/shopping-api/lib/structures/IPage";
-import { ISale } from "@samchon/shopping-api/lib/structures/ISale";
-import { ISaleArticleComment } from "@samchon/shopping-api/lib/structures/ISaleArticleComment";
-import { ISaleQuestion } from "@samchon/shopping-api/lib/structures/ISaleQuestion";
-
-export async function trace_sale_question_and_comment
-    (connection: api.IConnection): Promise<void>
-{
-    // LIST UP SALE SUMMARIES
-    const index: IPage<ISale.ISummary> = await api.functional.shoppings.sales.index
-    (
-        connection,
-        "general",
-        { limit: 100, page: 1 }
-    );
-
-    // PICK A SALE
-    const sale: ISale = await api.functional.shoppings.sales.at
-    (
-        connection, 
-        index.data[0].id
-    );
-    console.log("sale", sale);
-
-    // WRITE A QUESTION
-    const question: ISaleQuestion = await api.functional.shoppings.sales.questions.store
-    (
-        connection,
-        "general",
-        sale.id,
-        {
-            title: "How to use this product?",
-            body: "The description is not fully enough. Can you introduce me more?",
-            files: []
-        }
-    );
-    console.log("question", question);
-
-    // WRITE A COMMENT
-    const comment: ISaleArticleComment = await api.functional.shoppings.sales.comments.store
-    (
-        connection,
-        "general",
-        sale.id,
-        question.id,
-        {
-            body: "p.s) Can you send me a detailed catalogue?",
-            anonymous: false
-        }
-    );
-    console.log("comment", comment);
-}
-```
-
-### Nestia-Helper
-https://github.com/samchon/nestia-helper
+[![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/core.svg)](https://www.npmjs.com/package/@nestia/core)
+[![Downloads](https://img.shields.io/npm/dm/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)
+[![Build Status](https://github.com/samchon/typia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)
+[![Guide Documents](https://img.shields.io/badge/wiki-documentation-forestgreen)](https://github.com/samchon/nestia/wiki)
 
-Helper library of `NestJS`, using this `typia`.
+[Nestia](https://github.com/samchon/nestia) is a helper library set for `NestJS`, supporting below features:
 
-`nestia-helper` is a helper library of `NestJS`, which boosts up the `JSON.stringify()` speed 5x times faster about the API responses, automatically. Also, `nestia-helper` supports automatic validation of request body, that is maximum 15,000x times faster than legacy `class-validator` too. 
+  - [`@nestia/core`](https://github.com/samchon/nestia#nestiacore): **15,000x times faster** validation decorator using `typia`
+  - [`@nestia/sdk`](https://github.com/samchon/nestia#nestiasdk): evolved **SDK** and **Swagger** generator for `@nestia/core`
+  - `nestia`: just CLI (command line interface) tool
 
 ```typescript
-import helper from "nestia-helper";
-import * as nest from "@nestjs/common";
-
-@nest.Controller("bbs/articles")
-export class BbsArticlesController
-{
-    // automatic typia.stringify() for response body
-    @helper.TypedRoute.Get()
-    public store(
-        // automatic typia.assert() for request body
-        @helper.TypedBody() input: IBbsArticle.IStore
+import { Controller } from "@nestjs/common";
+import { TypedBody, TypedRoute } from "@nestia/core";
+
+import { IBbsArticle } from "@bbs-api/structures/IBbsArticle";
+
+@Controller("bbs/articles")
+export class BbsArticlesController {
+    /** 
+     * Store a new content.
+     * 
+     * @param inupt Content to store
+     * @returns Newly archived article
+     */
+    @TypedRoute.Post() // 10x faster and safer JSON.stringify()
+    public async store(
+        // super-fast validator
+        @TypedBody() input: IBbsArticle.IStore
     ): Promise<IBbsArticle>;
 }
 ```

package/lib/factories/ExpressionFactory.d.ts

@@ -2,6 +2,6 @@ import ts from "typescript";
 export declare namespace ExpressionFactory {
     function isRequired(input: ts.Expression): ts.Expression;
     function isArray(input: ts.Expression): ts.Expression;
-    function isObject(input: ts.Expression, nullChecked: boolean): ts.Expression;
+    function isObject(input: ts.Expression, checkNull: boolean): ts.Expression;
     function isInstanceOf(input: ts.Expression, type: string): ts.Expression;
 }

package/lib/factories/ExpressionFactory.js

@@ -15,15 +15,14 @@ var ExpressionFactory;
         return typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createIdentifier("Array.isArray"), undefined, [input]);
     }
     ExpressionFactory.isArray = isArray;
-    function isObject(input, nullChecked) {
+    function isObject(input, checkNull) {
         var conditions = [
             typescript_1.default.factory.createStrictEquality(typescript_1.default.factory.createStringLiteral("object"), typescript_1.default.factory.createTypeOfExpression(input)),
         ];
-        if (nullChecked === true)
+        if (checkNull === true)
             conditions.push(typescript_1.default.factory.createStrictInequality(typescript_1.default.factory.createNull(), input));
-        return conditions.length === 1
-            ? conditions[0]
-            : conditions.reduce(function (x, y) { return typescript_1.default.factory.createLogicalAnd(x, y); });
+        conditions.push(typescript_1.default.factory.createStrictEquality(typescript_1.default.factory.createFalse(), typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createIdentifier("Array.isArray"), undefined, [input])));
+        return conditions.reduce(function (x, y) { return typescript_1.default.factory.createLogicalAnd(x, y); });
     }
     ExpressionFactory.isObject = isObject;
     function isInstanceOf(input, type) {

package/lib/factories/ExpressionFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpressionFactory.js","sourceRoot":"","sources":["../../src/factories/ExpressionFactory.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA4B;AAE5B,IAAiB,iBAAiB,CAiDjC;AAjDD,WAAiB,iBAAiB;IAC9B,SAAgB,UAAU,CAAC,KAAoB;QAC3C,OAAO,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CACpC,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,EACxC,KAAK,CACR,CAAC;IACN,CAAC;IALe,4BAAU,aAKzB,CAAA;IAED,SAAgB,OAAO,CAAC,KAAoB;QACxC,OAAO,oBAAE,CAAC,OAAO,CAAC,oBAAoB,CAClC,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAC5C,SAAS,EACT,CAAC,KAAK,CAAC,CACV,CAAC;IACN,CAAC;IANe,yBAAO,UAMtB,CAAA;IAED,SAAgB,QAAQ,CACpB,KAAoB,EACpB,WAAoB;QAEpB,IAAM,UAAU,GAAoB;YAChC,oBAAE,CAAC,OAAO,CAAC,oBAAoB,CAC3B,oBAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EACxC,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAC3C;SACJ,CAAC;QACF,IAAI,WAAW,KAAK,IAAI;YACpB,UAAU,CAAC,IAAI,CACX,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CAC7B,oBAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EACvB,KAAK,CACR,CACJ,CAAC;QAEN,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC;YAC1B,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE;YAChB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAjC,CAAiC,CAAC,CAAC;IACzE,CAAC;IArBe,0BAAQ,WAqBvB,CAAA;IAED,SAAgB,YAAY,CACxB,KAAoB,EACpB,IAAY;QAEZ,OAAO,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CACpC,KAAK,EACL,oBAAE,CAAC,OAAO,CAAC,WAAW,CAAC,oBAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,EACvD,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CACpC,CAAC;IACN,CAAC;IATe,8BAAY,eAS3B,CAAA;AACL,CAAC,EAjDgB,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAiDjC"}
+{"version":3,"file":"ExpressionFactory.js","sourceRoot":"","sources":["../../src/factories/ExpressionFactory.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA4B;AAE5B,IAAiB,iBAAiB,CAyDjC;AAzDD,WAAiB,iBAAiB;IAC9B,SAAgB,UAAU,CAAC,KAAoB;QAC3C,OAAO,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CACpC,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,EACxC,KAAK,CACR,CAAC;IACN,CAAC;IALe,4BAAU,aAKzB,CAAA;IAED,SAAgB,OAAO,CAAC,KAAoB;QACxC,OAAO,oBAAE,CAAC,OAAO,CAAC,oBAAoB,CAClC,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAC5C,SAAS,EACT,CAAC,KAAK,CAAC,CACV,CAAC;IACN,CAAC;IANe,yBAAO,UAMtB,CAAA;IAED,SAAgB,QAAQ,CACpB,KAAoB,EACpB,SAAkB;QAElB,IAAM,UAAU,GAAoB;YAChC,oBAAE,CAAC,OAAO,CAAC,oBAAoB,CAC3B,oBAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EACxC,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAC3C;SACJ,CAAC;QACF,IAAI,SAAS,KAAK,IAAI;YAClB,UAAU,CAAC,IAAI,CACX,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CAC7B,oBAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EACvB,KAAK,CACR,CACJ,CAAC;QACN,UAAU,CAAC,IAAI,CACX,oBAAE,CAAC,OAAO,CAAC,oBAAoB,CAC3B,oBAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EACxB,oBAAE,CAAC,OAAO,CAAC,oBAAoB,CAC3B,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAC5C,SAAS,EACT,CAAC,KAAK,CAAC,CACV,CACJ,CACJ,CAAC;QAEF,OAAO,UAAU,CAAC,MAAM,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAjC,CAAiC,CAAC,CAAC;IAC1E,CAAC;IA7Be,0BAAQ,WA6BvB,CAAA;IAED,SAAgB,YAAY,CACxB,KAAoB,EACpB,IAAY;QAEZ,OAAO,oBAAE,CAAC,OAAO,CAAC,sBAAsB,CACpC,KAAK,EACL,oBAAE,CAAC,OAAO,CAAC,WAAW,CAAC,oBAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,EACvD,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CACpC,CAAC;IACN,CAAC;IATe,8BAAY,eAS3B,CAAA;AACL,CAAC,EAzDgB,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAyDjC"}

package/lib/factories/ValueFactory.d.ts

@@ -2,7 +2,7 @@ import ts from "typescript";
 export declare namespace ValueFactory {
     const NULL: () => ts.NullLiteral;
     const UNDEFINED: () => ts.Identifier;
-    const BOOLEAN: (value: boolean) => ts.TrueLiteral | ts.FalseLiteral;
+    const BOOLEAN: (value: boolean) => ts.FalseLiteral | ts.TrueLiteral;
     const INPUT: (str?: string) => ts.Identifier;
     const TYPEOF: (input: ts.Expression) => ts.TypeOfExpression;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typia",
-  "version": "3.4.9",
+  "version": "3.4.10",
   "description": "Runtime type checkers and 5x faster JSON.stringify() function",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/src/factories/ExpressionFactory.ts

@@ -18,7 +18,7 @@ export namespace ExpressionFactory {
 
     export function isObject(
         input: ts.Expression,
-        nullChecked: boolean,
+        checkNull: boolean,
     ): ts.Expression {
         const conditions: ts.Expression[] = [
             ts.factory.createStrictEquality(
@@ -26,17 +26,25 @@ export namespace ExpressionFactory {
                 ts.factory.createTypeOfExpression(input),
             ),
         ];
-        if (nullChecked === true)
+        if (checkNull === true)
             conditions.push(
                 ts.factory.createStrictInequality(
                     ts.factory.createNull(),
                     input,
                 ),
             );
+        conditions.push(
+            ts.factory.createStrictEquality(
+                ts.factory.createFalse(),
+                ts.factory.createCallExpression(
+                    ts.factory.createIdentifier("Array.isArray"),
+                    undefined,
+                    [input],
+                ),
+            ),
+        );
 
-        return conditions.length === 1
-            ? conditions[0]!
-            : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
+        return conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
     }
 
     export function isInstanceOf(