@nestia/sdk 12.0.0-dev.20260601.1 → 12.0.0-dev.20260619.1

package/src/structures/IReflectWebSocketOperation.ts

@@ -1,17 +1,17 @@
-import { VERSION_NEUTRAL } from "@nestjs/common";
-import { IJsDocTagInfo } from "typia";
-
-import { IReflectImport } from "./IReflectImport";
-import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
-
-export interface IReflectWebSocketOperation {
-  protocol: "websocket";
-  name: string;
-  paths: string[];
-  function: Function;
-  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-  parameters: IReflectWebSocketOperationParameter[];
-  imports: IReflectImport[];
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-}
+import { VERSION_NEUTRAL } from "@nestjs/common";
+import { IJsDocTagInfo } from "typia";
+
+import { IReflectImport } from "./IReflectImport";
+import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
+
+export interface IReflectWebSocketOperation {
+  protocol: "websocket";
+  name: string;
+  paths: string[];
+  function: Function;
+  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
+  parameters: IReflectWebSocketOperationParameter[];
+  imports: IReflectImport[];
+  description: string | null;
+  jsDocTags: IJsDocTagInfo[];
+}

package/src/structures/ITypedApplication.ts

@@ -1,11 +1,12 @@
-import { IMetadataDictionary } from "../internal/legacy";
-
-import { INestiaProject } from "./INestiaProject";
-import { ITypedHttpRoute } from "./ITypedHttpRoute";
-import { ITypedWebSocketRoute } from "./ITypedWebSocketRoute";
-
-export interface ITypedApplication {
-  project: INestiaProject;
-  collection: IMetadataDictionary;
-  routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>;
-}
+import { IMetadataDictionary } from "../internal/legacy";
+
+import { INestiaProject } from "./INestiaProject";
+import { ITypedHttpRoute } from "./ITypedHttpRoute";
+import { ITypedMcpRoute } from "./ITypedMcpRoute";
+import { ITypedWebSocketRoute } from "./ITypedWebSocketRoute";
+
+export interface ITypedApplication {
+  project: INestiaProject;
+  collection: IMetadataDictionary;
+  routes: Array<ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute>;
+}

package/src/structures/ITypedHttpRoute.ts

@@ -1,41 +1,41 @@
-import { IJsDocTagInfo } from "typia";
-
-import { IReflectController } from "./IReflectController";
-import { IReflectImport } from "./IReflectImport";
-import { ITypedHttpRouteException } from "./ITypedHttpRouteException";
-import { ITypedHttpRouteParameter } from "./ITypedHttpRouteParameter";
-import { ITypedHttpRouteSuccess } from "./ITypedHttpRouteSuccess";
-
-export interface ITypedHttpRoute {
-  protocol: "http";
-  function: Function;
-  controller: IReflectController;
-  name: string;
-  method: string;
-  path: string;
-  accessor: string[];
-
-  // PARAMETERS
-  pathParameters: ITypedHttpRouteParameter.IPath[];
-  queryParameters: ITypedHttpRouteParameter.IQuery[];
-  headerParameters: ITypedHttpRouteParameter.IHeaders[];
-  queryObject: ITypedHttpRouteParameter.IQuery | null;
-  headerObject: ITypedHttpRouteParameter.IHeaders | null;
-  body: ITypedHttpRouteParameter.IBody | null;
-
-  // RESPONSES
-  success: ITypedHttpRouteSuccess;
-  exceptions: Record<
-    number | "2XX" | "3XX" | "4XX" | "5XX",
-    ITypedHttpRouteException
-  >;
-
-  // ADDITIONAL INFORMATION
-  security: Record<string, string[]>[];
-  tags: string[];
-  imports: IReflectImport[];
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-  operationId: string | undefined;
-  extensions?: Record<string, any>;
-}
+import { IJsDocTagInfo } from "typia";
+
+import { IReflectController } from "./IReflectController";
+import { IReflectImport } from "./IReflectImport";
+import { ITypedHttpRouteException } from "./ITypedHttpRouteException";
+import { ITypedHttpRouteParameter } from "./ITypedHttpRouteParameter";
+import { ITypedHttpRouteSuccess } from "./ITypedHttpRouteSuccess";
+
+export interface ITypedHttpRoute {
+  protocol: "http";
+  function: Function;
+  controller: IReflectController;
+  name: string;
+  method: string;
+  path: string;
+  accessor: string[];
+
+  // PARAMETERS
+  pathParameters: ITypedHttpRouteParameter.IPath[];
+  queryParameters: ITypedHttpRouteParameter.IQuery[];
+  headerParameters: ITypedHttpRouteParameter.IHeaders[];
+  queryObject: ITypedHttpRouteParameter.IQuery | null;
+  headerObject: ITypedHttpRouteParameter.IHeaders | null;
+  body: ITypedHttpRouteParameter.IBody | null;
+
+  // RESPONSES
+  success: ITypedHttpRouteSuccess;
+  exceptions: Record<
+    number | "2XX" | "3XX" | "4XX" | "5XX",
+    ITypedHttpRouteException
+  >;
+
+  // ADDITIONAL INFORMATION
+  security: Record<string, string[]>[];
+  tags: string[];
+  imports: IReflectImport[];
+  description: string | null;
+  jsDocTags: IJsDocTagInfo[];
+  operationId: string | undefined;
+  extensions?: Record<string, any>;
+}

package/src/structures/ITypedHttpRouteException.ts

@@ -1,15 +1,15 @@
-import { MetadataSchema } from "../internal/legacy";
-
-import { IReflectType } from "./IReflectType";
-
-export interface ITypedHttpRouteException {
-  // BASIC PROPERTIES
-  status: number | "2XX" | "3XX" | "4XX" | "5XX";
-  description: string | null;
-  example: any;
-  examples: Record<string, any>;
-
-  // REFLECTED PROPERTIES
-  type: IReflectType;
-  metadata: MetadataSchema;
-}
+import { MetadataSchema } from "../internal/legacy";
+
+import { IReflectType } from "./IReflectType";
+
+export interface ITypedHttpRouteException {
+  // BASIC PROPERTIES
+  status: number | "2XX" | "3XX" | "4XX" | "5XX";
+  description: string | null;
+  example: any;
+  examples: Record<string, any>;
+
+  // REFLECTED PROPERTIES
+  type: IReflectType;
+  metadata: MetadataSchema;
+}

package/src/structures/ITypedHttpRouteParameter.ts

@@ -1,41 +1,41 @@
-import { MetadataSchema } from "../internal/legacy";
-import { IJsDocTagInfo } from "typia";
-
-import { IReflectType } from "./IReflectType";
-
-export type ITypedHttpRouteParameter =
-  | ITypedHttpRouteParameter.IBody
-  | ITypedHttpRouteParameter.IHeaders
-  | ITypedHttpRouteParameter.IPath
-  | ITypedHttpRouteParameter.IQuery;
-export namespace ITypedHttpRouteParameter {
-  export interface IBody extends IBase<"body"> {
-    contentType:
-      | "application/json"
-      | "application/x-www-form-urlencoded"
-      | "multipart/form-data"
-      | "text/plain";
-    encrypted: boolean;
-  }
-  export interface IHeaders extends IBase<"headers"> {
-    field: string | null;
-  }
-  export interface IPath extends IBase<"param"> {
-    field: string;
-  }
-  export interface IQuery extends IBase<"query"> {
-    field: string | null;
-  }
-
-  interface IBase<Category extends string> {
-    category: Category;
-    name: string;
-    index: number;
-    type: IReflectType;
-    metadata: MetadataSchema;
-    example?: any;
-    examples?: Record<string, any>;
-    description: string | null;
-    jsDocTags: IJsDocTagInfo[];
-  }
-}
+import { MetadataSchema } from "../internal/legacy";
+import { IJsDocTagInfo } from "typia";
+
+import { IReflectType } from "./IReflectType";
+
+export type ITypedHttpRouteParameter =
+  | ITypedHttpRouteParameter.IBody
+  | ITypedHttpRouteParameter.IHeaders
+  | ITypedHttpRouteParameter.IPath
+  | ITypedHttpRouteParameter.IQuery;
+export namespace ITypedHttpRouteParameter {
+  export interface IBody extends IBase<"body"> {
+    contentType:
+      | "application/json"
+      | "application/x-www-form-urlencoded"
+      | "multipart/form-data"
+      | "text/plain";
+    encrypted: boolean;
+  }
+  export interface IHeaders extends IBase<"headers"> {
+    field: string | null;
+  }
+  export interface IPath extends IBase<"param"> {
+    field: string;
+  }
+  export interface IQuery extends IBase<"query"> {
+    field: string | null;
+  }
+
+  interface IBase<Category extends string> {
+    category: Category;
+    name: string;
+    index: number;
+    type: IReflectType;
+    metadata: MetadataSchema;
+    example?: any;
+    examples?: Record<string, any>;
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+  }
+}

package/src/structures/ITypedHttpRouteSuccess.ts

@@ -1,22 +1,18 @@
-import { MetadataSchema } from "../internal/legacy";
-
-import { IReflectType } from "./IReflectType";
-
-export interface ITypedHttpRouteSuccess {
-  type: IReflectType;
-  status: number | null;
-  contentType:
-    | "application/json"
-    | "text/plain"
-    | "application/x-www-form-urlencoded"
-    | "application/json"
-    | null;
-  encrypted: boolean;
-  metadata: MetadataSchema;
-  example?: any;
-  examples?: Record<string, any>;
-  setHeaders: Array<
-    | { type: "setter"; source: string; target?: string }
-    | { type: "assigner"; source: string }
-  >;
-}
+import { MetadataSchema } from "../internal/legacy";
+import { HttpResponseContentTypeUtil } from "../utils/HttpResponseContentTypeUtil";
+import { IReflectType } from "./IReflectType";
+
+export interface ITypedHttpRouteSuccess {
+  type: IReflectType;
+  status: number | null;
+  contentType: HttpResponseContentTypeUtil.Response;
+  binary: boolean;
+  encrypted: boolean;
+  metadata: MetadataSchema;
+  example?: any;
+  examples?: Record<string, any>;
+  setHeaders: Array<
+    | { type: "setter"; source: string; target?: string }
+    | { type: "assigner"; source: string }
+  >;
+}

package/src/structures/ITypedMcpRoute.ts

@@ -0,0 +1,33 @@
+import ts from "typescript";
+
+import { IReflectController } from "./IReflectController";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectMcpOperation } from "./IReflectMcpOperation";
+import { IReflectMcpOperationParameter } from "./IReflectMcpOperationParameter";
+import { IReflectType } from "./IReflectType";
+
+/**
+ * Final typed representation of an MCP tool route.
+ *
+ * Carries everything the SDK generator needs to emit a typed client function:
+ * the controller reference, accessor path, typia-derived input schema, and
+ * input/output type info.
+ */
+export interface ITypedMcpRoute {
+  protocol: "mcp";
+  controller: IReflectController;
+  name: string;
+  toolName: string;
+  title: string | null;
+  toolDescription: string | null;
+  accessor: string[];
+  function: Function;
+  input: IReflectMcpOperationParameter | null;
+  returnType: IReflectType | null;
+  inputSchema: object;
+  outputSchema: object | null;
+  annotations: IReflectMcpOperation.IAnnotations | null;
+  imports: IReflectImport[];
+  description: string | null;
+  jsDocTags: ts.JSDocTagInfo[];
+}

package/src/structures/ITypedWebSocketRoute.ts

@@ -1,24 +1,24 @@
-import { VERSION_NEUTRAL } from "@nestjs/common";
-import { IJsDocTagInfo } from "typia";
-
-import { IReflectController } from "./IReflectController";
-import { IReflectImport } from "./IReflectImport";
-import { ITypedWebSocketRouteParameter } from "./ITypedWebSocketRouteParameter";
-
-export interface ITypedWebSocketRoute {
-  protocol: "websocket";
-  controller: IReflectController;
-  name: string;
-  path: string;
-  accessor: string[];
-  function: Function;
-  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-  acceptor: ITypedWebSocketRouteParameter.IAcceptor;
-  header: ITypedWebSocketRouteParameter.IHeader | null;
-  pathParameters: ITypedWebSocketRouteParameter.IParam[];
-  query: ITypedWebSocketRouteParameter.IQuery | null;
-  driver: ITypedWebSocketRouteParameter.IDriver | null;
-  imports: IReflectImport[];
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-}
+import { VERSION_NEUTRAL } from "@nestjs/common";
+import { IJsDocTagInfo } from "typia";
+
+import { IReflectController } from "./IReflectController";
+import { IReflectImport } from "./IReflectImport";
+import { ITypedWebSocketRouteParameter } from "./ITypedWebSocketRouteParameter";
+
+export interface ITypedWebSocketRoute {
+  protocol: "websocket";
+  controller: IReflectController;
+  name: string;
+  path: string;
+  accessor: string[];
+  function: Function;
+  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
+  acceptor: ITypedWebSocketRouteParameter.IAcceptor;
+  header: ITypedWebSocketRouteParameter.IHeader | null;
+  pathParameters: ITypedWebSocketRouteParameter.IParam[];
+  query: ITypedWebSocketRouteParameter.IQuery | null;
+  driver: ITypedWebSocketRouteParameter.IDriver | null;
+  imports: IReflectImport[];
+  description: string | null;
+  jsDocTags: IJsDocTagInfo[];
+}

package/src/structures/ITypedWebSocketRouteParameter.ts

@@ -1,3 +1,3 @@
-import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
-
-export import ITypedWebSocketRouteParameter = IReflectWebSocketOperationParameter;
+import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
+
+export import ITypedWebSocketRouteParameter = IReflectWebSocketOperationParameter;

package/src/transform.ts

@@ -1,59 +1,28 @@
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-interface ITtscPlugin {
-  name: string;
-  source: string;
-}
-
-const filename: string = currentFilename();
-const dirname: string = path.dirname(filename);
-
-/**
- * `@nestia/sdk` ttsc plugin descriptor.
- *
- * Points ttsc at this package's own Go source (`native/sdk`, package `sdk`).
- * Because that package is not `package main`, ttsc classifies it as a linked
- * transform and statically links it into the `@nestia/core` host binary as a
- * contributor — but only for projects that actually depend on `@nestia/sdk`.
- * A project depending on `@nestia/core` alone never links, compiles, or ships
- * any of this SDK transform code.
- */
-export function createTtscPlugin(): ITtscPlugin {
-  // `<root>/lib/transform.js` (published) or `<root>/src/transform.ts` (dev)
-  // → `<root>` → the `native/sdk` linked-transform source package.
-  const root: string = path.resolve(dirname, "..");
-  return {
-    name: "@nestia/sdk",
-    source: path.resolve(root, "native", "sdk"),
-  };
-}
-export default createTtscPlugin;
-
-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 { createRequire } from "node:module";
+import path from "node:path";
+import type { ITtscPlugin, ITtscPluginFactoryContext } from "ttsc";
+
+/**
+ * `@nestia/sdk` ttsc plugin descriptor.
+ *
+ * Points ttsc at this package's own Go source (`native/sdk`, package `sdk`).
+ * Because that package is not `package main`, ttsc classifies it as a linked
+ * transform and statically links it into the `@nestia/core` host binary as a
+ * contributor — but only for projects that actually depend on `@nestia/sdk`. A
+ * project depending on `@nestia/core` alone never links, compiles, or ships any
+ * of this SDK transform code.
+ */
+export default function createTtscPlugin(
+  context: ITtscPluginFactoryContext,
+): ITtscPlugin {
+  const requireFrom = createRequire(
+    path.join(context.projectRoot, "package.json"),
+  );
+  const root: string = path.dirname(
+    requireFrom.resolve("@nestia/sdk/package.json"),
+  );
+  return {
+    name: "@nestia/sdk",
+    source: path.resolve(root, "native", "sdk"),
+  };
+}

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;
+  }
+}