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

package/src/decorators/internal/get_path_and_querify.ts

@@ -1,94 +1,94 @@
-import { InternalServerErrorException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IResponseBodyQuerifier } from "../../options/IResponseBodyQuerifier";
-import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
-
-/** @internal */
-export const get_path_and_querify =
-  (method: string) =>
-  (
-    ...args: any[]
-  ): [string | string[] | undefined, (input: any) => URLSearchParams] => {
-    const path: string | string[] | null | undefined =
-      args[0] === undefined ||
-      typeof args[0] === "string" ||
-      Array.isArray(args[0])
-        ? args[0]
-        : null;
-    const functor: IResponseBodyQuerifier<any> | undefined =
-      path === null ? args[0] : args[1];
-    return [path ?? undefined, take(method)(functor)];
-  };
-
-/** @internal */
-const take =
-  (method: string) =>
-  <T>(functor?: IResponseBodyQuerifier<T> | null) => {
-    if (functor === undefined) {
-      NoTransformConfigurationError(method);
-      return querify;
-    } else if (functor === null) return querify;
-    else if (functor.type === "stringify") return functor.stringify;
-    else if (functor.type === "assert") return assert(functor.assert);
-    else if (functor.type === "is") return is(functor.is);
-    else if (functor.type === "validate") return validate(functor.validate);
-    throw new Error(
-      `Error on nestia.core.${method}(): invalid typed stringify function.`,
-    );
-  };
-
-/** @internal */
-const querify = (input: Record<string, any>): URLSearchParams => {
-  const output: URLSearchParams = new URLSearchParams();
-  for (const [key, value] of Object.entries(input))
-    if (key === undefined) continue;
-    else if (Array.isArray(value))
-      for (const elem of value) output.append(key, String(elem));
-    else output.append(key, String(value));
-  return output;
-};
-
-/** @internal */
-const assert =
-  <T>(closure: (data: T) => URLSearchParams) =>
-  (data: T) => {
-    try {
-      return closure(data);
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp))
-        throw new InternalServerErrorException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: MESSAGE,
-        });
-      throw exp;
-    }
-  };
-
-/** @internal */
-const is =
-  <T>(closure: (data: T) => URLSearchParams | null) =>
-  (data: T) => {
-    const result: URLSearchParams | null = closure(data);
-    if (result === null) throw new InternalServerErrorException(MESSAGE);
-    return result;
-  };
-
-/** @internal */
-const validate =
-  <T>(closure: (data: T) => IValidation<URLSearchParams>) =>
-  (data: T) => {
-    const result: IValidation<URLSearchParams> = closure(data);
-    if (result.success === false)
-      throw new InternalServerErrorException({
-        errors: result.errors,
-        message: MESSAGE,
-      });
-    return result.data;
-  };
-
-/** @internal */
-const MESSAGE = "Response body data is not following the promised type.";
+import { InternalServerErrorException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IResponseBodyQuerifier } from "../../options/IResponseBodyQuerifier";
+import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
+
+/** @internal */
+export const get_path_and_querify =
+  (method: string) =>
+  (
+    ...args: any[]
+  ): [string | string[] | undefined, (input: any) => URLSearchParams] => {
+    const path: string | string[] | null | undefined =
+      args[0] === undefined ||
+      typeof args[0] === "string" ||
+      Array.isArray(args[0])
+        ? args[0]
+        : null;
+    const functor: IResponseBodyQuerifier<any> | undefined =
+      path === null ? args[0] : args[1];
+    return [path ?? undefined, take(method)(functor)];
+  };
+
+/** @internal */
+const take =
+  (method: string) =>
+  <T>(functor?: IResponseBodyQuerifier<T> | null) => {
+    if (functor === undefined) {
+      NoTransformConfigurationError(method);
+      return querify;
+    } else if (functor === null) return querify;
+    else if (functor.type === "stringify") return functor.stringify;
+    else if (functor.type === "assert") return assert(functor.assert);
+    else if (functor.type === "is") return is(functor.is);
+    else if (functor.type === "validate") return validate(functor.validate);
+    throw new Error(
+      `Error on nestia.core.${method}(): invalid typed stringify function.`,
+    );
+  };
+
+/** @internal */
+const querify = (input: Record<string, any>): URLSearchParams => {
+  const output: URLSearchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(input))
+    if (key === undefined) continue;
+    else if (Array.isArray(value))
+      for (const elem of value) output.append(key, String(elem));
+    else output.append(key, String(value));
+  return output;
+};
+
+/** @internal */
+const assert =
+  <T>(closure: (data: T) => URLSearchParams) =>
+  (data: T) => {
+    try {
+      return closure(data);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp))
+        throw new InternalServerErrorException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      throw exp;
+    }
+  };
+
+/** @internal */
+const is =
+  <T>(closure: (data: T) => URLSearchParams | null) =>
+  (data: T) => {
+    const result: URLSearchParams | null = closure(data);
+    if (result === null) throw new InternalServerErrorException(MESSAGE);
+    return result;
+  };
+
+/** @internal */
+const validate =
+  <T>(closure: (data: T) => IValidation<URLSearchParams>) =>
+  (data: T) => {
+    const result: IValidation<URLSearchParams> = closure(data);
+    if (result.success === false)
+      throw new InternalServerErrorException({
+        errors: result.errors,
+        message: MESSAGE,
+      });
+    return result.data;
+  };
+
+/** @internal */
+const MESSAGE = "Response body data is not following the promised type.";

package/src/decorators/internal/get_path_and_stringify.ts

@@ -1,110 +1,110 @@
-import { InternalServerErrorException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier";
-import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
-import { TypedRoute } from "../TypedRoute";
-
-/** @internal */
-export const get_path_and_stringify =
-  (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
-  (method: string) =>
-  (
-    ...args: any[]
-  ): [
-    string | string[] | undefined,
-    (input: any, _method: string, _path: string) => string,
-  ] => {
-    const path: string | string[] | null | undefined =
-      args[0] === undefined ||
-      typeof args[0] === "string" ||
-      Array.isArray(args[0])
-        ? args[0]
-        : null;
-    const functor: IResponseBodyStringifier<any> | undefined =
-      path === null ? args[0] : args[1];
-    return [path ?? undefined, take(logger)(method)(functor)];
-  };
-
-/** @internal */
-const take =
-  (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
-  (method: string) =>
-  <T>(functor?: IResponseBodyStringifier<T> | null) => {
-    if (functor === undefined) {
-      NoTransformConfigurationError(method);
-      return (input: T, _method: string, _path: string) =>
-        JSON.stringify(input);
-    } else if (functor === null)
-      return (input: T, _method: string, _path: string) =>
-        JSON.stringify(input);
-    else if (functor.type === "stringify") return functor.stringify;
-    else if (functor.type === "assert") return assert(functor.assert);
-    else if (functor.type === "is") return is(functor.is);
-    else if (functor.type === "validate") return validate(functor.validate);
-    else if (functor.type === "validate.log")
-      return validateLog(logger)(functor.validate);
-    throw new Error(
-      `Error on nestia.core.${method}(): invalid typed stringify function.`,
-    );
-  };
-
-/** @internal */
-const assert =
-  <T>(closure: (data: T) => string) =>
-  (data: T): string => {
-    try {
-      return closure(data);
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp))
-        throw new InternalServerErrorException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: MESSAGE,
-        });
-      throw exp;
-    }
-  };
-
-/** @internal */
-const is =
-  <T>(closure: (data: T) => string | null) =>
-  (data: T, _method: string, _path: string) => {
-    const result: string | null = closure(data);
-    if (result === null) throw new InternalServerErrorException(MESSAGE);
-    return result;
-  };
-
-/** @internal */
-const validate =
-  <T>(closure: (data: T) => IValidation<string>) =>
-  (data: T, _method: string, _path: string): string => {
-    const result: IValidation<string> = closure(data);
-    if (result.success === false)
-      throw new InternalServerErrorException({
-        errors: result.errors,
-        message: MESSAGE,
-      });
-    return result.data;
-  };
-
-const validateLog =
-  (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
-  <T>(closure: (data: T) => IValidation<any>) =>
-  (data: T, method: string, path: string): string => {
-    const result: IValidation<string> = closure(data);
-    if (result.success === true) return result.data;
-    if (result.success === false)
-      logger()({
-        errors: result.errors,
-        method,
-        path,
-        data,
-      });
-    return JSON.stringify(data);
-  };
-
-/** @internal */
-const MESSAGE = "Response body data is not following the promised type.";
+import { InternalServerErrorException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier";
+import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
+import { TypedRoute } from "../TypedRoute";
+
+/** @internal */
+export const get_path_and_stringify =
+  (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
+  (method: string) =>
+  (
+    ...args: any[]
+  ): [
+    string | string[] | undefined,
+    (input: any, _method: string, _path: string) => string,
+  ] => {
+    const path: string | string[] | null | undefined =
+      args[0] === undefined ||
+      typeof args[0] === "string" ||
+      Array.isArray(args[0])
+        ? args[0]
+        : null;
+    const functor: IResponseBodyStringifier<any> | undefined =
+      path === null ? args[0] : args[1];
+    return [path ?? undefined, take(logger)(method)(functor)];
+  };
+
+/** @internal */
+const take =
+  (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
+  (method: string) =>
+  <T>(functor?: IResponseBodyStringifier<T> | null) => {
+    if (functor === undefined) {
+      NoTransformConfigurationError(method);
+      return (input: T, _method: string, _path: string) =>
+        JSON.stringify(input);
+    } else if (functor === null)
+      return (input: T, _method: string, _path: string) =>
+        JSON.stringify(input);
+    else if (functor.type === "stringify") return functor.stringify;
+    else if (functor.type === "assert") return assert(functor.assert);
+    else if (functor.type === "is") return is(functor.is);
+    else if (functor.type === "validate") return validate(functor.validate);
+    else if (functor.type === "validate.log")
+      return validateLog(logger)(functor.validate);
+    throw new Error(
+      `Error on nestia.core.${method}(): invalid typed stringify function.`,
+    );
+  };
+
+/** @internal */
+const assert =
+  <T>(closure: (data: T) => string) =>
+  (data: T): string => {
+    try {
+      return closure(data);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp))
+        throw new InternalServerErrorException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      throw exp;
+    }
+  };
+
+/** @internal */
+const is =
+  <T>(closure: (data: T) => string | null) =>
+  (data: T, _method: string, _path: string) => {
+    const result: string | null = closure(data);
+    if (result === null) throw new InternalServerErrorException(MESSAGE);
+    return result;
+  };
+
+/** @internal */
+const validate =
+  <T>(closure: (data: T) => IValidation<string>) =>
+  (data: T, _method: string, _path: string): string => {
+    const result: IValidation<string> = closure(data);
+    if (result.success === false)
+      throw new InternalServerErrorException({
+        errors: result.errors,
+        message: MESSAGE,
+      });
+    return result.data;
+  };
+
+const validateLog =
+  (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
+  <T>(closure: (data: T) => IValidation<any>) =>
+  (data: T, method: string, path: string): string => {
+    const result: IValidation<string> = closure(data);
+    if (result.success === true) return result.data;
+    if (result.success === false)
+      logger()({
+        errors: result.errors,
+        method,
+        path,
+        data,
+      });
+    return JSON.stringify(data);
+  };
+
+/** @internal */
+const MESSAGE = "Response body data is not following the promised type.";

package/src/decorators/internal/get_text_body.ts

@@ -1,16 +1,16 @@
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-import raw from "raw-body";
-
-/** @internal */
-export const get_text_body = async (
-  request: express.Request | FastifyRequest,
-): Promise<string> =>
-  isExpressRequest(request)
-    ? (await raw(request)).toString("utf8")
-    : (request.body as string);
-
-/** @internal */
-const isExpressRequest = (
-  request: express.Request | FastifyRequest,
-): request is express.Request => (request as express.Request).app !== undefined;
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+import raw from "raw-body";
+
+/** @internal */
+export const get_text_body = async (
+  request: express.Request | FastifyRequest,
+): Promise<string> =>
+  isExpressRequest(request)
+    ? (await raw(request)).toString("utf8")
+    : (request.body as string);
+
+/** @internal */
+const isExpressRequest = (
+  request: express.Request | FastifyRequest,
+): request is express.Request => (request as express.Request).app !== undefined;

package/src/decorators/internal/headers_to_object.ts

@@ -1,11 +1,11 @@
-import http from "http";
-
-/** @internal */
-export function headers_to_object(
-  headers: http.IncomingHttpHeaders,
-): Record<string, string> {
-  const output: Record<string, string> = {};
-  for (const [key, value] of Object.entries(headers))
-    output[key] = value instanceof Array ? value[0]! : value || "";
-  return output;
-}
+import http from "http";
+
+/** @internal */
+export function headers_to_object(
+  headers: http.IncomingHttpHeaders,
+): Record<string, string> {
+  const output: Record<string, string> = {};
+  for (const [key, value] of Object.entries(headers))
+    output[key] = value instanceof Array ? value[0]! : value || "";
+  return output;
+}

package/src/decorators/internal/is_request_body_undefined.ts

@@ -1,12 +1,12 @@
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-
-/** @internal */
-export const is_request_body_undefined = (
-  request: express.Request | FastifyRequest,
-): boolean =>
-  request.headers["content-type"] === undefined &&
-  (request.body === undefined ||
-    (typeof request.body === "object" &&
-      request.body !== null &&
-      Object.keys(request.body).length === 0));
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+
+/** @internal */
+export const is_request_body_undefined = (
+  request: express.Request | FastifyRequest,
+): boolean =>
+  request.headers["content-type"] === undefined &&
+  (request.body === undefined ||
+    (typeof request.body === "object" &&
+      request.body !== null &&
+      Object.keys(request.body).length === 0));

package/src/decorators/internal/load_controller.ts

@@ -1,76 +1,91 @@
-import fs from "fs";
-import path from "path";
-
-import { Creator } from "../../typings/Creator";
-import { SourceFinder } from "../../utils/SourceFinder";
-
-export const load_controllers = async (
-  path: string | string[] | { include: string[]; exclude?: string[] },
-  isTsNode?: boolean,
-): Promise<Creator<object>[]> => {
-  const include: string[] = Array.isArray(path)
-    ? path
-    : typeof path === "object"
-      ? path.include
-      : [path];
-  const exclude: string[] =
-    typeof path === "object" && !Array.isArray(path) ? (path.exclude ?? []) : [];
-  const filter =
-    isTsNode === true
-      ? (file: string) =>
-          file.substring(file.length - 3) === ".ts" &&
-          file.substring(file.length - 5) !== ".d.ts"
-      : (file: string) => file.substring(file.length - 3) === ".js";
-  const sources: string[] = await SourceFinder.find({
-    include,
-    exclude,
-    filter,
-  });
-  const controllers: Creator<object>[] = await mount(sources);
-  if (controllers.length !== 0 || isTsNode === true) return controllers;
-
-  const runtimeRoot: string | null = findTtsxRuntimeRoot();
-  if (runtimeRoot === null) return controllers;
-
-  const fallback: string[] = await SourceFinder.find({
-    include: include.map((p) => resolveRuntimePattern(runtimeRoot, p)),
-    exclude: exclude.map((p) => resolveRuntimePattern(runtimeRoot, p)),
-    filter,
-  });
-  return fallback.length === 0 ? controllers : mount(fallback);
-};
-
-/** @internal */
-async function mount(sources: string[]): Promise<any[]> {
-  const controllers: any[] = [];
-  for (const file of sources) {
-    const external: any = await import(file);
-    for (const key in external) {
-      const instance: Creator<object> = external[key];
-      if (Reflect.getMetadata("path", instance) !== undefined)
-        controllers.push(instance);
-    }
-  }
-  return controllers;
-}
-
-function findTtsxRuntimeRoot(): string | null {
-  const entry: string | undefined = process.argv[1];
-  if (entry === undefined) return null;
-
-  let current: string = path.resolve(entry);
-  if (fs.existsSync(current) && fs.statSync(current).isFile())
-    current = path.dirname(current);
-  while (true) {
-    if (fs.existsSync(path.join(current, ".ttsx.tsconfig.json")))
-      return current;
-    const parent: string = path.dirname(current);
-    if (parent === current) return null;
-    current = parent;
-  }
-}
-
-function resolveRuntimePattern(runtimeRoot: string, pattern: string): string {
-  if (path.isAbsolute(pattern)) return pattern;
-  return path.resolve(runtimeRoot, pattern);
-}
+import { pathToFileURL } from "url";
+
+import { Creator } from "../../typings/Creator";
+import { SourceFinder } from "../../utils/SourceFinder";
+
+export const load_controllers = async (
+  path: string | string[] | { include: string[]; exclude?: string[] },
+  isTsNode?: boolean,
+): Promise<Creator<object>[]> => {
+  const include: string[] = Array.isArray(path)
+    ? path
+    : typeof path === "object"
+      ? path.include
+      : [path];
+  const exclude: string[] =
+    typeof path === "object" && !Array.isArray(path)
+      ? (path.exclude ?? [])
+      : [];
+  const filter =
+    isTsNode === true
+      ? (file: string) =>
+          file.substring(file.length - 3) === ".ts" &&
+          file.substring(file.length - 5) !== ".d.ts"
+      : (file: string) => file.substring(file.length - 3) === ".js";
+  const sources: string[] = await SourceFinder.find({
+    include,
+    exclude,
+    filter,
+  });
+  const controllers: Creator<object>[] = await mount(sources);
+  if (controllers.length !== 0 || isTsNode === true) return controllers;
+
+  // No compiled `.js` controllers were found. Under `ttsx`, the project runs
+  // straight from its TypeScript sources: `__dirname` still points at the
+  // source tree (the runtime hooks serve the emitted JS under the source
+  // URLs), so the controllers on disk are `.ts`, not `.js`. Detect that
+  // source-run context and retry with the TypeScript filter; `import()` of each
+  // `.ts` file is then served as the transformed emit by the hooks.
+  if (!isTsxRuntime()) return controllers;
+
+  const tsFilter = (file: string) =>
+    file.substring(file.length - 3) === ".ts" &&
+    file.substring(file.length - 5) !== ".d.ts";
+  const fallback: string[] = await SourceFinder.find({
+    include,
+    exclude,
+    filter: tsFilter,
+  });
+  return fallback.length === 0 ? controllers : mount(fallback);
+};
+
+/** @internal */
+async function mount(sources: string[]): Promise<any[]> {
+  const controllers: any[] = [];
+  for (const file of sources) {
+    const external: any = await dynamicImport(pathToFileURL(file).href);
+    for (const key in external) {
+      const instance: Creator<object> = external[key];
+      if (
+        instance === null ||
+        (typeof instance !== "function" && typeof instance !== "object")
+      )
+        continue;
+      if (Reflect.getMetadata("path", instance) !== undefined)
+        controllers.push(instance);
+    }
+  }
+  return controllers;
+}
+
+const dynamicImport: (specifier: string) => Promise<any> = Function(
+  "specifier",
+  "return import(specifier);",
+) as (specifier: string) => Promise<any>;
+
+/**
+ * Whether the process is running from TypeScript source under `ttsx`.
+ *
+ * `ttsx` runs a TypeScript entry from source: it builds the owning project to a
+ * temporary directory and installs runtime module hooks that serve that emit
+ * under the original source URLs, exporting the manifest path through
+ * `TTSX_RUNTIME_MANIFEST`. Its presence is the reliable signal that the
+ * controllers on disk are `.ts` (the `.js` glob will be empty) yet `import()`
+ * of those `.ts` files resolves to transformed JavaScript.
+ */
+function isTsxRuntime(): boolean {
+  return (
+    typeof process.env.TTSX_RUNTIME_MANIFEST === "string" &&
+    process.env.TTSX_RUNTIME_MANIFEST.length !== 0
+  );
+}