@eggjs/controller-decorator 4.0.0-beta.8 → 4.0.1-beta.0

package/dist/decorator/http/index.js

@@ -0,0 +1,7 @@
+import { Host } from "./Host.js";
+import { HTTPController } from "./HTTPController.js";
+import { HTTPMethod } from "./HTTPMethod.js";
+import { InjectContext } from "../Context.js";
+import { HTTPBody, HTTPCookies, HTTPHeaders, HTTPParam, HTTPQueries, HTTPQuery, HTTPRequest } from "./HTTPParam.js";
+
+export {  };

package/dist/decorator/index.d.ts

@@ -0,0 +1,14 @@
+import { Host } from "./http/Host.js";
+import { HTTPController } from "./http/HTTPController.js";
+import { HTTPMethod } from "./http/HTTPMethod.js";
+import { InjectContext } from "./Context.js";
+import { HTTPBody, HTTPCookies, HTTPHeaders, HTTPParam, HTTPQueries, HTTPQuery, HTTPRequest } from "./http/HTTPParam.js";
+import "./http/index.js";
+import { Extra } from "./mcp/Extra.js";
+import { MCPController } from "./mcp/MCPController.js";
+import { MCPPrompt, PromptArgsSchema } from "./mcp/MCPPrompt.js";
+import { MCPResource } from "./mcp/MCPResource.js";
+import { MCPTool, ToolArgsSchema } from "./mcp/MCPTool.js";
+import "./mcp/index.js";
+import { Acl } from "./Acl.js";
+import { Middleware } from "./Middleware.js";

package/dist/decorator/index.js

@@ -0,0 +1,16 @@
+import { Host } from "./http/Host.js";
+import { HTTPController } from "./http/HTTPController.js";
+import { HTTPMethod } from "./http/HTTPMethod.js";
+import { InjectContext } from "./Context.js";
+import { HTTPBody, HTTPCookies, HTTPHeaders, HTTPParam, HTTPQueries, HTTPQuery, HTTPRequest } from "./http/HTTPParam.js";
+import "./http/index.js";
+import { Extra } from "./mcp/Extra.js";
+import { MCPController } from "./mcp/MCPController.js";
+import { MCPPrompt, PromptArgsSchema } from "./mcp/MCPPrompt.js";
+import { MCPResource } from "./mcp/MCPResource.js";
+import { MCPTool, ToolArgsSchema } from "./mcp/MCPTool.js";
+import "./mcp/index.js";
+import { Acl } from "./Acl.js";
+import { Middleware } from "./Middleware.js";
+
+export {  };

package/dist/decorator/mcp/Extra.d.ts

@@ -0,0 +1,4 @@
+//#region src/decorator/mcp/Extra.d.ts
+declare function Extra(): (target: any, propertyKey: PropertyKey, parameterIndex: number) => void;
+//#endregion
+export { Extra };

package/dist/decorator/mcp/Extra.js

@@ -0,0 +1,13 @@
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+
+//#region src/decorator/mcp/Extra.ts
+function Extra() {
+	return function(target, propertyKey, parameterIndex) {
+		const controllerClazz = target.constructor;
+		const methodName = propertyKey;
+		MCPInfoUtil.setMCPExtra(parameterIndex, controllerClazz, methodName);
+	};
+}
+
+//#endregion
+export { Extra };

package/dist/decorator/mcp/MCPController.d.ts

@@ -0,0 +1,6 @@
+import { EggProtoImplClass, MCPControllerParams } from "@eggjs/tegg-types";
+
+//#region src/decorator/mcp/MCPController.d.ts
+declare function MCPController(param?: MCPControllerParams): (constructor: EggProtoImplClass) => void;
+//#endregion
+export { MCPController };

package/dist/decorator/mcp/MCPController.js

@@ -0,0 +1,24 @@
+import { ControllerInfoUtil } from "../../util/ControllerInfoUtil.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { PrototypeUtil, SingletonProto } from "@eggjs/core-decorator";
+import { AccessLevel, ControllerType } from "@eggjs/tegg-types";
+import { StackUtil } from "@eggjs/tegg-common-util";
+
+//#region src/decorator/mcp/MCPController.ts
+function MCPController(param) {
+	return function(constructor) {
+		SingletonProto({
+			accessLevel: AccessLevel.PUBLIC,
+			name: param?.protoName
+		})(constructor);
+		ControllerInfoUtil.setControllerType(constructor, ControllerType.MCP);
+		if (param?.controllerName) ControllerInfoUtil.setControllerName(constructor, param?.controllerName);
+		PrototypeUtil.setFilePath(constructor, StackUtil.getCalleeFromStack(false, 5));
+		if (param?.name) MCPInfoUtil.setMCPName(param.name, constructor);
+		if (param?.version) MCPInfoUtil.setMCPVersion(param.version, constructor);
+		MCPInfoUtil.setMCPControllerParams(param, constructor);
+	};
+}
+
+//#endregion
+export { MCPController };

package/dist/decorator/mcp/MCPPrompt.d.ts

@@ -0,0 +1,8 @@
+import { MCPPromptParams } from "@eggjs/tegg-types";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/decorator/mcp/MCPPrompt.d.ts
+declare function MCPPrompt(params?: MCPPromptParams): (target: any, propertyKey: PropertyKey) => void;
+declare function PromptArgsSchema(argsSchema: Parameters<McpServer["prompt"]>["2"]): (target: any, propertyKey: PropertyKey, parameterIndex: number) => void;
+//#endregion
+export { MCPPrompt, PromptArgsSchema };

package/dist/decorator/mcp/MCPPrompt.js

@@ -0,0 +1,31 @@
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { ControllerType } from "@eggjs/tegg-types";
+
+//#region src/decorator/mcp/MCPPrompt.ts
+function MCPPrompt(params) {
+	return function(target, propertyKey) {
+		const controllerClazz = target.constructor;
+		const methodName = propertyKey;
+		MethodInfoUtil.setMethodControllerType(controllerClazz, methodName, ControllerType.MCP);
+		MCPInfoUtil.setMCPPromptParams({
+			...params,
+			mcpName: params?.name,
+			name: methodName
+		}, controllerClazz, methodName);
+		MCPInfoUtil.setMCPPrompt(controllerClazz, methodName);
+	};
+}
+function PromptArgsSchema(argsSchema) {
+	return function(target, propertyKey, parameterIndex) {
+		const controllerClazz = target.constructor;
+		const methodName = propertyKey;
+		MCPInfoUtil.setMCPPromptArgsInArgs({
+			argsSchema,
+			index: parameterIndex
+		}, controllerClazz, methodName);
+	};
+}
+
+//#endregion
+export { MCPPrompt, PromptArgsSchema };

package/dist/decorator/mcp/MCPResource.d.ts

@@ -0,0 +1,6 @@
+import { MCPResourceParams } from "@eggjs/tegg-types";
+
+//#region src/decorator/mcp/MCPResource.d.ts
+declare function MCPResource(params: MCPResourceParams): (target: any, propertyKey: PropertyKey) => void;
+//#endregion
+export { MCPResource };

package/dist/decorator/mcp/MCPResource.js

@@ -0,0 +1,21 @@
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { ControllerType } from "@eggjs/tegg-types";
+
+//#region src/decorator/mcp/MCPResource.ts
+function MCPResource(params) {
+	return function(target, propertyKey) {
+		const controllerClazz = target.constructor;
+		const methodName = propertyKey;
+		MethodInfoUtil.setMethodControllerType(controllerClazz, methodName, ControllerType.MCP);
+		MCPInfoUtil.setMCPResourceParams({
+			...params,
+			mcpName: params.name,
+			name: methodName
+		}, controllerClazz, methodName);
+		MCPInfoUtil.setMCPResource(controllerClazz, methodName);
+	};
+}
+
+//#endregion
+export { MCPResource };

package/dist/decorator/mcp/MCPTool.d.ts

@@ -0,0 +1,8 @@
+import { MCPToolParams } from "@eggjs/tegg-types";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/decorator/mcp/MCPTool.d.ts
+declare function MCPTool(params?: MCPToolParams): (target: any, propertyKey: PropertyKey) => void;
+declare function ToolArgsSchema(argsSchema: Parameters<McpServer["tool"]>["2"]): (target: any, propertyKey: PropertyKey, parameterIndex: number) => void;
+//#endregion
+export { MCPTool, ToolArgsSchema };

package/dist/decorator/mcp/MCPTool.js

@@ -0,0 +1,31 @@
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { ControllerType } from "@eggjs/tegg-types";
+
+//#region src/decorator/mcp/MCPTool.ts
+function MCPTool(params) {
+	return function(target, propertyKey) {
+		const controllerClazz = target.constructor;
+		const methodName = propertyKey;
+		MethodInfoUtil.setMethodControllerType(controllerClazz, methodName, ControllerType.MCP);
+		MCPInfoUtil.setMCPToolParams({
+			...params,
+			mcpName: params?.name,
+			name: methodName
+		}, controllerClazz, methodName);
+		MCPInfoUtil.setMCPTool(controllerClazz, methodName);
+	};
+}
+function ToolArgsSchema(argsSchema) {
+	return function(target, propertyKey, parameterIndex) {
+		const controllerClazz = target.constructor;
+		const methodName = propertyKey;
+		MCPInfoUtil.setMCPToolArgsInArgs({
+			argsSchema,
+			index: parameterIndex
+		}, controllerClazz, methodName);
+	};
+}
+
+//#endregion
+export { MCPTool, ToolArgsSchema };

package/dist/decorator/mcp/index.d.ts

@@ -0,0 +1,5 @@
+import { Extra } from "./Extra.js";
+import { MCPController } from "./MCPController.js";
+import { MCPPrompt, PromptArgsSchema } from "./MCPPrompt.js";
+import { MCPResource } from "./MCPResource.js";
+import { MCPTool, ToolArgsSchema } from "./MCPTool.js";

package/dist/decorator/mcp/index.js

@@ -0,0 +1,7 @@
+import { Extra } from "./Extra.js";
+import { MCPController } from "./MCPController.js";
+import { MCPPrompt, PromptArgsSchema } from "./MCPPrompt.js";
+import { MCPResource } from "./MCPResource.js";
+import { MCPTool, ToolArgsSchema } from "./MCPTool.js";
+
+export {  };

package/dist/impl/http/HTTPControllerMetaBuilder.d.ts

@@ -0,0 +1,14 @@
+import { HTTPControllerMeta } from "../../model/HTTPControllerMeta.js";
+import "../../model/index.js";
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/impl/http/HTTPControllerMetaBuilder.d.ts
+declare class HTTPControllerMetaBuilder {
+  private readonly clazz;
+  constructor(clazz: EggProtoImplClass);
+  private buildMethod;
+  build(): HTTPControllerMeta;
+  static create(clazz: EggProtoImplClass): HTTPControllerMetaBuilder;
+}
+//#endregion
+export { HTTPControllerMetaBuilder };

package/dist/impl/http/HTTPControllerMetaBuilder.js

@@ -0,0 +1,60 @@
+import { ControllerInfoUtil } from "../../util/ControllerInfoUtil.js";
+import { ControllerValidator } from "../../util/validator/ControllerValidator.js";
+import { ControllerMetadataUtil } from "../../util/ControllerMetadataUtil.js";
+import { HTTPInfoUtil } from "../../util/HTTPInfoUtil.js";
+import "../../util/index.js";
+import { ControllerMetaBuilderFactory } from "../../builder/ControllerMetaBuilderFactory.js";
+import "../../builder/index.js";
+import { HTTPControllerMeta } from "../../model/HTTPControllerMeta.js";
+import "../../model/index.js";
+import { HTTPControllerMethodMetaBuilder } from "./HTTPControllerMethodMetaBuilder.js";
+import { ClassUtil } from "@eggjs/metadata";
+import { PrototypeUtil } from "@eggjs/core-decorator";
+import { ControllerType } from "@eggjs/tegg-types";
+import { ObjectUtils } from "@eggjs/tegg-common-util";
+import assert from "node:assert";
+
+//#region src/impl/http/HTTPControllerMetaBuilder.ts
+var HTTPControllerMetaBuilder = class HTTPControllerMetaBuilder {
+	clazz;
+	constructor(clazz) {
+		this.clazz = clazz;
+	}
+	buildMethod() {
+		const methodNames = ObjectUtils.getProperties(this.clazz.prototype);
+		const methods = [];
+		for (const methodName of methodNames) {
+			const methodMeta = new HTTPControllerMethodMetaBuilder(this.clazz, methodName).build();
+			if (methodMeta) methods.push(methodMeta);
+		}
+		return methods;
+	}
+	build() {
+		ControllerValidator.validate(this.clazz);
+		const controllerType = ControllerInfoUtil.getControllerType(this.clazz);
+		assert.equal(controllerType, ControllerType.HTTP, "invalidate controller type");
+		const httpPath = HTTPInfoUtil.getHTTPPath(this.clazz);
+		const httpMiddlewares = ControllerInfoUtil.getControllerMiddlewares(this.clazz);
+		const methods = this.buildMethod();
+		const clazzName = this.clazz.name;
+		const controllerName = ControllerInfoUtil.getControllerName(this.clazz) || clazzName;
+		const protoName = PrototypeUtil.getProperty(this.clazz).name;
+		const metadata = new HTTPControllerMeta(clazzName, protoName, controllerName, httpPath, httpMiddlewares, methods, ControllerInfoUtil.hasControllerAcl(this.clazz), ControllerInfoUtil.getControllerAcl(this.clazz), ControllerInfoUtil.getControllerHosts(this.clazz), ControllerInfoUtil.getControllerTimeout(this.clazz));
+		ControllerMetadataUtil.setControllerMetadata(this.clazz, metadata);
+		for (const method of metadata.methods) {
+			const realPath = metadata.getMethodRealPath(method);
+			if (!realPath.startsWith("/")) {
+				const desc = ClassUtil.classDescription(this.clazz);
+				throw new Error(`class ${desc} method ${method.name} path ${realPath} not start with /`);
+			}
+		}
+		return metadata;
+	}
+	static create(clazz) {
+		return new HTTPControllerMetaBuilder(clazz);
+	}
+};
+ControllerMetaBuilderFactory.registerControllerMetaBuilder(ControllerType.HTTP, HTTPControllerMetaBuilder.create);
+
+//#endregion
+export { HTTPControllerMetaBuilder };

package/dist/impl/http/HTTPControllerMethodMetaBuilder.d.ts

@@ -0,0 +1,16 @@
+import { HTTPMethodMeta } from "../../model/HTTPMethodMeta.js";
+import "../../model/index.js";
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/impl/http/HTTPControllerMethodMetaBuilder.d.ts
+declare class HTTPControllerMethodMetaBuilder {
+  private readonly clazz;
+  private readonly methodName;
+  constructor(clazz: EggProtoImplClass, methodName: string);
+  private checkParamDecorators;
+  private buildParamType;
+  getPriority(): number;
+  build(): HTTPMethodMeta | undefined;
+}
+//#endregion
+export { HTTPControllerMethodMetaBuilder };

package/dist/impl/http/HTTPControllerMethodMetaBuilder.js

@@ -0,0 +1,81 @@
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { MethodValidator } from "../../util/validator/MethodValidator.js";
+import { HTTPInfoUtil } from "../../util/HTTPInfoUtil.js";
+import { HTTPPriorityUtil } from "../../util/HTTPPriorityUtil.js";
+import "../../util/index.js";
+import { HTTPMethodMeta, ParamMetaUtil } from "../../model/HTTPMethodMeta.js";
+import "../../model/index.js";
+import { ClassUtil } from "@eggjs/metadata";
+import path from "node:path";
+
+//#region src/impl/http/HTTPControllerMethodMetaBuilder.ts
+var HTTPControllerMethodMetaBuilder = class {
+	clazz;
+	methodName;
+	constructor(clazz, methodName) {
+		this.clazz = clazz;
+		this.methodName = methodName;
+	}
+	checkParamDecorators() {
+		const functionLength = this.clazz.prototype[this.methodName].length;
+		const paramIndexList = HTTPInfoUtil.getParamIndexList(this.clazz, this.methodName);
+		const contextIndex = MethodInfoUtil.getMethodContextIndex(this.clazz, this.methodName);
+		const hasAnnotationParamCount = typeof contextIndex === "undefined" ? paramIndexList.length : paramIndexList.length + 1;
+		const maxParamCount = Math.max(functionLength, hasAnnotationParamCount);
+		for (let i = 0; i < maxParamCount; ++i) {
+			if (i === contextIndex) continue;
+			if (!HTTPInfoUtil.getHTTPMethodParamType(i, this.clazz, this.methodName)) {
+				const classDesc = ClassUtil.classDescription(this.clazz);
+				throw new Error(`${classDesc}:${this.methodName} param ${i} has no http param type, Please add @HTTPBody, @HTTPParam, @HTTPQuery, @HTTPQueries`);
+			}
+		}
+	}
+	buildParamType(httpPath) {
+		this.checkParamDecorators();
+		const paramTypeMap = /* @__PURE__ */ new Map();
+		const paramIndexList = HTTPInfoUtil.getParamIndexList(this.clazz, this.methodName);
+		for (const paramIndex of paramIndexList) {
+			const paramType = HTTPInfoUtil.getHTTPMethodParamType(paramIndex, this.clazz, this.methodName);
+			const paramName = HTTPInfoUtil.getHTTPMethodParamName(paramIndex, this.clazz, this.methodName);
+			const paramMeta = ParamMetaUtil.createParam(paramType, paramName);
+			try {
+				paramMeta.validate(httpPath);
+			} catch (e) {
+				e.message = `build controller ${ClassUtil.classDescription(this.clazz)} method ${this.methodName} param ${paramName} failed: ${e.message}`;
+				throw e;
+			}
+			paramTypeMap.set(paramIndex, paramMeta);
+		}
+		return paramTypeMap;
+	}
+	getPriority() {
+		const priority = HTTPInfoUtil.getHTTPMethodPriority(this.clazz, this.methodName);
+		if (priority !== void 0) return priority;
+		const controllerPath = HTTPInfoUtil.getHTTPPath(this.clazz);
+		const methodPath = HTTPInfoUtil.getHTTPMethodPath(this.clazz, this.methodName);
+		const realPath = controllerPath ? path.posix.join(controllerPath, methodPath) : methodPath;
+		const defaultPriority = HTTPPriorityUtil.calcPathPriority(realPath);
+		if (defaultPriority > HTTPPriorityUtil.DEFAULT_PRIORITY) throw new Error(`path ${realPath} is too long, should set priority manually`);
+		return defaultPriority;
+	}
+	build() {
+		MethodValidator.validate(this.clazz, this.methodName);
+		if (!MethodInfoUtil.getMethodControllerType(this.clazz, this.methodName)) return;
+		const httpMethod = HTTPInfoUtil.getHTTPMethodMethod(this.clazz, this.methodName);
+		const parentPath = HTTPInfoUtil.getHTTPPath(this.clazz);
+		const httpPath = HTTPInfoUtil.getHTTPMethodPath(this.clazz, this.methodName);
+		const contextIndex = MethodInfoUtil.getMethodContextIndex(this.clazz, this.methodName);
+		const middlewares = MethodInfoUtil.getMethodMiddlewares(this.clazz, this.methodName);
+		const needAcl = MethodInfoUtil.hasMethodAcl(this.clazz, this.methodName);
+		const aclCode = MethodInfoUtil.getMethodAcl(this.clazz, this.methodName);
+		const hosts = MethodInfoUtil.getMethodHosts(this.clazz, this.methodName);
+		const timeout = MethodInfoUtil.getMethodTimeout(this.clazz, this.methodName);
+		const realPath = parentPath ? path.posix.join(parentPath, httpPath) : httpPath;
+		const paramTypeMap = this.buildParamType(realPath);
+		const priority = this.getPriority();
+		return new HTTPMethodMeta(this.methodName, httpPath, httpMethod, middlewares, contextIndex, paramTypeMap, priority, needAcl, aclCode, hosts, timeout);
+	}
+};
+
+//#endregion
+export { HTTPControllerMethodMetaBuilder };

package/dist/impl/http/index.d.ts

@@ -0,0 +1,2 @@
+import { HTTPControllerMetaBuilder } from "./HTTPControllerMetaBuilder.js";
+import { HTTPControllerMethodMetaBuilder } from "./HTTPControllerMethodMetaBuilder.js";

package/dist/impl/http/index.js

@@ -0,0 +1,4 @@
+import { HTTPControllerMethodMetaBuilder } from "./HTTPControllerMethodMetaBuilder.js";
+import { HTTPControllerMetaBuilder } from "./HTTPControllerMetaBuilder.js";
+
+export {  };

package/dist/impl/index.d.ts

@@ -0,0 +1,8 @@
+import { HTTPControllerMetaBuilder } from "./http/HTTPControllerMetaBuilder.js";
+import { HTTPControllerMethodMetaBuilder } from "./http/HTTPControllerMethodMetaBuilder.js";
+import "./http/index.js";
+import { MCPControllerMetaBuilder } from "./mcp/MCPControllerMetaBuilder.js";
+import { MCPControllerPromptMetaBuilder } from "./mcp/MCPControllerPromptMetaBuilder.js";
+import { MCPControllerResourceMetaBuilder } from "./mcp/MCPControllerResourceMetaBuilder.js";
+import { MCPControllerToolMetaBuilder } from "./mcp/MCPControllerToolMetaBuilder.js";
+import "./mcp/index.js";

package/dist/impl/index.js

@@ -0,0 +1,10 @@
+import { HTTPControllerMethodMetaBuilder } from "./http/HTTPControllerMethodMetaBuilder.js";
+import { HTTPControllerMetaBuilder } from "./http/HTTPControllerMetaBuilder.js";
+import "./http/index.js";
+import { MCPControllerPromptMetaBuilder } from "./mcp/MCPControllerPromptMetaBuilder.js";
+import { MCPControllerResourceMetaBuilder } from "./mcp/MCPControllerResourceMetaBuilder.js";
+import { MCPControllerToolMetaBuilder } from "./mcp/MCPControllerToolMetaBuilder.js";
+import { MCPControllerMetaBuilder } from "./mcp/MCPControllerMetaBuilder.js";
+import "./mcp/index.js";
+
+export {  };

package/dist/impl/mcp/MCPControllerMetaBuilder.d.ts

@@ -0,0 +1,15 @@
+import { MCPControllerMeta } from "../../model/MCPControllerMeta.js";
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/impl/mcp/MCPControllerMetaBuilder.d.ts
+declare class MCPControllerMetaBuilder {
+  private readonly clazz;
+  constructor(clazz: EggProtoImplClass);
+  private buildResource;
+  private buildPrompt;
+  private buildTool;
+  build(): MCPControllerMeta;
+  static create(clazz: EggProtoImplClass): MCPControllerMetaBuilder;
+}
+//#endregion
+export { MCPControllerMetaBuilder };

package/dist/impl/mcp/MCPControllerMetaBuilder.js

@@ -0,0 +1,67 @@
+import { ControllerInfoUtil } from "../../util/ControllerInfoUtil.js";
+import { ControllerValidator } from "../../util/validator/ControllerValidator.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { ControllerMetaBuilderFactory } from "../../builder/ControllerMetaBuilderFactory.js";
+import { MCPControllerMeta } from "../../model/MCPControllerMeta.js";
+import "../../model/index.js";
+import { MCPControllerPromptMetaBuilder } from "./MCPControllerPromptMetaBuilder.js";
+import { MCPControllerResourceMetaBuilder } from "./MCPControllerResourceMetaBuilder.js";
+import { MCPControllerToolMetaBuilder } from "./MCPControllerToolMetaBuilder.js";
+import { PrototypeUtil } from "@eggjs/core-decorator";
+import { ControllerType } from "@eggjs/tegg-types";
+import assert from "node:assert";
+
+//#region src/impl/mcp/MCPControllerMetaBuilder.ts
+var MCPControllerMetaBuilder = class MCPControllerMetaBuilder {
+	clazz;
+	constructor(clazz) {
+		this.clazz = clazz;
+	}
+	buildResource() {
+		const methodNames = MCPInfoUtil.getMCPResource(this.clazz);
+		const methods = [];
+		for (const methodName of methodNames) {
+			const methodMeta = new MCPControllerResourceMetaBuilder(this.clazz, methodName).build();
+			if (methodMeta) methods.push(methodMeta);
+		}
+		return methods;
+	}
+	buildPrompt() {
+		const methodNames = MCPInfoUtil.getMCPPrompt(this.clazz);
+		const methods = [];
+		for (const methodName of methodNames) {
+			const methodMeta = new MCPControllerPromptMetaBuilder(this.clazz, methodName).build();
+			if (methodMeta) methods.push(methodMeta);
+		}
+		return methods;
+	}
+	buildTool() {
+		const methodNames = MCPInfoUtil.getMCPTool(this.clazz);
+		const methods = [];
+		for (const methodName of methodNames) {
+			const methodMeta = new MCPControllerToolMetaBuilder(this.clazz, methodName).build();
+			if (methodMeta) methods.push(methodMeta);
+		}
+		return methods;
+	}
+	build() {
+		ControllerValidator.validate(this.clazz);
+		assert(ControllerInfoUtil.getControllerType(this.clazz) === ControllerType.MCP, "invalidate controller type");
+		const mcpMiddlewares = ControllerInfoUtil.getControllerMiddlewares(this.clazz);
+		const resources = this.buildResource();
+		const prompts = this.buildPrompt();
+		const tools = this.buildTool();
+		const protoName = PrototypeUtil.getProperty(this.clazz).name;
+		const clazzName = this.clazz.name;
+		const controllerName = ControllerInfoUtil.getControllerName(this.clazz) || clazzName;
+		const name = MCPInfoUtil.getMCPName(this.clazz);
+		return new MCPControllerMeta(clazzName, protoName, controllerName, MCPInfoUtil.getMCPVersion(this.clazz) || "1.0.0", tools, resources, prompts, mcpMiddlewares, name, ControllerInfoUtil.hasControllerAcl(this.clazz), ControllerInfoUtil.getControllerAcl(this.clazz), MCPInfoUtil.getMCPControllerParams(this.clazz));
+	}
+	static create(clazz) {
+		return new MCPControllerMetaBuilder(clazz);
+	}
+};
+ControllerMetaBuilderFactory.registerControllerMetaBuilder(ControllerType.MCP, MCPControllerMetaBuilder.create);
+
+//#endregion
+export { MCPControllerMetaBuilder };

package/dist/impl/mcp/MCPControllerPromptMetaBuilder.d.ts

@@ -0,0 +1,13 @@
+import { MCPPromptMeta } from "../../model/MCPPromptMeta.js";
+import "../../model/index.js";
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/impl/mcp/MCPControllerPromptMetaBuilder.d.ts
+declare class MCPControllerPromptMetaBuilder {
+  private readonly clazz;
+  private readonly methodName;
+  constructor(clazz: EggProtoImplClass, methodName: string);
+  build(): MCPPromptMeta | undefined;
+}
+//#endregion
+export { MCPControllerPromptMetaBuilder };

package/dist/impl/mcp/MCPControllerPromptMetaBuilder.js

@@ -0,0 +1,37 @@
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { MethodValidator } from "../../util/validator/MethodValidator.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { MCPPromptMeta } from "../../model/MCPPromptMeta.js";
+import "../../model/index.js";
+
+//#region src/impl/mcp/MCPControllerPromptMetaBuilder.ts
+var MCPControllerPromptMetaBuilder = class {
+	clazz;
+	methodName;
+	constructor(clazz, methodName) {
+		this.clazz = clazz;
+		this.methodName = methodName;
+	}
+	build() {
+		MethodValidator.validate(this.clazz, this.methodName);
+		if (!MethodInfoUtil.getMethodControllerType(this.clazz, this.methodName)) return;
+		const middlewares = MethodInfoUtil.getMethodMiddlewares(this.clazz, this.methodName);
+		const needAcl = MethodInfoUtil.hasMethodAcl(this.clazz, this.methodName);
+		const aclCode = MethodInfoUtil.getMethodAcl(this.clazz, this.methodName);
+		const params = MCPInfoUtil.getMCPPromptParams(this.clazz, this.methodName);
+		const detail = MCPInfoUtil.getMCPPromptArgsIndex(this.clazz, this.methodName);
+		const extra = MCPInfoUtil.getMCPExtra(this.clazz, this.methodName);
+		return new MCPPromptMeta({
+			name: this.methodName,
+			middlewares,
+			needAcl,
+			aclCode,
+			detail,
+			extra,
+			...params
+		});
+	}
+};
+
+//#endregion
+export { MCPControllerPromptMetaBuilder };

package/dist/impl/mcp/MCPControllerResourceMetaBuilder.d.ts

@@ -0,0 +1,13 @@
+import { MCPResourceMeta } from "../../model/MCPResourceMeta.js";
+import "../../model/index.js";
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/impl/mcp/MCPControllerResourceMetaBuilder.d.ts
+declare class MCPControllerResourceMetaBuilder {
+  private readonly clazz;
+  private readonly methodName;
+  constructor(clazz: EggProtoImplClass, methodName: string);
+  build(): MCPResourceMeta | undefined;
+}
+//#endregion
+export { MCPControllerResourceMetaBuilder };

package/dist/impl/mcp/MCPControllerResourceMetaBuilder.js

@@ -0,0 +1,35 @@
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { MethodValidator } from "../../util/validator/MethodValidator.js";
+import { MCPInfoUtil } from "../../util/MCPInfoUtil.js";
+import { MCPResourceMeta } from "../../model/MCPResourceMeta.js";
+import "../../model/index.js";
+
+//#region src/impl/mcp/MCPControllerResourceMetaBuilder.ts
+var MCPControllerResourceMetaBuilder = class {
+	clazz;
+	methodName;
+	constructor(clazz, methodName) {
+		this.clazz = clazz;
+		this.methodName = methodName;
+	}
+	build() {
+		MethodValidator.validate(this.clazz, this.methodName);
+		if (!MethodInfoUtil.getMethodControllerType(this.clazz, this.methodName)) return;
+		const middlewares = MethodInfoUtil.getMethodMiddlewares(this.clazz, this.methodName);
+		const needAcl = MethodInfoUtil.hasMethodAcl(this.clazz, this.methodName);
+		const aclCode = MethodInfoUtil.getMethodAcl(this.clazz, this.methodName);
+		const params = MCPInfoUtil.getMCPResourceParams(this.clazz, this.methodName);
+		const extra = MCPInfoUtil.getMCPExtra(this.clazz, this.methodName);
+		return new MCPResourceMeta({
+			name: this.methodName,
+			middlewares,
+			needAcl,
+			aclCode,
+			extra,
+			...params
+		});
+	}
+};
+
+//#endregion
+export { MCPControllerResourceMetaBuilder };

package/dist/impl/mcp/MCPControllerToolMetaBuilder.d.ts

@@ -0,0 +1,13 @@
+import { MCPToolMeta } from "../../model/MCPToolMeta.js";
+import "../../model/index.js";
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/impl/mcp/MCPControllerToolMetaBuilder.d.ts
+declare class MCPControllerToolMetaBuilder {
+  private readonly clazz;
+  private readonly methodName;
+  constructor(clazz: EggProtoImplClass, methodName: string);
+  build(): MCPToolMeta | undefined;
+}
+//#endregion
+export { MCPControllerToolMetaBuilder };