@nestia/sdk 11.0.0-dev.20260313-4 → 11.0.0-dev.20260316

package/src/structures/TypeEntry.ts

@@ -1,22 +1,22 @@
-import { hash } from "tstl";
-import ts from "typescript";
-
-export class TypeEntry {
-  public constructor(
-    public readonly type: ts.Type,
-    public readonly nullable: boolean,
-    public readonly required: boolean,
-  ) {}
-
-  public equals(obj: TypeEntry): boolean {
-    return (
-      this.type === obj.type &&
-      this.nullable === obj.nullable &&
-      this.required === obj.required
-    );
-  }
-
-  public hashCode(): number {
-    return hash(this.type, this.nullable, this.required);
-  }
-}
+import { hash } from "tstl";
+import ts from "typescript";
+
+export class TypeEntry {
+  public constructor(
+    public readonly type: ts.Type,
+    public readonly nullable: boolean,
+    public readonly required: boolean,
+  ) {}
+
+  public equals(obj: TypeEntry): boolean {
+    return (
+      this.type === obj.type &&
+      this.nullable === obj.nullable &&
+      this.required === obj.required
+    );
+  }
+
+  public hashCode(): number {
+    return hash(this.type, this.nullable, this.required);
+  }
+}

package/src/transform.ts

@@ -1,9 +1,9 @@
-import ts from "typescript";
-
-import { SdkOperationTransformer } from "./transformers/SdkOperationTransformer";
-
-export const transform = (
-  program: ts.Program,
-): ts.TransformerFactory<ts.SourceFile> =>
-  SdkOperationTransformer.iterateFile(program.getTypeChecker());
-export default transform;
+import ts from "typescript";
+
+import { SdkOperationTransformer } from "./transformers/SdkOperationTransformer";
+
+export const transform = (
+  program: ts.Program,
+): ts.TransformerFactory<ts.SourceFile> =>
+  SdkOperationTransformer.iterateFile(program.getTypeChecker());
+export default transform;

package/src/transformers/TextPlainValidator.ts

@@ -1,16 +1,16 @@
 import { MetadataSchema } from "@typia/core";
 
 export namespace TextPlainValidator {
-  export const validate = (metadata: MetadataSchema): string[] => {
+  export const validate = (props: { metadata: MetadataSchema }): string[] => {
     const expected: number =
-      metadata.atomics.filter((a) => a.type === "string").length +
-      metadata.constants
+      props.metadata.atomics.filter((a) => a.type === "string").length +
+      props.metadata.constants
         .filter((c) => c.type === "string")
         .map((c) => c.values.length)
         .reduce((a, b) => a + b, 0) +
-      metadata.templates.length +
-      metadata.natives.filter((n) => n.name === "String").length;
-    if (metadata.size() === 0 || metadata.size() !== expected)
+      props.metadata.templates.length +
+      props.metadata.natives.filter((n) => n.name === "String").length;
+    if (props.metadata.size() === 0 || props.metadata.size() !== expected)
       return [`Only string type is allowed in the "text/plain" content type.`];
     return [];
   };

package/src/typings/get-function-location.d.ts

@@ -1,7 +1,7 @@
-declare module "get-function-location" {
-  export default function (func: any): Promise<{
-    source: string;
-    line: number;
-    column: number;
-  }>;
-}
+declare module "get-function-location" {
+  export default function (func: any): Promise<{
+    source: string;
+    line: number;
+    column: number;
+  }>;
+}

package/src/utils/ArrayUtil.ts

@@ -1,26 +1,26 @@
-export namespace ArrayUtil {
-  export function has<T>(array: T[], ...items: T[]): boolean {
-    return items.every(
-      (elem) => array.find((org) => org === elem) !== undefined,
-    );
-  }
-
-  export async function asyncMap<X, Y>(
-    array: X[],
-    closure: (input: X) => Promise<Y>,
-  ): Promise<Y[]> {
-    const ret: Y[] = [];
-    for (const elem of array) ret.push(await closure(elem));
-    return ret;
-  }
-
-  export async function asyncFilter<T>(
-    array: T[],
-    closure: (input: T) => Promise<boolean>,
-  ): Promise<T[]> {
-    const ret: T[] = [];
-    for (const elem of array)
-      if ((await closure(elem)) === true) ret.push(elem);
-    return ret;
-  }
-}
+export namespace ArrayUtil {
+  export function has<T>(array: T[], ...items: T[]): boolean {
+    return items.every(
+      (elem) => array.find((org) => org === elem) !== undefined,
+    );
+  }
+
+  export async function asyncMap<X, Y>(
+    array: X[],
+    closure: (input: X) => Promise<Y>,
+  ): Promise<Y[]> {
+    const ret: Y[] = [];
+    for (const elem of array) ret.push(await closure(elem));
+    return ret;
+  }
+
+  export async function asyncFilter<T>(
+    array: T[],
+    closure: (input: T) => Promise<boolean>,
+  ): Promise<T[]> {
+    const ret: T[] = [];
+    for (const elem of array)
+      if ((await closure(elem)) === true) ret.push(elem);
+    return ret;
+  }
+}

package/src/utils/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/utils/MapUtil.ts

@@ -1,14 +1,14 @@
-export namespace MapUtil {
-  export function take<Key, T>(
-    dict: Map<Key, T>,
-    key: Key,
-    generator: () => T,
-  ): T {
-    const oldbie: T | undefined = dict.get(key);
-    if (oldbie) return oldbie;
-
-    const value: T = generator();
-    dict.set(key, value);
-    return value;
-  }
-}
+export namespace MapUtil {
+  export function take<Key, T>(
+    dict: Map<Key, T>,
+    key: Key,
+    generator: () => T,
+  ): T {
+    const oldbie: T | undefined = dict.get(key);
+    if (oldbie) return oldbie;
+
+    const value: T = generator();
+    dict.set(key, value);
+    return value;
+  }
+}

package/src/utils/PathUtil.ts

@@ -1,10 +1,10 @@
-export namespace PathUtil {
-  export const accessors = (path: string) =>
-    path
-      .split("/")
-      .filter((str) => str.length && str[0] !== ":")
-      .map(normalize);
-
-  const normalize = (str: string) =>
-    str.split("-").join("_").split(".").join("_");
-}
+export namespace PathUtil {
+  export const accessors = (path: string) =>
+    path
+      .split("/")
+      .filter((str) => str.length && str[0] !== ":")
+      .map(normalize);
+
+  const normalize = (str: string) =>
+    str.split("-").join("_").split(".").join("_");
+}

package/src/utils/SourceFinder.ts

@@ -1,63 +1,63 @@
-import fs from "fs";
-import { glob } from "glob";
-import path from "path";
-
-export namespace SourceFinder {
-  interface IProps {
-    exclude?: string[];
-    include: string[];
-    filter: (location: string) => Promise<boolean>;
-  }
-
-  export const find = async (props: IProps): Promise<string[]> => {
-    const dict: Set<string> = new Set();
-
-    await emplace(props.filter)(props.include)((str) => dict.add(str));
-    if (props.exclude?.length)
-      await emplace(props.filter)(props.exclude)((str) => dict.delete(str));
-
-    return [...dict];
-  };
-
-  const emplace =
-    (filter: (file: string) => Promise<boolean>) =>
-    (input: string[]) =>
-    async (closure: (location: string) => void): Promise<void> => {
-      for (const pattern of input) {
-        if (_Is_file(pattern)) {
-          closure(path.resolve(pattern));
-          continue;
-        }
-        for (const file of await _Glob(pattern)) {
-          const stats: fs.Stats = await fs.promises.stat(file);
-          if (stats.isDirectory() === true)
-            await iterate(filter)(closure)(file);
-          else if (stats.isFile() && (await filter(file))) closure(file);
-        }
-      }
-    };
-
-  const iterate =
-    (filter: (location: string) => Promise<boolean>) =>
-    (closure: (location: string) => void) =>
-    async (location: string): Promise<void> => {
-      const directory: string[] = await fs.promises.readdir(location);
-      for (const file of directory) {
-        const next: string = path.resolve(`${location}/${file}`);
-        const stats: fs.Stats = await fs.promises.stat(next);
-
-        if (stats.isDirectory() === true) await iterate(filter)(closure)(next);
-        else if (stats.isFile() && (await filter(next))) closure(next);
-      }
-    };
-
-  const _Glob = async (pattern: string): Promise<string[]> => {
-    const matches = await glob(pattern);
-    return matches.map((str) => path.resolve(str));
-  };
-
-  const _Is_file = (pattern: string): boolean =>
-    pattern.endsWith(".ts") &&
-    !pattern.endsWith(".d.ts") &&
-    fs.existsSync(pattern);
-}
+import fs from "fs";
+import { glob } from "glob";
+import path from "path";
+
+export namespace SourceFinder {
+  interface IProps {
+    exclude?: string[];
+    include: string[];
+    filter: (location: string) => Promise<boolean>;
+  }
+
+  export const find = async (props: IProps): Promise<string[]> => {
+    const dict: Set<string> = new Set();
+
+    await emplace(props.filter)(props.include)((str) => dict.add(str));
+    if (props.exclude?.length)
+      await emplace(props.filter)(props.exclude)((str) => dict.delete(str));
+
+    return [...dict];
+  };
+
+  const emplace =
+    (filter: (file: string) => Promise<boolean>) =>
+    (input: string[]) =>
+    async (closure: (location: string) => void): Promise<void> => {
+      for (const pattern of input) {
+        if (_Is_file(pattern)) {
+          closure(path.resolve(pattern));
+          continue;
+        }
+        for (const file of await _Glob(pattern)) {
+          const stats: fs.Stats = await fs.promises.stat(file);
+          if (stats.isDirectory() === true)
+            await iterate(filter)(closure)(file);
+          else if (stats.isFile() && (await filter(file))) closure(file);
+        }
+      }
+    };
+
+  const iterate =
+    (filter: (location: string) => Promise<boolean>) =>
+    (closure: (location: string) => void) =>
+    async (location: string): Promise<void> => {
+      const directory: string[] = await fs.promises.readdir(location);
+      for (const file of directory) {
+        const next: string = path.resolve(`${location}/${file}`);
+        const stats: fs.Stats = await fs.promises.stat(next);
+
+        if (stats.isDirectory() === true) await iterate(filter)(closure)(next);
+        else if (stats.isFile() && (await filter(next))) closure(next);
+      }
+    };
+
+  const _Glob = async (pattern: string): Promise<string[]> => {
+    const matches = await glob(pattern);
+    return matches.map((str) => path.resolve(str));
+  };
+
+  const _Is_file = (pattern: string): boolean =>
+    pattern.endsWith(".ts") &&
+    !pattern.endsWith(".d.ts") &&
+    fs.existsSync(pattern);
+}

package/src/utils/StringUtil.ts

@@ -1,17 +1,17 @@
-export namespace StringUtil {
-  export const capitalize = (text: string): string =>
-    text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();
-
-  export const escapeDuplicate =
-    (keep: string[]) =>
-    (change: string): string =>
-      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
-
-  export const isImplicit = (str: string) =>
-    str === "object" ||
-    str === "__type" ||
-    str === "__object" ||
-    str.startsWith("__type.") ||
-    str.startsWith("__object.") ||
-    str.includes("readonly [");
-}
+export namespace StringUtil {
+  export const capitalize = (text: string): string =>
+    text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();
+
+  export const escapeDuplicate =
+    (keep: string[]) =>
+    (change: string): string =>
+      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
+
+  export const isImplicit = (str: string) =>
+    str === "object" ||
+    str === "__type" ||
+    str === "__object" ||
+    str.startsWith("__type.") ||
+    str.startsWith("__object.") ||
+    str.includes("readonly [");
+}

package/src/utils/StripEnums.ts

@@ -1,5 +1,5 @@
-export type StripEnums<T extends Record<string, any>> = {
-  [Key in keyof T]: T[Key] extends string | boolean | object | undefined | any[]
-    ? T[Key]
-    : any;
-};
+export type StripEnums<T extends Record<string, any>> = {
+  [Key in keyof T]: T[Key] extends string | boolean | object | undefined | any[]
+    ? T[Key]
+    : any;
+};

package/src/utils/VersioningStrategy.ts

@@ -1,28 +1,28 @@
-import { VERSION_NEUTRAL, VersionValue } from "@nestjs/common/interfaces";
-
-import { INestiaProject } from "../structures/INestiaProject";
-
-export namespace VersioningStrategy {
-  export const cast = (
-    value: VersionValue | undefined,
-  ): Array<string | typeof VERSION_NEUTRAL> =>
-    value === undefined ? [] : Array.isArray(value) ? value : [value];
-
-  export const merge =
-    (project: Omit<INestiaProject, "config">) =>
-    (values: Array<string | typeof VERSION_NEUTRAL>): string[] => {
-      if (project.input.versioning === undefined) return [""];
-      const set: Set<string | typeof VERSION_NEUTRAL> = new Set(values);
-      const array: Array<string | typeof VERSION_NEUTRAL> =
-        set.size === 0
-          ? cast(project.input.versioning?.defaultVersion)
-          : Array.from(set);
-      return !!array?.length
-        ? array.map((x) =>
-            typeof x === "symbol"
-              ? ""
-              : `${project.input.versioning!.prefix}${x}`,
-          )
-        : [];
-    };
-}
+import { VERSION_NEUTRAL, VersionValue } from "@nestjs/common/interfaces";
+
+import { INestiaProject } from "../structures/INestiaProject";
+
+export namespace VersioningStrategy {
+  export const cast = (
+    value: VersionValue | undefined,
+  ): Array<string | typeof VERSION_NEUTRAL> =>
+    value === undefined ? [] : Array.isArray(value) ? value : [value];
+
+  export const merge =
+    (project: Omit<INestiaProject, "config">) =>
+    (values: Array<string | typeof VERSION_NEUTRAL>): string[] => {
+      if (project.input.versioning === undefined) return [""];
+      const set: Set<string | typeof VERSION_NEUTRAL> = new Set(values);
+      const array: Array<string | typeof VERSION_NEUTRAL> =
+        set.size === 0
+          ? cast(project.input.versioning?.defaultVersion)
+          : Array.from(set);
+      return !!array?.length
+        ? array.map((x) =>
+            typeof x === "symbol"
+              ? ""
+              : `${project.input.versioning!.prefix}${x}`,
+          )
+        : [];
+    };
+}

package/src/validators/HttpHeadersValidator.ts

@@ -5,30 +5,34 @@ import {
 } from "@typia/core";
 
 export namespace HttpHeadersValidator {
-  export const validate = (
-    meta: MetadataSchema,
-    explore: MetadataFactory.IExplore,
-  ): string[] => {
+  export const validate = (props: {
+    metadata: MetadataSchema;
+    explore: MetadataFactory.IExplore;
+  }): string[] => {
     const errors: string[] = [];
     const insert = (msg: string) => errors.push(msg);
 
-    if (explore.top === true) {
+    if (props.explore.top === true) {
       const expected: number =
-        meta.atomics.length +
-        meta.templates.length +
-        meta.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0) +
-        meta.arrays.length;
-      if (meta.size() !== expected)
+        props.metadata.atomics.length +
+        props.metadata.templates.length +
+        props.metadata.constants
+          .map((c) => c.values.length)
+          .reduce((a, b) => a + b, 0) +
+        props.metadata.arrays.length;
+      if (props.metadata.size() !== expected)
         insert("Only atomic or array of atomic types are allowed.");
     } else if (
-      explore.nested !== null &&
-      explore.nested instanceof MetadataArrayType
+      props.explore.nested !== null &&
+      props.explore.nested instanceof MetadataArrayType
     ) {
       const expected: number =
-        meta.atomics.length +
-        meta.templates.length +
-        meta.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0);
-      if (meta.size() !== expected)
+        props.metadata.atomics.length +
+        props.metadata.templates.length +
+        props.metadata.constants
+          .map((c) => c.values.length)
+          .reduce((a, b) => a + b, 0);
+      if (props.metadata.size() !== expected)
         insert("Only atomic types are allowed in array.");
     }
     return errors;

package/src/validators/HttpQueryValidator.ts

@@ -5,30 +5,34 @@ import {
 } from "@typia/core";
 
 export namespace HttpQueryValidator {
-  export const validate = (
-    meta: MetadataSchema,
-    explore: MetadataFactory.IExplore,
-  ): string[] => {
+  export const validate = (props: {
+    metadata: MetadataSchema;
+    explore: MetadataFactory.IExplore;
+  }): string[] => {
     const errors: string[] = [];
     const insert = (msg: string) => errors.push(msg);
 
-    if (explore.top === true) {
+    if (props.explore.top === true) {
       const expected: number =
-        meta.atomics.length +
-        meta.templates.length +
-        meta.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0) +
-        meta.arrays.length;
-      if (meta.size() !== expected)
+        props.metadata.atomics.length +
+        props.metadata.templates.length +
+        props.metadata.constants
+          .map((c) => c.values.length)
+          .reduce((a, b) => a + b, 0) +
+        props.metadata.arrays.length;
+      if (props.metadata.size() !== expected)
         insert("Only atomic or array of atomic types are allowed.");
     } else if (
-      explore.nested !== null &&
-      explore.nested instanceof MetadataArrayType
+      props.explore.nested !== null &&
+      props.explore.nested instanceof MetadataArrayType
     ) {
       const expected: number =
-        meta.atomics.length +
-        meta.templates.length +
-        meta.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0);
-      if (meta.size() !== expected)
+        props.metadata.atomics.length +
+        props.metadata.templates.length +
+        props.metadata.constants
+          .map((c) => c.values.length)
+          .reduce((a, b) => a + b, 0);
+      if (props.metadata.size() !== expected)
         insert("Only atomic types are allowed in array.");
     }
     return errors;