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

package/src/index.ts

@@ -1,5 +1,5 @@
-import * as core from "./module";
-
-export * from "./module";
-
-export default core;
+import * as core from "./module";
+
+export * from "./module";
+
+export default core;

package/src/module.ts

@@ -1,23 +1,25 @@
-export * from "./decorators/DynamicModule";
-export * from "./utils/ExceptionManager";
-
-export * from "./decorators/HumanRoute";
-export * from "./decorators/TypedRoute";
-export * from "./decorators/TypedBody";
-export * from "./decorators/TypedQuery";
-export * from "./decorators/TypedException";
-export * from "./decorators/TypedHeaders";
-export * from "./decorators/TypedFormData";
-export * from "./decorators/TypedParam";
-
-export * from "./decorators/EncryptedController";
-export * from "./decorators/EncryptedRoute";
-export * from "./decorators/EncryptedBody";
-export * from "./decorators/EncryptedModule";
-export * from "./decorators/PlainBody";
-export * from "./decorators/SwaggerCustomizer";
-export * from "./decorators/SwaggerExample";
-
-export * from "./adaptors/WebSocketAdaptor";
-export * from "./decorators/WebSocketRoute";
-export * from "./decorators/doNotThrowTransformError";
+export * from "./decorators/DynamicModule";
+export * from "./utils/ExceptionManager";
+
+export * from "./decorators/HumanRoute";
+export * from "./decorators/TypedRoute";
+export * from "./decorators/TypedBody";
+export * from "./decorators/TypedQuery";
+export * from "./decorators/TypedException";
+export * from "./decorators/TypedHeaders";
+export * from "./decorators/TypedFormData";
+export * from "./decorators/TypedParam";
+
+export * from "./decorators/EncryptedController";
+export * from "./decorators/EncryptedRoute";
+export * from "./decorators/EncryptedBody";
+export * from "./decorators/EncryptedModule";
+export * from "./decorators/PlainBody";
+export * from "./decorators/SwaggerCustomizer";
+export * from "./decorators/SwaggerExample";
+
+export * from "./adaptors/WebSocketAdaptor";
+export * from "./decorators/WebSocketRoute";
+export * from "./adaptors/McpAdaptor";
+export * from "./decorators/McpRoute";
+export * from "./decorators/doNotThrowTransformError";

package/src/options/IRequestBodyValidator.ts

@@ -1,20 +1,20 @@
-import { IValidation } from "typia";
-
-export type IRequestBodyValidator<T> =
-  | IRequestBodyValidator.IAssert<T>
-  | IRequestBodyValidator.IIs<T>
-  | IRequestBodyValidator.IValidate<T>;
-export namespace IRequestBodyValidator {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: T) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: T) => boolean;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: T) => IValidation<T>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IRequestBodyValidator<T> =
+  | IRequestBodyValidator.IAssert<T>
+  | IRequestBodyValidator.IIs<T>
+  | IRequestBodyValidator.IValidate<T>;
+export namespace IRequestBodyValidator {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: T) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: T) => boolean;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: T) => IValidation<T>;
+  }
+}

package/src/options/IRequestFormDataProps.ts

@@ -1,27 +1,27 @@
-import { IValidation } from "typia";
-
-export interface IRequestFormDataProps<T> {
-  files: Array<IRequestFormDataProps.IFile>;
-  validator:
-    | IRequestFormDataProps.IAssert<T>
-    | IRequestFormDataProps.IIs<T>
-    | IRequestFormDataProps.IValidate<T>;
-}
-export namespace IRequestFormDataProps {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: FormData) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: FormData) => T | null;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: FormData) => IValidation<T>;
-  }
-  export interface IFile {
-    name: string;
-    limit: number | null;
-  }
-}
+import { IValidation } from "typia";
+
+export interface IRequestFormDataProps<T> {
+  files: Array<IRequestFormDataProps.IFile>;
+  validator:
+    | IRequestFormDataProps.IAssert<T>
+    | IRequestFormDataProps.IIs<T>
+    | IRequestFormDataProps.IValidate<T>;
+}
+export namespace IRequestFormDataProps {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: FormData) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: FormData) => T | null;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: FormData) => IValidation<T>;
+  }
+  export interface IFile {
+    name: string;
+    limit: number | null;
+  }
+}

package/src/options/IRequestHeadersValidator.ts

@@ -1,22 +1,22 @@
-import { IValidation } from "typia";
-
-export type IRequestHeadersValidator<T> =
-  | IRequestHeadersValidator.IAssert<T>
-  | IRequestHeadersValidator.IIs<T>
-  | IRequestHeadersValidator.IValidate<T>;
-export namespace IRequestHeadersValidator {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: Record<string, string | string[] | undefined>) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: Record<string, string | string[] | undefined>) => T | null;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (
-      input: Record<string, string | string[] | undefined>,
-    ) => IValidation<T>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IRequestHeadersValidator<T> =
+  | IRequestHeadersValidator.IAssert<T>
+  | IRequestHeadersValidator.IIs<T>
+  | IRequestHeadersValidator.IValidate<T>;
+export namespace IRequestHeadersValidator {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: Record<string, string | string[] | undefined>) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: Record<string, string | string[] | undefined>) => T | null;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (
+      input: Record<string, string | string[] | undefined>,
+    ) => IValidation<T>;
+  }
+}

package/src/options/IRequestQueryValidator.ts

@@ -1,20 +1,20 @@
-import { IValidation } from "typia";
-
-export type IRequestQueryValidator<T> =
-  | IRequestQueryValidator.IAssert<T>
-  | IRequestQueryValidator.IIs<T>
-  | IRequestQueryValidator.IValidate<T>;
-export namespace IRequestQueryValidator {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: URLSearchParams) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: URLSearchParams) => T | null;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: URLSearchParams) => IValidation<T>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IRequestQueryValidator<T> =
+  | IRequestQueryValidator.IAssert<T>
+  | IRequestQueryValidator.IIs<T>
+  | IRequestQueryValidator.IValidate<T>;
+export namespace IRequestQueryValidator {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: URLSearchParams) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: URLSearchParams) => T | null;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: URLSearchParams) => IValidation<T>;
+  }
+}

package/src/options/IResponseBodyQuerifier.ts

@@ -1,25 +1,25 @@
-import { IValidation } from "typia";
-
-export type IResponseBodyQuerifier<T> =
-  | IResponseBodyquerifier.IStringify<T>
-  | IResponseBodyquerifier.IIs<T>
-  | IResponseBodyquerifier.IAssert<T>
-  | IResponseBodyquerifier.IValidate<T>;
-export namespace IResponseBodyquerifier {
-  export interface IStringify<T> {
-    type: "stringify";
-    stringify: (input: T) => URLSearchParams;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: T) => URLSearchParams | null;
-  }
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: T) => URLSearchParams;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: T) => IValidation<URLSearchParams>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IResponseBodyQuerifier<T> =
+  | IResponseBodyquerifier.IStringify<T>
+  | IResponseBodyquerifier.IIs<T>
+  | IResponseBodyquerifier.IAssert<T>
+  | IResponseBodyquerifier.IValidate<T>;
+export namespace IResponseBodyquerifier {
+  export interface IStringify<T> {
+    type: "stringify";
+    stringify: (input: T) => URLSearchParams;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: T) => URLSearchParams | null;
+  }
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: T) => URLSearchParams;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: T) => IValidation<URLSearchParams>;
+  }
+}

package/src/options/IResponseBodyStringifier.ts

@@ -1,30 +1,30 @@
-import { IValidation } from "typia";
-
-export type IResponseBodyStringifier<T> =
-  | IResponseBodyStringifier.IStringify<T>
-  | IResponseBodyStringifier.IIs<T>
-  | IResponseBodyStringifier.IAssert<T>
-  | IResponseBodyStringifier.IValidate<T>
-  | IResponseBodyStringifier.IValidateLog<T>;
-export namespace IResponseBodyStringifier {
-  export interface IStringify<T> {
-    type: "stringify";
-    stringify: (input: T) => string;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: T) => string | null;
-  }
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: T) => string;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: T) => IValidation<string>;
-  }
-  export interface IValidateLog<T> {
-    type: "validate.log";
-    validate: (input: T) => IValidation<string>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IResponseBodyStringifier<T> =
+  | IResponseBodyStringifier.IStringify<T>
+  | IResponseBodyStringifier.IIs<T>
+  | IResponseBodyStringifier.IAssert<T>
+  | IResponseBodyStringifier.IValidate<T>
+  | IResponseBodyStringifier.IValidateLog<T>;
+export namespace IResponseBodyStringifier {
+  export interface IStringify<T> {
+    type: "stringify";
+    stringify: (input: T) => string;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: T) => string | null;
+  }
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: T) => string;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: T) => IValidation<string>;
+  }
+  export interface IValidateLog<T> {
+    type: "validate.log";
+    validate: (input: T) => IValidation<string>;
+  }
+}

package/src/transform.ts

@@ -1,101 +1,101 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-/** @internal */
-interface ITtscPluginFactoryContext {
-  projectRoot: string;
-}
-
-/** @internal */
-interface ITtscPlugin {
-  name: string;
-  source: string;
-  composes: string[];
-  contributors?: { name: string; source: string }[];
-}
-
-const filename: string = currentFilename();
-const dirname: string = path.dirname(filename);
-
-/**
- * `@nestia/core` ttsc plugin descriptor.
- *
- * `@nestia/sdk` is not a standalone plugin: its Go transform is declared here
- * as a `contributor` that ttsc statically links into this host binary, and
- * only when `@nestia/sdk` is actually resolvable from the project. A project
- * depending on `@nestia/core` alone never compiles any SDK transform code.
- */
-export function createTtscPlugin(
-  context: ITtscPluginFactoryContext,
-): ITtscPlugin {
-  const plugin: ITtscPlugin = {
-    name: "@nestia/core",
-    source: path.resolve(root(context), "native", "cmd", "ttsc-nestia"),
-    composes: ["typia/lib/transform"],
-  };
-  const sdk: string | null = resolveSdkContributorSource(context);
-  if (sdk !== null) plugin.contributors = [{ name: "sdk", source: sdk }];
-  return plugin;
-}
-export default createTtscPlugin;
-
-function root(context: ITtscPluginFactoryContext): string {
-  return (
-    resolvePackageRoot("@nestia/core/package.json", context.projectRoot) ??
-    path.resolve(dirname, "..")
-  );
-}
-
-function resolveSdkContributorSource(
-  context: ITtscPluginFactoryContext,
-): string | null {
-  const manifest: string | null = resolvePackageRoot(
-    "@nestia/sdk/package.json",
-    context.projectRoot,
-  );
-  if (manifest === null) return null;
-  const source: string = path.resolve(manifest, "native", "sdk");
-  return fs.existsSync(source) ? source : null;
-}
-
-function resolvePackageRoot(
-  packageJson: string,
-  projectRoot: string,
-): string | null {
-  try {
-    return path.dirname(
-      require.resolve(packageJson, { paths: [dirname, projectRoot] }),
-    );
-  } catch {
-    return null;
-  }
-}
-
-function currentFilename(): string {
-  if (
-    typeof __filename === "string" &&
-    __filename !== "[stdin]" &&
-    __filename.length !== 0
-  )
-    return normalizeFilename(__filename);
-
-  const line: string | undefined = new Error().stack
-    ?.split("\n")
-    .find(
-      (entry) =>
-        entry.includes("/src/transform.ts") ||
-        entry.includes("/lib/transform.js") ||
-        entry.includes("/lib/transform.mjs"),
-    );
-  const matched: RegExpMatchArray | null | undefined = line?.match(
-    /\(([^()]+):\d+:\d+\)|at ([^\s()]+):\d+:\d+/,
-  );
-  const fallback: string = typeof __filename === "string" ? __filename : "";
-  return normalizeFilename(matched?.[1] ?? matched?.[2] ?? fallback);
-}
-
-function normalizeFilename(value: string): string {
-  if (value.startsWith("file:")) return fileURLToPath(value);
-  return value;
-}
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+/** @internal */
+interface ITtscPluginFactoryContext {
+  projectRoot: string;
+}
+
+/** @internal */
+interface ITtscPlugin {
+  name: string;
+  source: string;
+  composes: string[];
+  contributors?: { name: string; source: string }[];
+}
+
+const filename: string = currentFilename();
+const dirname: string = path.dirname(filename);
+
+/**
+ * `@nestia/core` ttsc plugin descriptor.
+ *
+ * `@nestia/sdk` is not a standalone plugin: its Go transform is declared here
+ * as a `contributor` that ttsc statically links into this host binary, and
+ * only when `@nestia/sdk` is actually resolvable from the project. A project
+ * depending on `@nestia/core` alone never compiles any SDK transform code.
+ */
+export function createTtscPlugin(
+  context: ITtscPluginFactoryContext,
+): ITtscPlugin {
+  const plugin: ITtscPlugin = {
+    name: "@nestia/core",
+    source: path.resolve(root(context), "native", "cmd", "ttsc-nestia"),
+    composes: ["typia/lib/transform"],
+  };
+  const sdk: string | null = resolveSdkContributorSource(context);
+  if (sdk !== null) plugin.contributors = [{ name: "sdk", source: sdk }];
+  return plugin;
+}
+export default createTtscPlugin;
+
+function root(context: ITtscPluginFactoryContext): string {
+  return (
+    resolvePackageRoot("@nestia/core/package.json", context.projectRoot) ??
+    path.resolve(dirname, "..")
+  );
+}
+
+function resolveSdkContributorSource(
+  context: ITtscPluginFactoryContext,
+): string | null {
+  const manifest: string | null = resolvePackageRoot(
+    "@nestia/sdk/package.json",
+    context.projectRoot,
+  );
+  if (manifest === null) return null;
+  const source: string = path.resolve(manifest, "native", "sdk");
+  return fs.existsSync(source) ? source : null;
+}
+
+function resolvePackageRoot(
+  packageJson: string,
+  projectRoot: string,
+): string | null {
+  try {
+    return path.dirname(
+      require.resolve(packageJson, { paths: [dirname, projectRoot] }),
+    );
+  } catch {
+    return null;
+  }
+}
+
+function currentFilename(): string {
+  if (
+    typeof __filename === "string" &&
+    __filename !== "[stdin]" &&
+    __filename.length !== 0
+  )
+    return normalizeFilename(__filename);
+
+  const line: string | undefined = new Error().stack
+    ?.split("\n")
+    .find(
+      (entry) =>
+        entry.includes("/src/transform.ts") ||
+        entry.includes("/lib/transform.js") ||
+        entry.includes("/lib/transform.mjs"),
+    );
+  const matched: RegExpMatchArray | null | undefined = line?.match(
+    /\(([^()]+):\d+:\d+\)|at ([^\s()]+):\d+:\d+/,
+  );
+  const fallback: string = typeof __filename === "string" ? __filename : "";
+  return normalizeFilename(matched?.[1] ?? matched?.[2] ?? fallback);
+}
+
+function normalizeFilename(value: string): string {
+  if (value.startsWith("file:")) return fileURLToPath(value);
+  return value;
+}

package/src/typings/Creator.ts

@@ -1,3 +1,3 @@
-export type Creator<T extends object> = {
-  new (...args: any[]): T;
-};
+export type Creator<T extends object> = {
+  new (...args: any[]): T;
+};

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,7 +1,7 @@
-export namespace ArrayUtil {
-  export function has<T>(array: T[], ...items: T[]): boolean {
-    return items.every(
-      (elem) => array.find((org) => org === elem) !== undefined,
-    );
-  }
-}
+export namespace ArrayUtil {
+  export function has<T>(array: T[], ...items: T[]): boolean {
+    return items.every(
+      (elem) => array.find((org) => org === elem) !== undefined,
+    );
+  }
+}