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

package/lib/generates/internal/SwaggerOperationResponseComposer.d.ts

@@ -1,5 +1,5 @@
-import { MetadataSchema } from "../../internal/legacy";
 import { OpenApi } from "@typia/interface";
+import { MetadataSchema } from "../../internal/legacy";
 import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
 export declare namespace SwaggerOperationResponseComposer {
     const compose: (props: {

package/lib/generates/internal/SwaggerOperationResponseComposer.js

@@ -64,7 +64,12 @@ var SwaggerOperationResponseComposer;
                 : (description !== null && description !== void 0 ? description : ""), content: props.route.success.contentType
                 ? {
                     [props.route.success.contentType]: {
-                        schema: props.schema(props.route.success.metadata),
+                        schema: props.route.success.binary
+                            ? {
+                                format: "binary",
+                                type: "string",
+                            }
+                            : props.schema(props.route.success.metadata),
                         example: props.route.success.example,
                         examples: props.route.success.examples,
                     },

package/lib/generates/internal/SwaggerOperationResponseComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SwaggerOperationResponseComposer.js","sourceRoot":"","sources":["../../../src/generates/internal/SwaggerOperationResponseComposer.ts"],"names":[],"mappings":";;;AAEA,+BAAyC;AAGzC,uDAAoD;AACpD,6EAA0E;AAE1E,IAAiB,gCAAgC,CAoFhD;AApFD,WAAiB,gCAAgC;IAClC,wCAAO,GAAG,CAAC,KAGvB,EAAgD,EAAE;;;QACjD,MAAM,MAAM,GAAiD,EAAE,CAAC;QAChE,iBAAiB;QACjB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;YAClE,MAAM,CAAC,MAAM,CAAC,GAAG;gBACf,WAAW,QAAE,KAAK,CAAC,WAAW,mCAAI,SAAS;gBAC3C,OAAO,EAAE;oBACP,kBAAkB,EAAE;wBAClB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;wBACpC,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;qBACzB;iBACF;aACF,CAAC;QAEJ,gBAAgB;QAChB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAC5D,MAAM,IAAI,GAAuB,MAAA,MAAA,GAAG,CAAC,IAAI,0CAAE,IAAI,CAC7C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAC/B,0CAAE,IAAI,CAAC;YACR,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS;YAEjC,MAAM,QAAQ,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAW,QAAQ,CAAC,CAAC,CAAE,CAAC;YACpC,IACE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACrB,MAAM,KAAK,KAAK;gBAChB,MAAM,KAAK,KAAK;gBAChB,MAAM,KAAK,KAAK;gBAChB,MAAM,KAAK,KAAK;gBAEhB,SAAS;YAEX,MAAM,WAAW,GACf,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,WAAW,IAAI,MAAM,KAAK,SAAS;gBACrC,MAAA,MAAM,CAAC,WAAW,oCAAlB,MAAM,CAAC,WAAW,GAAK,WAAW,EAAC;iBAChC,IAAI,MAAM,KAAK,SAAS;gBAC3B,MAAM,CAAC,MAAM,CAAC,GAAG;oBACf,WAAW,EAAE,WAAW;oBACxB,OAAO,EAAE;wBACP,kBAAkB,EAAE;4BAClB,MAAM,EAAE,EAAE;yBACX;qBACF;iBACF,CAAC;QACN,CAAC;QAED,UAAU;QACV,MAAM,WAAW,SACf,uDAA0B,CAAC,uBAAuB,CAAC;YACjD,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;YAChC,GAAG,EAAE,SAAS;SACf,CAAC,mCACF,uDAA0B,CAAC,uBAAuB,CAAC;YACjD,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;YAChC,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;QACL,MAAM,OACJ,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,mCACxB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAC5D,mBACC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS;gBACxC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,EAAE;gBACzE,CAAC,CAAC,CAAC,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,CAAC,EACvB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW;gBACtC,CAAC,CAAC;oBACE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;wBACjC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;wBAClD,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO;wBACpC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ;qBACvC;iBACF;gBACH,CAAC,CAAC,SAAS,IACV,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACzE,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,EApFgB,gCAAgC,aAAhC,gCAAgC,GAAhC,gCAAgC,QAoFhD;AAED,MAAM,OAAO,GAAG,IAAI,wBAAiB,CAAC,CAAC,SAAkB,EAAE,MAAc,EAAE,EAAE;IAC3E,MAAM,OAAO,GAAW,oCAAoC,CAAC;IAC7D,MAAM,SAAS,GAAW,mBAAmB,uBAAU,CAAC,UAAU,CAAC,MAAM,CAAC,2DAA2D,CAAC;IAEtI,MAAM,OAAO,GAAa;QACxB,YAAY;QACZ,EAAE;QACF,OAAO;QACP,EAAE;QACF,0HAA0H,SAAS,aAAa;QAChJ,EAAE;QACF,mMAAmM;KACpM,CAAC;IACF,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"SwaggerOperationResponseComposer.js","sourceRoot":"","sources":["../../../src/generates/internal/SwaggerOperationResponseComposer.ts"],"names":[],"mappings":"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"}

package/lib/generates/internal/SwaggerReadonlyArrayEmender.d.ts

@@ -0,0 +1,9 @@
+import { OpenApi } from "@typia/interface";
+import { MetadataSchema } from "../../internal/legacy";
+export declare namespace SwaggerReadonlyArrayEmender {
+    const emend: (props: {
+        components: OpenApi.IComponents;
+        schema: OpenApi.IJsonSchema | undefined;
+        metadata: MetadataSchema;
+    }) => void;
+}

package/lib/generates/internal/SwaggerReadonlyArrayEmender.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerReadonlyArrayEmender = void 0;
+var SwaggerReadonlyArrayEmender;
+(function (SwaggerReadonlyArrayEmender) {
+    SwaggerReadonlyArrayEmender.emend = (props) => {
+        const visited = {
+            aliases: new WeakSet(),
+            arrays: new WeakSet(),
+            objects: new WeakSet(),
+            schemas: new WeakSet(),
+            tuples: new WeakSet(),
+        };
+        visitMetadata({
+            components: props.components,
+            schema: props.schema,
+            metadata: props.metadata,
+            visited,
+        });
+    };
+})(SwaggerReadonlyArrayEmender || (exports.SwaggerReadonlyArrayEmender = SwaggerReadonlyArrayEmender = {}));
+const visitMetadata = (props) => {
+    if (props.schema !== undefined && isReadonlyArrayLike(props.metadata))
+        setReadonlyArray(props.schema);
+    if (props.visited.schemas.has(props.metadata))
+        return;
+    props.visited.schemas.add(props.metadata);
+    for (const array of props.metadata.arrays) {
+        const type = array.type;
+        if (type !== undefined)
+            visitArrayType({
+                components: props.components,
+                schema: arraySchema(props.schema),
+                type,
+                visited: props.visited,
+            });
+    }
+    for (const tuple of props.metadata.tuples) {
+        const type = tuple.type;
+        if (type !== undefined)
+            visitTupleType({
+                components: props.components,
+                schema: props.schema,
+                type,
+                visited: props.visited,
+            });
+    }
+    for (const alias of props.metadata.aliases) {
+        const type = alias.type;
+        if (type !== undefined)
+            visitAliasType({
+                components: props.components,
+                schema: componentSchema(props.components, type.name),
+                type,
+                visited: props.visited,
+            });
+    }
+    for (const object of props.metadata.objects) {
+        const type = object.type;
+        if (type !== undefined)
+            visitObjectType({
+                components: props.components,
+                type,
+                visited: props.visited,
+            });
+    }
+};
+const visitAliasType = (props) => {
+    if (props.visited.aliases.has(props.type))
+        return;
+    props.visited.aliases.add(props.type);
+    if (props.schema !== undefined && isReadonlyArrayLike(props.type.value))
+        setReadonlyArray(props.schema);
+    visitMetadata({
+        components: props.components,
+        schema: props.schema,
+        metadata: props.type.value,
+        visited: props.visited,
+    });
+};
+const visitArrayType = (props) => {
+    var _a;
+    if (props.visited.arrays.has(props.type))
+        return;
+    props.visited.arrays.add(props.type);
+    const component = componentSchema(props.components, props.type.name);
+    if (component !== undefined && isReadonlyArrayName(props.type.name))
+        setReadonlyArray(component);
+    visitMetadata({
+        components: props.components,
+        schema: arraySchema((_a = props.schema) !== null && _a !== void 0 ? _a : component),
+        metadata: props.type.value,
+        visited: props.visited,
+    });
+};
+const visitTupleType = (props) => {
+    var _a;
+    if (props.visited.tuples.has(props.type))
+        return;
+    props.visited.tuples.add(props.type);
+    const component = componentSchema(props.components, props.type.name);
+    if (component !== undefined && isReadonlyArrayName(props.type.name))
+        setReadonlyArray(component);
+    const schema = objectSchema((_a = props.schema) !== null && _a !== void 0 ? _a : component);
+    props.type.elements.forEach((metadata, index) => visitMetadata({
+        components: props.components,
+        schema: Array.isArray(schema === null || schema === void 0 ? void 0 : schema.prefixItems)
+            ? schema.prefixItems[index]
+            : undefined,
+        metadata,
+        visited: props.visited,
+    }));
+};
+const visitObjectType = (props) => {
+    if (props.visited.objects.has(props.type))
+        return;
+    props.visited.objects.add(props.type);
+    const schema = objectSchema(componentSchema(props.components, props.type.name));
+    const properties = schema === null || schema === void 0 ? void 0 : schema.properties;
+    for (const property of props.type.properties) {
+        const key = propertyKey(property.key);
+        const child = key === undefined ? undefined : properties === null || properties === void 0 ? void 0 : properties[key];
+        visitMetadata({
+            components: props.components,
+            schema: child,
+            metadata: property.value,
+            visited: props.visited,
+        });
+    }
+};
+const isReadonlyArrayLike = (metadata, visited = new WeakSet()) => {
+    if (visited.has(metadata))
+        return false;
+    visited.add(metadata);
+    const name = metadata.name;
+    return ((typeof name === "string" && isReadonlyArrayName(name)) ||
+        metadata.arrays.some((array) => isReadonlyArrayName(array.name)) ||
+        metadata.tuples.some((tuple) => isReadonlyArrayName(tuple.name)) ||
+        metadata.aliases.some((alias) => {
+            const type = alias.type;
+            return type !== undefined && isReadonlyArrayLike(type.value, visited);
+        }));
+};
+const isReadonlyArrayName = (name) => {
+    const trimmed = name.trim();
+    const compact = name.replace(/\s+/g, "");
+    return (compact === "ReadonlyArray" ||
+        compact.startsWith("ReadonlyArray<") ||
+        compact.startsWith("readonly[") ||
+        trimmed.startsWith("readonly "));
+};
+const componentSchema = (components, name) => { var _a; return ((_a = components.schemas) !== null && _a !== void 0 ? _a : {})[name]; };
+const arraySchema = (schema) => {
+    const obj = objectSchema(schema);
+    return obj === null || obj === void 0 ? void 0 : obj.items;
+};
+const objectSchema = (schema) => typeof schema === "object" && schema !== null
+    ? schema
+    : undefined;
+const propertyKey = (metadata) => {
+    var _a, _b;
+    const value = (_b = (_a = metadata.constants[0]) === null || _a === void 0 ? void 0 : _a.values[0]) === null || _b === void 0 ? void 0 : _b.value;
+    return typeof value === "string"
+        ? value
+        : typeof value === "number"
+            ? String(value)
+            : undefined;
+};
+const setReadonlyArray = (schema) => {
+    const obj = objectSchema(schema);
+    if (obj !== undefined)
+        obj["x-readonly-array"] = true;
+};
+//# sourceMappingURL=SwaggerReadonlyArrayEmender.js.map

package/lib/generates/internal/SwaggerReadonlyArrayEmender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerReadonlyArrayEmender.js","sourceRoot":"","sources":["../../../src/generates/internal/SwaggerReadonlyArrayEmender.ts"],"names":[],"mappings":"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"}

package/lib/structures/INestiaSdkInput.d.ts

@@ -1,9 +1,10 @@
-import { RouteInfo, VersionValue } from "@nestjs/common/interfaces";
+import { RequestMethod } from "@nestjs/common";
+import { VersionValue } from "@nestjs/common/interfaces";
 export interface INestiaSdkInput {
     controllers: INestiaSdkInput.IController[];
     globalPrefix?: {
         prefix: string;
-        exclude?: Array<string | RouteInfo>;
+        exclude?: INestiaSdkInput.IGlobalPrefixExclude[];
     };
     versioning?: {
         prefix: string;
@@ -16,4 +17,10 @@ export declare namespace INestiaSdkInput {
         location: string;
         prefixes: string[];
     }
+    interface IGlobalPrefixExclude {
+        path: string;
+        method?: RequestMethod;
+        requestMethod?: RequestMethod;
+        pathRegex?: RegExp;
+    }
 }

package/lib/structures/IReflectController.d.ts

@@ -1,5 +1,6 @@
 import type { VERSION_NEUTRAL } from "@nestjs/common/interfaces";
 import { IReflectHttpOperation } from "./IReflectHttpOperation";
+import { IReflectMcpOperation } from "./IReflectMcpOperation";
 import { IReflectWebSocketOperation } from "./IReflectWebSocketOperation";
 export interface IReflectController {
     class: Function;
@@ -7,7 +8,7 @@ export interface IReflectController {
     paths: string[];
     file: string;
     versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-    operations: Array<IReflectHttpOperation | IReflectWebSocketOperation>;
+    operations: Array<IReflectHttpOperation | IReflectWebSocketOperation | IReflectMcpOperation>;
     security: Record<string, string[]>[];
     tags: string[];
 }

package/lib/structures/IReflectHttpOperationSuccess.d.ts

@@ -1,10 +1,12 @@
-import { MetadataFactory } from "../internal/legacy";
 import { IMetadataComponents, IMetadataSchema } from "@typia/interface";
+import { MetadataFactory } from "../internal/legacy";
+import { HttpResponseContentTypeUtil } from "../utils/HttpResponseContentTypeUtil";
 import { IReflectType } from "./IReflectType";
 export interface IReflectHttpOperationSuccess {
     type: IReflectType;
     status: number;
-    contentType: "application/json" | "text/plain" | "application/x-www-form-urlencoded" | "application/json" | null;
+    contentType: HttpResponseContentTypeUtil.Response;
+    binary: boolean;
     encrypted: boolean;
     components: IMetadataComponents;
     metadata: IMetadataSchema;

package/lib/structures/IReflectMcpOperation.d.ts

@@ -0,0 +1,35 @@
+import ts from "typescript";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectMcpOperationParameter } from "./IReflectMcpOperationParameter";
+import { IReflectType } from "./IReflectType";
+/**
+ * Reflected operation metadata for a method decorated with `@McpRoute`.
+ *
+ * Produced by {@link ReflectMcpOperationAnalyzer.analyze}; consumed by
+ * {@link TypedMcpRouteAnalyzer.analyze} to produce the final
+ * {@link ITypedMcpRoute}.
+ */
+export interface IReflectMcpOperation {
+    protocol: "mcp";
+    name: string;
+    toolName: string;
+    title: string | null;
+    toolDescription: string | null;
+    inputSchema: object;
+    outputSchema: object | null;
+    annotations: IReflectMcpOperation.IAnnotations | null;
+    function: Function;
+    parameters: IReflectMcpOperationParameter[];
+    returnType: IReflectType | null;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: ts.JSDocTagInfo[];
+}
+export declare namespace IReflectMcpOperation {
+    interface IAnnotations {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    }
+}

package/lib/structures/IReflectMcpOperation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IReflectMcpOperation.js.map

package/lib/structures/IReflectMcpOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReflectMcpOperation.js","sourceRoot":"","sources":["../../src/structures/IReflectMcpOperation.ts"],"names":[],"mappings":""}

package/lib/structures/IReflectMcpOperationParameter.d.ts

@@ -0,0 +1,19 @@
+import { IJsDocTagInfo } from "typia";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectType } from "./IReflectType";
+/**
+ * Parameter descriptor for an MCP tool method. Reflected from
+ * `"nestia/McpRoute/Parameters"` metadata plus compile-time type information
+ * collected by the nestia transformer.
+ */
+export interface IReflectMcpOperationParameter {
+    category: "params";
+    name: string;
+    index: number;
+    type: IReflectType;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+}
+export declare namespace IReflectMcpOperationParameter {
+}

package/lib/structures/IReflectMcpOperationParameter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IReflectMcpOperationParameter.js.map

package/lib/structures/IReflectMcpOperationParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReflectMcpOperationParameter.js","sourceRoot":"","sources":["../../src/structures/IReflectMcpOperationParameter.ts"],"names":[],"mappings":""}

package/lib/structures/ITypedApplication.d.ts

@@ -1,9 +1,10 @@
 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>;
+    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute>;
 }

package/lib/structures/ITypedHttpRouteSuccess.d.ts

@@ -1,9 +1,11 @@
 import { MetadataSchema } from "../internal/legacy";
+import { HttpResponseContentTypeUtil } from "../utils/HttpResponseContentTypeUtil";
 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;
+    contentType: HttpResponseContentTypeUtil.Response;
+    binary: boolean;
     encrypted: boolean;
     metadata: MetadataSchema;
     example?: any;

package/lib/structures/ITypedMcpRoute.d.ts

@@ -0,0 +1,31 @@
+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/lib/structures/ITypedMcpRoute.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITypedMcpRoute.js.map

package/lib/structures/ITypedMcpRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITypedMcpRoute.js","sourceRoot":"","sources":["../../src/structures/ITypedMcpRoute.ts"],"names":[],"mappings":""}

package/lib/transform.d.ts

@@ -1,16 +1,12 @@
-interface ITtscPlugin {
-    name: string;
-    source: string;
-}
+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.
+ * 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 declare function createTtscPlugin(): ITtscPlugin;
-export default createTtscPlugin;
+export default function createTtscPlugin(context: ITtscPluginFactoryContext): ITtscPlugin;

package/lib/transform.js

@@ -3,48 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTtscPlugin = createTtscPlugin;
+exports.default = createTtscPlugin;
+const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
-const node_url_1 = require("node:url");
-const filename = currentFilename();
-const dirname = node_path_1.default.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.
+ * 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.
  */
-function createTtscPlugin() {
-    // `<root>/lib/transform.js` (published) or `<root>/src/transform.ts` (dev)
-    // → `<root>` → the `native/sdk` linked-transform source package.
-    const root = node_path_1.default.resolve(dirname, "..");
+function createTtscPlugin(context) {
+    const requireFrom = (0, node_module_1.createRequire)(node_path_1.default.join(context.projectRoot, "package.json"));
+    const root = node_path_1.default.dirname(requireFrom.resolve("@nestia/sdk/package.json"));
     return {
         name: "@nestia/sdk",
         source: node_path_1.default.resolve(root, "native", "sdk"),
     };
 }
-exports.default = createTtscPlugin;
-function currentFilename() {
-    var _a;
-    var _b, _c;
-    if (typeof __filename === "string" &&
-        __filename !== "[stdin]" &&
-        __filename.length !== 0)
-        return normalizeFilename(__filename);
-    const line = (_a = new Error().stack) === null || _a === void 0 ? void 0 : _a.split("\n").find((entry) => entry.includes("/src/transform.ts") ||
-        entry.includes("/lib/transform.js") ||
-        entry.includes("/lib/transform.mjs"));
-    const matched = line === null || line === void 0 ? void 0 : line.match(/\(([^()]+):\d+:\d+\)|at ([^\s()]+):\d+:\d+/);
-    const fallback = typeof __filename === "string" ? __filename : "";
-    return normalizeFilename((_c = (_b = matched === null || matched === void 0 ? void 0 : matched[1]) !== null && _b !== void 0 ? _b : matched === null || matched === void 0 ? void 0 : matched[2]) !== null && _c !== void 0 ? _c : fallback);
-}
-function normalizeFilename(value) {
-    if (value.startsWith("file:"))
-        return (0, node_url_1.fileURLToPath)(value);
-    return value;
-}
 //# sourceMappingURL=transform.js.map

package/lib/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,uCAAyC;AAOzC,MAAM,QAAQ,GAAW,eAAe,EAAE,CAAC;AAC3C,MAAM,OAAO,GAAW,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE/C;;;;;;;;;GASG;AACH;IACE,2EAA2E;IAC3E,iEAAiE;IACjE,MAAM,IAAI,GAAW,mBAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC;kBACc,gBAAgB;AAE/B,SAAS,eAAe;;;IACtB,IACE,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,KAAK,SAAS;QACxB,UAAU,CAAC,MAAM,KAAK,CAAC;QAEvB,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAuB,MAAA,IAAI,KAAK,EAAE,CAAC,KAAK,0CAC9C,KAAK,CAAC,IAAI,EACX,IAAI,CACH,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CACvC,CAAC;IACJ,MAAM,OAAO,GAAwC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAC9D,4CAA4C,CAC7C,CAAC;IACF,MAAM,QAAQ,GAAW,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO,iBAAiB,aAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAG7B;;;;;;;;;GASG;AACH,0BACE,OAAkC;IAElC,MAAM,WAAW,GAAG,IAAA,2BAAa,EAC/B,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAC/C,CAAC;IACF,MAAM,IAAI,GAAW,mBAAI,CAAC,OAAO,CAC/B,WAAW,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAChD,CAAC;IACF,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/lib/utils/HttpResponseContentTypeUtil.d.ts

@@ -0,0 +1,5 @@
+export declare namespace HttpResponseContentTypeUtil {
+    type Response = "application/json" | "text/plain" | "application/x-www-form-urlencoded" | (string & {}) | null;
+    const isSupported: (input: string | null) => input is Response;
+    const isBinary: (input: string | null | undefined) => input is string;
+}

package/lib/utils/HttpResponseContentTypeUtil.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpResponseContentTypeUtil = void 0;
+var HttpResponseContentTypeUtil;
+(function (HttpResponseContentTypeUtil) {
+    HttpResponseContentTypeUtil.isSupported = (input) => input === null ||
+        input === "application/json" ||
+        input === "text/plain" ||
+        input === "application/x-www-form-urlencoded" ||
+        HttpResponseContentTypeUtil.isBinary(input);
+    HttpResponseContentTypeUtil.isBinary = (input) => {
+        if (typeof input !== "string")
+            return false;
+        const value = input.split(";")[0].trim().toLowerCase();
+        return (value.startsWith("image/") ||
+            value.startsWith("video/") ||
+            value.startsWith("audio/") ||
+            value === "application/octet-stream" ||
+            value === "application/pdf");
+    };
+})(HttpResponseContentTypeUtil || (exports.HttpResponseContentTypeUtil = HttpResponseContentTypeUtil = {}));
+//# sourceMappingURL=HttpResponseContentTypeUtil.js.map

package/lib/utils/HttpResponseContentTypeUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpResponseContentTypeUtil.js","sourceRoot":"","sources":["../../src/utils/HttpResponseContentTypeUtil.ts"],"names":[],"mappings":";;;AAAA,IAAiB,2BAA2B,CA6B3C;AA7BD,WAAiB,2BAA2B;IAQ7B,uCAAW,GAAG,CAAC,KAAoB,EAAqB,EAAE,CACrE,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,kBAAkB;QAC5B,KAAK,KAAK,YAAY;QACtB,KAAK,KAAK,mCAAmC;QAC7C,oCAAQ,CAAC,KAAK,CAAC,CAAC;IAEL,oCAAQ,GAAG,CACtB,KAAgC,EACf,EAAE;QACnB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5C,MAAM,KAAK,GAAW,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChE,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,KAAK,KAAK,0BAA0B;YACpC,KAAK,KAAK,iBAAiB,CAC5B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA7BgB,2BAA2B,aAA3B,2BAA2B,GAA3B,2BAA2B,QA6B3C"}