nestia 5.3.0 → 5.3.1

package/README.md

@@ -18,7 +18,7 @@ Nestia is a set of helper libraries for NestJS, supporting below features:
   - `@nestia/migrate`: migration from Swagger to NestJS
   - `nestia`: just CLI (command line interface) tool
 
-> **Note**
+> [!NOTE]
 > 
 > - **Only one line** required, with pure TypeScript type
 > - Enhance performance **30x** up
@@ -59,7 +59,7 @@ Check out the document in the [website](https://nestia.io/docs/):
     - [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/)
+    - [TypedQuery](https://nestia.io/docs/core/TypedRoute/)
     - [TypedHeaders](https://nestia.io/docs/core/TypedHeaders/)
     - [TypedException](https://nestia.io/docs/core/TypedException/)
   - Generators

package/bin/NestiaSetupWizard.js

@@ -35,7 +35,7 @@ var NestiaSetupWizard;
             // INSTALL TYPESCRIPT COMPILERS
             pack.install({ dev: true, modulo: "ts-patch", version: "latest" });
             pack.install({ dev: true, modulo: "ts-node", version: "latest" });
-            pack.install({ dev: true, modulo: "typescript", version: "5.4.2" });
+            pack.install({ dev: true, modulo: "typescript", version: "5.5.2" });
             (_a = args.project) !== null && _a !== void 0 ? _a : (args.project = (() => {
                 const runner = pack.manager === "npm" ? "npx" : pack.manager;
                 CommandExecutor_1.CommandExecutor.run(`${runner} tsc --init`);

package/bin/internal/PluginConfigurator.js

@@ -54,30 +54,30 @@ var PluginConfigurator;
             compilerOptions.experimentalDecorators = true;
             compilerOptions.emitDecoratorMetadata = true;
             if (core === undefined)
-                plugins.push(comment_json_1.default.parse(`{
-                    "transform": "@nestia/core/lib/transform",
-        /**
-         * Validate request body.
-         * 
-         *   - "assert": Use typia.assert() function
-         *   - "is": Use typia.is() function
-         *   - "validate": Use typia.validate() function
-         *   - "assertEquals": Use typia.assertEquals() function
-         *   - "equals": Use typia.equals() function
-         *   - "validateEquals": Use typia.validateEquals() function
-         */
-                            "validate": "assert",
-
-        /**
-         * Validate JSON typed response body.
-         * 
-         *   - "assert": Use typia.assertStringify() function
-         *   - "is": Use typia.isStringify() function
-         *   - "validate": Use typia.validateStringify() function
-         *   - "stringify": Use typia.stringify() function, but dangerous
-         *   - null: Just use JSON.stringify() function, without boosting
-         */
-                    "stringify": "assert"
+                plugins.push(comment_json_1.default.parse(`{
+                    "transform": "@nestia/core/lib/transform",
+        /**
+         * Validate request body.
+         * 
+         *   - "assert": Use typia.assert() function
+         *   - "is": Use typia.is() function
+         *   - "validate": Use typia.validate() function
+         *   - "assertEquals": Use typia.assertEquals() function
+         *   - "equals": Use typia.equals() function
+         *   - "validateEquals": Use typia.validateEquals() function
+         */
+                            "validate": "assert",
+
+        /**
+         * Validate JSON typed response body.
+         * 
+         *   - "assert": Use typia.assertStringify() function
+         *   - "is": Use typia.isStringify() function
+         *   - "validate": Use typia.validateStringify() function
+         *   - "stringify": Use typia.stringify() function, but dangerous
+         *   - null: Just use JSON.stringify() function, without boosting
+         */
+                    "stringify": "assert"
                 }`));
             if (typia === undefined)
                 plugins.push(comment_json_1.default.parse(`{ "transform": "typia/lib/transform" }`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "5.3.0",
+  "version": "5.3.1",
   "description": "Nestia CLI tool",
   "main": "bin/index.js",
   "bin": {
@@ -41,7 +41,7 @@
     "@types/inquirer": "^9.0.3",
     "@types/node": "^18.11.16",
     "rimraf": "^3.0.2",
-    "typescript": "^5.4.2"
+    "typescript": "^5.5.2"
   },
   "files": [
     "bin",

package/src/NestiaSetupWizard.ts

@@ -1,73 +1,73 @@
-import { ArgumentParser } from "./internal/ArgumentParser";
-import { CommandExecutor } from "./internal/CommandExecutor";
-import { PackageManager } from "./internal/PackageManager";
-import { PluginConfigurator } from "./internal/PluginConfigurator";
-
-export namespace NestiaSetupWizard {
-  export async function setup(): Promise<void> {
-    console.log("----------------------------------------");
-    console.log(" Nestia Setup Wizard");
-    console.log("----------------------------------------");
-
-    // PREPARE ASSETS
-    const pack: PackageManager = await PackageManager.mount();
-    const args: ArgumentParser.IArguments = await ArgumentParser.parse(pack);
-
-    // INSTALL NESTIA
-    pack.install({ dev: false, modulo: "@nestia/core", version: "latest" });
-    pack.install({ dev: false, modulo: "@nestia/e2e", version: "latest" });
-    pack.install({ dev: false, modulo: "@nestia/fetcher", version: "latest" });
-    pack.install({ dev: true, modulo: "@nestia/sdk", version: "latest" });
-    pack.install({ dev: true, modulo: "nestia", version: "latest" });
-    pack.install({ dev: false, modulo: "typia" });
-
-    // INSTALL TYPESCRIPT COMPILERS
-    pack.install({ dev: true, modulo: "ts-patch", version: "latest" });
-    pack.install({ dev: true, modulo: "ts-node", version: "latest" });
-    pack.install({ dev: true, modulo: "typescript", version: "5.4.2" });
-    args.project ??= (() => {
-      const runner: string = pack.manager === "npm" ? "npx" : pack.manager;
-      CommandExecutor.run(`${runner} tsc --init`);
-      return (args.project = "tsconfig.json");
-    })();
-
-    // SETUP TRANSFORMER
-    await pack.save((data) => {
-      // COMPOSE PREPARE COMMAND
-      data.scripts ??= {};
-      if (
-        typeof data.scripts.prepare === "string" &&
-        data.scripts.prepare.trim().length
-      ) {
-        if (
-          data.scripts.prepare.indexOf("ts-patch install") === -1 &&
-          data.scripts.prepare.indexOf("typia patch") === -1
-        )
-          data.scripts.prepare =
-            "ts-patch install && typia patch && " + data.scripts.prepare;
-        else if (data.scripts.prepare.indexOf("ts-patch install") === -1)
-          data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
-        else if (data.scripts.prepare.indexOf("typia patch") === -1)
-          data.scripts.prepare = data.scripts.prepare.replace(
-            "ts-patch install",
-            "ts-patch install && typia patch",
-          );
-      } else data.scripts.prepare = "ts-patch install && typia patch";
-
-      // FOR OLDER VERSIONS
-      if (typeof data.scripts.postinstall === "string") {
-        data.scripts.postinstall = data.scripts.postinstall
-          .split("&&")
-          .map((str) => str.trim())
-          .filter((str) => str.indexOf("ts-patch install") === -1)
-          .join(" && ");
-        if (data.scripts.postinstall.length === 0)
-          delete data.scripts.postinstall;
-      }
-    });
-    CommandExecutor.run(`${pack.manager} run prepare`);
-
-    // CONFIGURE PLUGIN
-    await PluginConfigurator.configure(args);
-  }
-}
+import { ArgumentParser } from "./internal/ArgumentParser";
+import { CommandExecutor } from "./internal/CommandExecutor";
+import { PackageManager } from "./internal/PackageManager";
+import { PluginConfigurator } from "./internal/PluginConfigurator";
+
+export namespace NestiaSetupWizard {
+  export async function setup(): Promise<void> {
+    console.log("----------------------------------------");
+    console.log(" Nestia Setup Wizard");
+    console.log("----------------------------------------");
+
+    // PREPARE ASSETS
+    const pack: PackageManager = await PackageManager.mount();
+    const args: ArgumentParser.IArguments = await ArgumentParser.parse(pack);
+
+    // INSTALL NESTIA
+    pack.install({ dev: false, modulo: "@nestia/core", version: "latest" });
+    pack.install({ dev: false, modulo: "@nestia/e2e", version: "latest" });
+    pack.install({ dev: false, modulo: "@nestia/fetcher", version: "latest" });
+    pack.install({ dev: true, modulo: "@nestia/sdk", version: "latest" });
+    pack.install({ dev: true, modulo: "nestia", version: "latest" });
+    pack.install({ dev: false, modulo: "typia" });
+
+    // INSTALL TYPESCRIPT COMPILERS
+    pack.install({ dev: true, modulo: "ts-patch", version: "latest" });
+    pack.install({ dev: true, modulo: "ts-node", version: "latest" });
+    pack.install({ dev: true, modulo: "typescript", version: "5.5.2" });
+    args.project ??= (() => {
+      const runner: string = pack.manager === "npm" ? "npx" : pack.manager;
+      CommandExecutor.run(`${runner} tsc --init`);
+      return (args.project = "tsconfig.json");
+    })();
+
+    // SETUP TRANSFORMER
+    await pack.save((data) => {
+      // COMPOSE PREPARE COMMAND
+      data.scripts ??= {};
+      if (
+        typeof data.scripts.prepare === "string" &&
+        data.scripts.prepare.trim().length
+      ) {
+        if (
+          data.scripts.prepare.indexOf("ts-patch install") === -1 &&
+          data.scripts.prepare.indexOf("typia patch") === -1
+        )
+          data.scripts.prepare =
+            "ts-patch install && typia patch && " + data.scripts.prepare;
+        else if (data.scripts.prepare.indexOf("ts-patch install") === -1)
+          data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
+        else if (data.scripts.prepare.indexOf("typia patch") === -1)
+          data.scripts.prepare = data.scripts.prepare.replace(
+            "ts-patch install",
+            "ts-patch install && typia patch",
+          );
+      } else data.scripts.prepare = "ts-patch install && typia patch";
+
+      // FOR OLDER VERSIONS
+      if (typeof data.scripts.postinstall === "string") {
+        data.scripts.postinstall = data.scripts.postinstall
+          .split("&&")
+          .map((str) => str.trim())
+          .filter((str) => str.indexOf("ts-patch install") === -1)
+          .join(" && ");
+        if (data.scripts.postinstall.length === 0)
+          delete data.scripts.postinstall;
+      }
+    });
+    CommandExecutor.run(`${pack.manager} run prepare`);
+
+    // CONFIGURE PLUGIN
+    await PluginConfigurator.configure(args);
+  }
+}

package/src/internal/CommandExecutor.ts

@@ -1,8 +1,8 @@
-import cp from "child_process";
-
-export namespace CommandExecutor {
-  export function run(str: string): void {
-    console.log(`\n$ ${str}`);
-    cp.execSync(str, { stdio: "inherit" });
-  }
-}
+import cp from "child_process";
+
+export namespace CommandExecutor {
+  export function run(str: string): void {
+    console.log(`\n$ ${str}`);
+    cp.execSync(str, { stdio: "inherit" });
+  }
+}

package/src/internal/FileRetriever.ts

@@ -1,22 +1,22 @@
-import fs from "fs";
-import path from "path";
-
-export namespace FileRetriever {
-  export const directory =
-    (name: string) =>
-    (dir: string, depth: number = 0): string | null => {
-      const location: string = path.join(dir, name);
-      if (fs.existsSync(location)) return dir;
-      else if (depth > 2) return null;
-      return directory(name)(path.join(dir, ".."), depth + 1);
-    };
-
-  export const file =
-    (name: string) =>
-    (directory: string, depth: number = 0): string | null => {
-      const location: string = path.join(directory, name);
-      if (fs.existsSync(location)) return location;
-      else if (depth > 2) return null;
-      return file(name)(path.join(directory, ".."), depth + 1);
-    };
-}
+import fs from "fs";
+import path from "path";
+
+export namespace FileRetriever {
+  export const directory =
+    (name: string) =>
+    (dir: string, depth: number = 0): string | null => {
+      const location: string = path.join(dir, name);
+      if (fs.existsSync(location)) return dir;
+      else if (depth > 2) return null;
+      return directory(name)(path.join(dir, ".."), depth + 1);
+    };
+
+  export const file =
+    (name: string) =>
+    (directory: string, depth: number = 0): string | null => {
+      const location: string = path.join(directory, name);
+      if (fs.existsSync(location)) return location;
+      else if (depth > 2) return null;
+      return file(name)(path.join(directory, ".."), depth + 1);
+    };
+}

package/src/internal/PackageManager.ts

@@ -1,72 +1,72 @@
-import fs from "fs";
-import path from "path";
-
-import { CommandExecutor } from "./CommandExecutor";
-import { FileRetriever } from "./FileRetriever";
-
-export class PackageManager {
-  public manager: string = "npm";
-  public get file(): string {
-    return path.join(this.directory, "package.json");
-  }
-
-  public static async mount(): Promise<PackageManager> {
-    const location: string | null = await FileRetriever.directory(
-      "package.json",
-    )(process.cwd());
-    if (location === null)
-      throw new Error(`Unable to find "package.json" file`);
-
-    return new PackageManager(
-      location,
-      await this.load(path.join(location, "package.json")),
-    );
-  }
-
-  public async save(modifier: (data: Package.Data) => void): Promise<void> {
-    const content: string = await fs.promises.readFile(this.file, "utf8");
-    this.data = JSON.parse(content);
-    modifier(this.data);
-
-    return fs.promises.writeFile(
-      this.file,
-      JSON.stringify(this.data, null, 2),
-      "utf8",
-    );
-  }
-
-  public install(props: {
-    dev: boolean;
-    modulo: string;
-    version?: `latest` | `next` | `${number}.${number}.${number}`;
-    force?: boolean;
-  }): boolean {
-    const symbol: string =
-      this.manager === "yarn"
-        ? `add${props.dev ? " -D" : ""}`
-        : `install ${props.dev ? "--save-dev" : "--save"}`;
-    CommandExecutor.run(
-      `${this.manager} ${symbol}${props.force === true ? " --force" : ""} ${
-        props.modulo
-      }${props.version ? `@${props.version}` : ""}`,
-    );
-    return true;
-  }
-
-  private constructor(
-    public readonly directory: string,
-    public data: Package.Data,
-  ) {}
-
-  private static async load(file: string): Promise<Package.Data> {
-    const content: string = await fs.promises.readFile(file, "utf8");
-    return JSON.parse(content);
-  }
-}
-export namespace Package {
-  export interface Data {
-    scripts?: Record<string, string>;
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-  }
-}
+import fs from "fs";
+import path from "path";
+
+import { CommandExecutor } from "./CommandExecutor";
+import { FileRetriever } from "./FileRetriever";
+
+export class PackageManager {
+  public manager: string = "npm";
+  public get file(): string {
+    return path.join(this.directory, "package.json");
+  }
+
+  public static async mount(): Promise<PackageManager> {
+    const location: string | null = await FileRetriever.directory(
+      "package.json",
+    )(process.cwd());
+    if (location === null)
+      throw new Error(`Unable to find "package.json" file`);
+
+    return new PackageManager(
+      location,
+      await this.load(path.join(location, "package.json")),
+    );
+  }
+
+  public async save(modifier: (data: Package.Data) => void): Promise<void> {
+    const content: string = await fs.promises.readFile(this.file, "utf8");
+    this.data = JSON.parse(content);
+    modifier(this.data);
+
+    return fs.promises.writeFile(
+      this.file,
+      JSON.stringify(this.data, null, 2),
+      "utf8",
+    );
+  }
+
+  public install(props: {
+    dev: boolean;
+    modulo: string;
+    version?: `latest` | `next` | `${number}.${number}.${number}`;
+    force?: boolean;
+  }): boolean {
+    const symbol: string =
+      this.manager === "yarn"
+        ? `add${props.dev ? " -D" : ""}`
+        : `install ${props.dev ? "--save-dev" : "--save"}`;
+    CommandExecutor.run(
+      `${this.manager} ${symbol}${props.force === true ? " --force" : ""} ${
+        props.modulo
+      }${props.version ? `@${props.version}` : ""}`,
+    );
+    return true;
+  }
+
+  private constructor(
+    public readonly directory: string,
+    public data: Package.Data,
+  ) {}
+
+  private static async load(file: string): Promise<Package.Data> {
+    const content: string = await fs.promises.readFile(file, "utf8");
+    return JSON.parse(content);
+  }
+}
+export namespace Package {
+  export interface Data {
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+  }
+}

package/src/internal/PluginConfigurator.ts

@@ -1,106 +1,106 @@
-import comments from "comment-json";
-import fs from "fs";
-
-import { ArgumentParser } from "./ArgumentParser";
-
-export namespace PluginConfigurator {
-  export async function configure(
-    args: ArgumentParser.IArguments,
-  ): Promise<void> {
-    // GET COMPILER-OPTIONS
-    const config: comments.CommentObject = comments.parse(
-      await fs.promises.readFile(args.project!, "utf8"),
-    ) as comments.CommentObject;
-    const compilerOptions: comments.CommentObject | undefined =
-      config.compilerOptions as comments.CommentObject | undefined;
-    if (compilerOptions === undefined)
-      throw new Error(
-        `${args.project} file does not have "compilerOptions" property.`,
-      );
-
-    // PREPARE PLUGINS
-    const plugins: comments.CommentArray<comments.CommentObject> = (() => {
-      const plugins = compilerOptions.plugins as
-        | comments.CommentArray<comments.CommentObject>
-        | undefined;
-      if (plugins === undefined) return (compilerOptions.plugins = [] as any);
-      else if (!Array.isArray(plugins))
-        throw new Error(
-          `"plugins" property of ${args.project} must be array type.`,
-        );
-      return plugins;
-    })();
-
-    // CHECK WHETHER CONFIGURED
-    const strict: boolean | undefined = compilerOptions.strict as
-      | boolean
-      | undefined;
-    const strictNullChecks: boolean | undefined =
-      compilerOptions.strictNullChecks as boolean | undefined;
-    const core: comments.CommentObject | undefined = plugins.find(
-      (p) =>
-        typeof p === "object" &&
-        p !== null &&
-        p.transform === "@nestia/core/lib/transform",
-    );
-    const typia: comments.CommentObject | undefined = plugins.find(
-      (p) =>
-        typeof p === "object" &&
-        p !== null &&
-        p.transform === "typia/lib/transform",
-    );
-    if (
-      strictNullChecks !== false &&
-      (strict === true || strictNullChecks === true) &&
-      core !== undefined &&
-      typia !== undefined
-    )
-      return;
-
-    // DO CONFIGURE
-    compilerOptions.strictNullChecks = true;
-    if (strict === undefined && strictNullChecks === undefined)
-      compilerOptions.strict = true;
-    compilerOptions.experimentalDecorators = true;
-    compilerOptions.emitDecoratorMetadata = true;
-
-    if (core === undefined)
-      plugins.push(
-        comments.parse(`{
-                    "transform": "@nestia/core/lib/transform",
-        /**
-         * Validate request body.
-         * 
-         *   - "assert": Use typia.assert() function
-         *   - "is": Use typia.is() function
-         *   - "validate": Use typia.validate() function
-         *   - "assertEquals": Use typia.assertEquals() function
-         *   - "equals": Use typia.equals() function
-         *   - "validateEquals": Use typia.validateEquals() function
-         */
-                            "validate": "assert",
-
-        /**
-         * Validate JSON typed response body.
-         * 
-         *   - "assert": Use typia.assertStringify() function
-         *   - "is": Use typia.isStringify() function
-         *   - "validate": Use typia.validateStringify() function
-         *   - "stringify": Use typia.stringify() function, but dangerous
-         *   - null: Just use JSON.stringify() function, without boosting
-         */
-                    "stringify": "assert"
-                }`) as comments.CommentObject,
-      );
-    if (typia === undefined)
-      plugins.push(
-        comments.parse(
-          `{ "transform": "typia/lib/transform" }`,
-        ) as comments.CommentObject,
-      );
-    await fs.promises.writeFile(
-      args.project!,
-      comments.stringify(config, null, 2),
-    );
-  }
-}
+import comments from "comment-json";
+import fs from "fs";
+
+import { ArgumentParser } from "./ArgumentParser";
+
+export namespace PluginConfigurator {
+  export async function configure(
+    args: ArgumentParser.IArguments,
+  ): Promise<void> {
+    // GET COMPILER-OPTIONS
+    const config: comments.CommentObject = comments.parse(
+      await fs.promises.readFile(args.project!, "utf8"),
+    ) as comments.CommentObject;
+    const compilerOptions: comments.CommentObject | undefined =
+      config.compilerOptions as comments.CommentObject | undefined;
+    if (compilerOptions === undefined)
+      throw new Error(
+        `${args.project} file does not have "compilerOptions" property.`,
+      );
+
+    // PREPARE PLUGINS
+    const plugins: comments.CommentArray<comments.CommentObject> = (() => {
+      const plugins = compilerOptions.plugins as
+        | comments.CommentArray<comments.CommentObject>
+        | undefined;
+      if (plugins === undefined) return (compilerOptions.plugins = [] as any);
+      else if (!Array.isArray(plugins))
+        throw new Error(
+          `"plugins" property of ${args.project} must be array type.`,
+        );
+      return plugins;
+    })();
+
+    // CHECK WHETHER CONFIGURED
+    const strict: boolean | undefined = compilerOptions.strict as
+      | boolean
+      | undefined;
+    const strictNullChecks: boolean | undefined =
+      compilerOptions.strictNullChecks as boolean | undefined;
+    const core: comments.CommentObject | undefined = plugins.find(
+      (p) =>
+        typeof p === "object" &&
+        p !== null &&
+        p.transform === "@nestia/core/lib/transform",
+    );
+    const typia: comments.CommentObject | undefined = plugins.find(
+      (p) =>
+        typeof p === "object" &&
+        p !== null &&
+        p.transform === "typia/lib/transform",
+    );
+    if (
+      strictNullChecks !== false &&
+      (strict === true || strictNullChecks === true) &&
+      core !== undefined &&
+      typia !== undefined
+    )
+      return;
+
+    // DO CONFIGURE
+    compilerOptions.strictNullChecks = true;
+    if (strict === undefined && strictNullChecks === undefined)
+      compilerOptions.strict = true;
+    compilerOptions.experimentalDecorators = true;
+    compilerOptions.emitDecoratorMetadata = true;
+
+    if (core === undefined)
+      plugins.push(
+        comments.parse(`{
+                    "transform": "@nestia/core/lib/transform",
+        /**
+         * Validate request body.
+         * 
+         *   - "assert": Use typia.assert() function
+         *   - "is": Use typia.is() function
+         *   - "validate": Use typia.validate() function
+         *   - "assertEquals": Use typia.assertEquals() function
+         *   - "equals": Use typia.equals() function
+         *   - "validateEquals": Use typia.validateEquals() function
+         */
+                            "validate": "assert",
+
+        /**
+         * Validate JSON typed response body.
+         * 
+         *   - "assert": Use typia.assertStringify() function
+         *   - "is": Use typia.isStringify() function
+         *   - "validate": Use typia.validateStringify() function
+         *   - "stringify": Use typia.stringify() function, but dangerous
+         *   - null: Just use JSON.stringify() function, without boosting
+         */
+                    "stringify": "assert"
+                }`) as comments.CommentObject,
+      );
+    if (typia === undefined)
+      plugins.push(
+        comments.parse(
+          `{ "transform": "typia/lib/transform" }`,
+        ) as comments.CommentObject,
+      );
+    await fs.promises.writeFile(
+      args.project!,
+      comments.stringify(config, null, 2),
+    );
+  }
+}