imean-service-engine 2.0.0 → 2.0.2

package/dist/index.mjs

@@ -1,10 +1,6 @@
-import { serve } from '@hono/node-server';
-import { Hono } from 'hono';
-export { Context, MiddlewareHandler } from 'hono';
-import * as net from 'net';
 import winston, { format } from 'winston';
 import { html } from 'hono/html';
-import { jsx } from 'hono/jsx/jsx-runtime';
+import { jsx, jsxs } from 'hono/jsx/jsx-runtime';
 import * as ejson from 'ejson';
 import { z } from 'zod';
 export { z } from 'zod';
@@ -12,6 +8,10 @@ import { createHash } from 'crypto';
 import { promises } from 'fs';
 import { dirname } from 'path';
 import prettier from 'prettier';
+import { serve } from '@hono/node-server';
+import { Hono } from 'hono';
+export { Context, MiddlewareHandler } from 'hono';
+import * as net from 'net';
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -1643,6 +1643,17 @@ var require_src = __commonJS({
   }
 });
 
+// src/core/types.ts
+var PluginPriority = /* @__PURE__ */ ((PluginPriority2) => {
+  PluginPriority2[PluginPriority2["SYSTEM"] = 50] = "SYSTEM";
+  PluginPriority2[PluginPriority2["SECURITY"] = 100] = "SECURITY";
+  PluginPriority2[PluginPriority2["LOGGING"] = 200] = "LOGGING";
+  PluginPriority2[PluginPriority2["BUSINESS"] = 300] = "BUSINESS";
+  PluginPriority2[PluginPriority2["PERFORMANCE"] = 400] = "PERFORMANCE";
+  PluginPriority2[PluginPriority2["ROUTE"] = 1e3] = "ROUTE";
+  return PluginPriority2;
+})(PluginPriority || {});
+
 // src/metadata/metadata.ts
 var DECORATED_KEYS_KEY = /* @__PURE__ */ Symbol.for("imean:decoratedKeys");
 var keyToClassesMap = /* @__PURE__ */ new Map();
@@ -1857,2234 +1868,2355 @@ var logger = winston.createLogger({
 });
 var logger_default = logger;
 
-// src/core/engine.ts
-var Microservice = class {
-  // 存储已注册的模块
-  modules = [];
-  // 存储已注册的插件（按注册顺序）
-  plugins = [];
-  // 插件注册表（以name为键，用于覆盖逻辑）
-  pluginRegistry = /* @__PURE__ */ new Map();
-  // 模块实例缓存（单例管理）
-  moduleInstances = /* @__PURE__ */ new Map();
-  // 引擎配置（冻结，只读）
-  options;
-  // 是否已启动
-  started = false;
-  // 模块元数据键（用于通过双向访问查找模块）
-  moduleMetadataKey;
-  // 实际使用的端口（启动后设置）
-  actualPort = null;
-  // Hono 实例（由引擎统一管理）
-  hono = new Hono();
-  // HTTP 服务器实例
-  server = null;
-  constructor(options, moduleMetadataKey) {
-    this.options = Object.freeze({
-      hostname: "0.0.0.0",
-      ...options
-    });
-    this.moduleMetadataKey = moduleMetadataKey;
+// src/core/checker.ts
+async function startCheck(checkers, pass) {
+  logger_default.info("[ \u9884\u68C0\u5F00\u59CB ]");
+  for (const [index, checker] of checkers.entries()) {
+    const seq = index + 1;
+    logger_default.info(`${seq}. ${checker.name}`);
+    try {
+      if (checker.skip) {
+        logger_default.warn(`${seq}. ${checker.name} [\u8DF3\u8FC7]`);
+        continue;
+      }
+      await checker.check();
+      logger_default.info(`${seq}. ${checker.name} [\u6210\u529F]`);
+    } catch (error) {
+      logger_default.error(`${seq}. ${checker.name} [\u5931\u8D25]`);
+      throw error;
+    }
+  }
+  logger_default.info("[ \u9884\u68C0\u5B8C\u6210 ]");
+  if (pass) await pass();
+}
+var DEFAULT_FAVICON = /* @__PURE__ */ jsx(
+  "link",
+  {
+    rel: "icon",
+    href: "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100' width='100' height='100'><defs><linearGradient id='nodeGradient' x1='0%' y1='0%' x2='100%' y2='100%'><stop offset='0%' stop-color='%233498db'/><stop offset='100%' stop-color='%232980b9'/></linearGradient><linearGradient id='centerNodeGradient' x1='0%' y1='0%' x2='100%' y2='100%'><stop offset='0%' stop-color='%232ecc71'/><stop offset='100%' stop-color='%2327ae60'/></linearGradient></defs><circle cx='50' cy='50' r='45' fill='%23f5f7fa'/><path d='M30,30 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><path d='M70,30 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><path d='M30,70 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><path d='M70,70 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><polygon points='30,15 45,25 45,45 30,55 15,45 15,25' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='70,15 85,25 85,45 70,55 55,45 55,25' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='30,45 45,55 45,75 30,85 15,75 15,55' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='70,45 85,55 85,75 70,85 55,75 55,55' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='50,30 65,40 65,60 50,70 35,60 35,40' fill='url(%23centerNodeGradient)' stroke='%2327ae60' stroke-width='2'/><circle cx='30' cy='30' r='3' fill='%23ffffff'/><circle cx='70' cy='30' r='3' fill='%23ffffff'/><circle cx='30' cy='70' r='3' fill='%23ffffff'/><circle cx='70' cy='70' r='3' fill='%23ffffff'/><circle cx='50' cy='50' r='4' fill='%23ffffff'/></svg>",
+    type: "image/svg+xml"
+  }
+);
+var BaseLayout = (props = {
+  title: "Microservice Template"
+}) => html`<!DOCTYPE html>
+    <html>
+      <head>
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>${props.title}</title>
+        ${props.heads}
+      </head>
+      <body>
+        ${props.children}
+      </body>
+    </html>`;
+var HtmxLayout = (props = {
+  title: "Microservice Template"
+}) => BaseLayout({
+  title: props.title,
+  heads: html`
+      <script src="https://unpkg.com/htmx.org@latest"></script>
+      <script src="https://unpkg.com/hyperscript.org@latest"></script>
+      <script src="https://cdn.tailwindcss.com"></script>
+      ${props.favicon || DEFAULT_FAVICON}
+    `,
+  children: props.children
+});
+var InfoCard = ({
+  icon,
+  iconColor,
+  bgColor,
+  label,
+  value
+}) => /* @__PURE__ */ jsxs("div", { className: `${bgColor} p-4 rounded-lg`, children: [
+  /* @__PURE__ */ jsxs("div", { className: "flex items-center mb-2", children: [
+    /* @__PURE__ */ jsx(
+      "svg",
+      {
+        className: `w-5 h-5 ${iconColor} mr-2`,
+        fill: "none",
+        stroke: "currentColor",
+        viewBox: "0 0 24 24",
+        children: /* @__PURE__ */ jsx(
+          "path",
+          {
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            strokeWidth: 2,
+            d: icon
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-gray-600", children: label })
+  ] }),
+  /* @__PURE__ */ jsx("p", { className: `text-xl font-semibold text-gray-900`, children: value })
+] });
+var getEnvironmentBadgeClass = (env) => {
+  const normalizedEnv = env.toLowerCase();
+  switch (normalizedEnv) {
+    case "production":
+    case "prod":
+      return "bg-red-100 text-red-800";
+    case "staging":
+    case "stg":
+      return "bg-yellow-100 text-yellow-800";
+    case "development":
+    case "dev":
+    default:
+      return "bg-blue-100 text-blue-800";
   }
+};
+var getStatusBadgeClass = (status) => {
+  switch (status.toLowerCase()) {
+    case "running":
+      return "bg-green-100 text-green-800";
+    case "stopped":
+      return "bg-gray-100 text-gray-800";
+    case "error":
+      return "bg-red-100 text-red-800";
+    default:
+      return "bg-blue-100 text-blue-800";
+  }
+};
+var ServiceInfoCards = ({
+  serviceInfo
+}) => {
+  const env = serviceInfo.env || typeof process !== "undefined" && process.env?.NODE_ENV || "dev";
+  const status = serviceInfo.status || "running";
+  const infoCards = [
+    {
+      icon: "M7 4V2a1 1 0 011-1h8a1 1 0 011 1v2m-9 0h10m-10 0a2 2 0 00-2 2v14a2 2 0 002 2h10a2 2 0 002-2V6a2 2 0 00-2-2",
+      iconColor: "text-blue-600",
+      bgColor: "bg-blue-50",
+      label: "\u670D\u52A1\u540D\u79F0",
+      value: serviceInfo.name
+    },
+    {
+      icon: "M13.828 10.172a4 4 0 00-5.656 0l-4 4a4 4 0 105.656 5.656l1.102-1.101m-.758-4.899a4 4 0 005.656 0l4-4a4 4 0 00-5.656-5.656l-1.1 1.1",
+      iconColor: "text-orange-600",
+      bgColor: "bg-orange-50",
+      label: "\u670D\u52A1\u8DEF\u5F84",
+      value: serviceInfo.prefix || "/"
+    },
+    {
+      icon: "M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z",
+      iconColor: "text-green-600",
+      bgColor: "bg-green-50",
+      label: "\u8FD0\u884C\u73AF\u5883",
+      value: /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: `px-2 py-1 rounded-full text-sm ${getEnvironmentBadgeClass(env)}`,
+          children: env
+        }
+      )
+    },
+    {
+      icon: "M7 7h.01M7 3h5c.512 0 1.024.195 1.414.586l7 7a2 2 0 010 2.828l-7 7a2 2 0 01-2.828 0l-7-7A1.994 1.994 0 013 12V7a4 4 0 014-4z",
+      iconColor: "text-purple-600",
+      bgColor: "bg-purple-50",
+      label: "\u7248\u672C\u53F7",
+      value: serviceInfo.version || "unknown"
+    },
+    ...serviceInfo.port ? [
+      {
+        icon: "M5 12h14M5 12a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v4a2 2 0 01-2 2M5 12a2 2 0 00-2 2v4a2 2 0 002 2h14a2 2 0 002-2v-4a2 2 0 00-2-2m-2-4h.01M17 16h.01",
+        iconColor: "text-indigo-600",
+        bgColor: "bg-indigo-50",
+        label: "\u7AEF\u53E3",
+        value: serviceInfo.port
+      }
+    ] : [],
+    {
+      icon: "M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z",
+      iconColor: "text-emerald-600",
+      bgColor: "bg-emerald-50",
+      label: "\u8FD0\u884C\u72B6\u6001",
+      value: /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: `px-2 py-1 rounded-full text-sm ${getStatusBadgeClass(status)}`,
+          children: status
+        }
+      )
+    }
+  ];
+  return /* @__PURE__ */ jsxs("div", { className: "bg-white rounded-lg shadow-md p-6 mb-8", children: [
+    /* @__PURE__ */ jsxs("h2", { className: "text-2xl font-semibold text-gray-800 mb-6 flex items-center", children: [
+      /* @__PURE__ */ jsx(
+        "svg",
+        {
+          className: "w-6 h-6 mr-2 text-blue-600",
+          fill: "none",
+          stroke: "currentColor",
+          viewBox: "0 0 24 24",
+          children: /* @__PURE__ */ jsx(
+            "path",
+            {
+              strokeLinecap: "round",
+              strokeLinejoin: "round",
+              strokeWidth: 2,
+              d: "M13 10V3L4 14h7v7l9-11h-7z"
+            }
+          )
+        }
+      ),
+      "\u670D\u52A1\u57FA\u672C\u4FE1\u606F"
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6", children: infoCards.map((card, index) => /* @__PURE__ */ jsx(InfoCard, { ...card }, index)) })
+  ] });
+};
+var ServiceStatusPage = ({
+  serviceInfo
+}) => {
+  return /* @__PURE__ */ jsx("div", { className: "min-h-screen bg-gray-50 py-8", children: /* @__PURE__ */ jsxs("div", { className: "max-w-6xl mx-auto px-4", children: [
+    /* @__PURE__ */ jsxs("div", { className: "mb-8", children: [
+      /* @__PURE__ */ jsx("h1", { className: "text-4xl font-bold text-gray-900 mb-2", children: "Service Status" }),
+      /* @__PURE__ */ jsx("p", { className: "text-gray-600", children: "\u67E5\u770B\u670D\u52A1\u8FD0\u884C\u72B6\u6001\u548C\u57FA\u672C\u4FE1\u606F" })
+    ] }),
+    /* @__PURE__ */ jsx(ServiceInfoCards, { serviceInfo })
+  ] }) });
+};
+
+// src/plugins/route/decorator.ts
+function Route(options) {
+  return Handler({
+    type: "route",
+    options
+  });
+}
+function Page(options) {
+  const pageOptions = {
+    method: options.method || "GET",
+    ...options
+  };
+  return Route(pageOptions);
+}
+
+// src/plugins/route/plugin.ts
+var RoutePlugin = class {
+  name = "route-plugin";
+  priority = 1e3 /* ROUTE */;
+  engine;
+  globalPrefix;
+  globalMiddlewares;
   /**
-   * 获取 Hono 实例（供插件使用）
+   * 构造函数
+   * @param options 插件配置选项
    */
-  getHono() {
-    return this.hono;
+  constructor(options) {
+    this.globalPrefix = options?.prefix || "";
+    this.globalMiddlewares = options?.globalMiddlewares || [];
   }
   /**
-   * 内部注册插件方法（供构造函数和子类使用）
-   * @protected
+   * 声明Module配置Schema（用于类型推导+运行时校验）
    */
-  registerPlugin(plugin) {
-    if (!plugin.name || plugin.name.trim() === "") {
-      throw new PluginNameRequiredError();
-    }
-    const existingPlugin = this.pluginRegistry.get(plugin.name);
-    if (existingPlugin) {
-      const oldIndex = this.plugins.indexOf(existingPlugin);
-      if (oldIndex >= 0) {
-        this.plugins.splice(oldIndex, 1);
+  getModuleOptionsSchema() {
+    return {
+      _type: {},
+      validate: (options) => {
+        if (options.routePrefix !== void 0 && typeof options.routePrefix !== "string") {
+          return "routePrefix must be a string";
+        }
+        if (options.routePrefix && !options.routePrefix.startsWith("/")) {
+          return `routePrefix must start with '/'`;
+        }
+        if (options.routeMiddlewares !== void 0 && !Array.isArray(options.routeMiddlewares)) {
+          return "routeMiddlewares must be an array";
+        }
+        return true;
       }
-      logger_default.info(`Override plugin: ${plugin.name}`);
-    }
-    this.pluginRegistry.set(plugin.name, plugin);
-    this.plugins.push(plugin);
+    };
   }
   /**
-   * 加载并注册所有模块（通过唯一的 key 查找）
-   * 在引擎启动时调用，使用双向访问机制查找所有被装饰的类
-   *
-   * 注意：
-   * - 每个引擎实例使用唯一的 moduleMetadataKey，实现隔离
-   * - 模块类是静态的，可以被多个引擎实例共享
-   * - 每个引擎实例会创建独立的模块实例，互不影响
+   * 引擎初始化钩子：获取Hono实例
    */
-  loadModules() {
-    this.modules = [];
-    const moduleClasses = getClassesByKey(this.moduleMetadataKey);
-    for (const moduleClass of moduleClasses) {
-      const metadata = getClassMetadata(moduleClass, this.moduleMetadataKey);
-      const moduleName = metadata.name || moduleClass.name;
-      const existingModule = this.modules.find((m) => m.name === moduleName);
-      if (existingModule) {
-        throw new DuplicateModuleError(moduleName);
-      }
-      const moduleMetadata = {
-        name: moduleName,
-        clazz: moduleClass,
-        options: metadata.options || {}
-      };
-      this.modules.push(moduleMetadata);
-    }
+  onInit(engine) {
+    this.engine = engine;
+    logger_default.info("RoutePlugin initialized");
   }
   /**
-   * 加载Handler元数据（平铺结构）
-   * 每个装饰器都是独立的HandlerMetadata条目
-   * 为每个方法创建包装链管理器，提供简单的 wrap API
+   * Handler加载钩子：解析type="route"的Handler元数据，注册HTTP路由
    */
-  loadHandlerMetadata() {
-    const handlers = [];
-    const wrapperChains = /* @__PURE__ */ new Map();
-    const originalMethods = /* @__PURE__ */ new Map();
-    for (const module of this.modules) {
-      if (!this.moduleInstances.has(module.clazz)) {
-        this.get(module.clazz);
+  onHandlerLoad(handlers) {
+    const routeHandlers = handlers.filter(
+      (handler) => handler.type === "route"
+    );
+    logger_default.info(`Found ${routeHandlers.length} route handler(s)`);
+    for (const handler of routeHandlers) {
+      const routeOptions = handler.options;
+      const methodName = handler.methodName;
+      const moduleClass = handler.module;
+      const moduleInstance = this.engine.get(moduleClass);
+      if (!moduleInstance) {
+        logger_default.warn(
+          `Module instance not found for ${moduleClass.name}, skipping route registration`
+        );
+        continue;
       }
-      const allMetadata = getAllHandlerMetadata(module.clazz);
-      for (const [methodName, metadataList] of allMetadata.entries()) {
-        const method = module.clazz.prototype[methodName];
-        const methodNameStr = String(methodName);
-        const methodKey = `${module.clazz.name}.${methodNameStr}`;
-        if (!originalMethods.has(methodKey)) {
-          originalMethods.set(methodKey, method);
-          wrapperChains.set(methodKey, []);
-        }
-        for (const meta of metadataList) {
-          const chain = wrapperChains.get(methodKey);
-          handlers.push({
-            ...meta,
-            method: originalMethods.get(methodKey),
-            methodName: methodNameStr,
-            module: module.clazz,
-            // 提供简单的 wrap API：插件只需要调用这个方法
-            wrap: (wrapper) => {
-              chain.push(wrapper);
-            }
-          });
+      const moduleMetadata = this.engine.getModules().find((m) => m.clazz === moduleClass);
+      const moduleOptions = moduleMetadata?.options || {};
+      const routePrefix = moduleOptions.routePrefix || "";
+      const paths = Array.isArray(routeOptions.path) ? routeOptions.path : [routeOptions.path];
+      const fullPaths = paths.map((p) => this.globalPrefix + routePrefix + p);
+      const routeHandler = async (ctx) => {
+        const method = moduleInstance[methodName];
+        if (typeof method !== "function") {
+          return ctx.json({ error: "Handler method not found" }, 500);
+        }
+        try {
+          const result = await method.call(moduleInstance, ctx);
+          if (result instanceof Response) {
+            return result;
+          }
+          if (typeof result === "string" || typeof result === "object" && result !== null && "type" in result) {
+            return result;
+          }
+          return ctx.json(result);
+        } catch (error) {
+          logger_default.error(
+            `Error in route handler ${moduleClass.name}.${methodName}`,
+            error
+          );
+          return ctx.json(
+            {
+              error: "Internal server error",
+              message: error instanceof Error ? error.message : String(error)
+            },
+            500
+          );
+        }
+      };
+      const hono = this.engine.getHono();
+      const methods = routeOptions.method ? Array.isArray(routeOptions.method) ? routeOptions.method : [routeOptions.method] : ["GET"];
+      for (const fullPath of fullPaths) {
+        let route = hono;
+        if (this.globalMiddlewares.length > 0) {
+          route = route.use(fullPath, ...this.globalMiddlewares);
+        }
+        if (moduleOptions.routeMiddlewares && moduleOptions.routeMiddlewares.length > 0) {
+          route = route.use(fullPath, ...moduleOptions.routeMiddlewares);
+        }
+        if (routeOptions.middlewares && routeOptions.middlewares.length > 0) {
+          route = route.use(fullPath, ...routeOptions.middlewares);
+        }
+        for (const method of methods) {
+          const methodLower = method.toLowerCase();
+          if (methodLower === "get" || methodLower === "post" || methodLower === "put" || methodLower === "delete" || methodLower === "patch" || methodLower === "head" || methodLower === "options") {
+            route[methodLower](fullPath, routeHandler);
+            const description = routeOptions.description ? ` (${routeOptions.description})` : "";
+            logger_default.info(
+              `Registered route: ${method.toUpperCase()} ${fullPath} -> ${moduleClass.name}.${methodName}${description}`
+            );
+          } else {
+            logger_default.warn(
+              `Unsupported HTTP method: ${method}, skipping route ${fullPath}`
+            );
+          }
         }
       }
     }
-    this.__wrapperChains__ = wrapperChains;
-    this.__originalMethods__ = originalMethods;
-    return handlers;
   }
-  /**
-   * 应用所有包装链到原型
-   * 在所有插件执行完 onHandlerLoad 后调用
-   */
-  applyWrapperChains() {
-    const wrapperChains = this.__wrapperChains__;
-    const originalMethods = this.__originalMethods__;
-    if (!wrapperChains || !originalMethods) return;
-    for (const [methodKey, chain] of wrapperChains.entries()) {
-      if (chain.length === 0) continue;
-      const [moduleName, methodName] = methodKey.split(".");
-      const module = this.modules.find((m) => m.clazz.name === moduleName);
-      if (!module) continue;
-      const originalMethod = originalMethods.get(methodKey);
-      const prototype = module.clazz.prototype;
-      let wrappedMethod = originalMethod;
-      for (let i = chain.length - 1; i >= 0; i--) {
-        const wrapper = chain[i];
-        const next = wrappedMethod;
-        wrappedMethod = async function(...args) {
-          return wrapper(() => next.apply(this, args), this, ...args);
-        };
-      }
-      prototype[methodName] = wrappedMethod;
-    }
+};
+function buildParamsSchema(schemas) {
+  const shape = {};
+  for (let i = 0; i < schemas.length; i++) {
+    shape[String(i)] = schemas[i];
   }
-  /**
-   * 检查端口是否可用
-   */
-  async isPortAvailable(port, hostname) {
-    return new Promise((resolve) => {
-      const server = net.createServer();
-      server.unref();
-      server.listen(port, hostname, () => {
-        server.once("close", () => resolve(true));
-        server.close();
-      });
-      server.on("error", () => resolve(false));
-    });
+  return z.object(shape);
+}
+function parseAndValidateParams(body, schemas) {
+  if (!body || typeof body !== "object") {
+    body = {};
   }
-  /**
-   * 寻找一个随机的可用端口
-   */
-  getRandomPort(hostname) {
-    return new Promise((resolve, reject) => {
-      const server = net.createServer();
-      server.unref();
-      server.on("error", reject);
-      server.listen(0, hostname, () => {
-        const port = server.address().port;
-        server.close((err) => {
-          if (err) {
-            return reject(err);
-          }
-          resolve(port);
-        });
-      });
-    });
+  if (schemas.length === 0) {
+    return { success: true, data: [] };
   }
-  /**
-   * 启动引擎
-   * @param requestedPort 启动端口（可选，默认0，表示随机端口）
-   * @returns 实际使用的端口号
-   */
-  async start(requestedPort = 0) {
-    if (this.started) {
-      throw new Error("Engine is already started");
-    }
-    try {
-      const { port, hostname } = await this.determinePort(requestedPort);
-      this.initializeModulesAndPlugins();
-      this.processHandlers();
-      await this.executePluginStartHooks();
-      this.startHttpServer(port, hostname);
-      this.started = true;
-      logger_default.info(
-        `${this.options.name} v${this.options.version} started successfully on port ${this.actualPort}`
-      );
-      return this.actualPort;
-    } catch (error) {
-      logger_default.error("Failed to start engine", error);
-      throw error;
-    }
+  const paramsSchema = buildParamsSchema(schemas);
+  const validation = paramsSchema.safeParse(body);
+  if (!validation.success) {
+    return {
+      success: false,
+      error: validation.error
+    };
+  }
+  const validatedData = [];
+  for (let i = 0; i < schemas.length; i++) {
+    validatedData[i] = validation.data[String(i)];
   }
+  return {
+    success: true,
+    data: validatedData
+  };
+}
+function buildActionPath(enginePrefix, moduleName, handlerName) {
+  const normalizedPrefix = enginePrefix.replace(/\/+$/, "");
+  return `/${normalizedPrefix}/${moduleName}/${handlerName}`.replace(/\/+/g, "/").replace(/^\/\//, "/");
+}
+
+// src/plugins/action/plugin.ts
+function isAsyncIterable(obj) {
+  return obj != null && typeof obj[Symbol.asyncIterator] === "function";
+}
+var ActionPlugin = class {
+  name = "action-plugin";
+  priority = 1e3 /* ROUTE */;
+  // 路由插件优先级最低，必须最后执行
+  engine;
   /**
-   * 确定实际使用的端口
+   * 声明Module配置Schema（用于类型推导+运行时校验）
    */
-  async determinePort(requestedPort) {
-    const hostname = this.options.hostname || "0.0.0.0";
-    if (requestedPort !== 0) {
-      const portAvailable = await this.isPortAvailable(requestedPort, hostname);
-      if (portAvailable) {
-        this.actualPort = requestedPort;
-        return { port: this.actualPort, hostname };
+  getModuleOptionsSchema() {
+    return {
+      _type: {},
+      validate: (options) => {
+        if (options.actionMiddlewares !== void 0 && !Array.isArray(options.actionMiddlewares)) {
+          return "actionMiddlewares must be an array";
+        }
+        return true;
       }
-      logger_default.info(
-        `Port ${requestedPort} is in use, finding a random available port...`
-      );
-    }
-    this.actualPort = await this.getRandomPort(hostname);
-    return { port: this.actualPort, hostname };
+    };
   }
   /**
-   * 初始化模块和插件
+   * 引擎初始化钩子：获取Hono实例
    */
-  initializeModulesAndPlugins() {
-    this.loadModules();
-    this.executePluginHook("onInit", (plugin) => {
-      plugin.onInit?.(this);
-    });
-    this.executePluginHook("onModuleLoad", (plugin) => {
-      plugin.onModuleLoad?.(
-        this.modules
-      );
-    });
+  onInit(engine) {
+    this.engine = engine;
+    logger_default.info("ActionPlugin initialized");
   }
   /**
-   * 处理 Handler 元数据和插件包装
+   * Handler加载钩子：解析type="action"的Handler元数据，注册HTTP路由
    */
-  processHandlers() {
-    const handlers = this.loadHandlerMetadata();
-    const sortedPlugins = this.sortPluginsByPriority();
-    const { wrapperPlugins, routePlugins } = this.separateWrapperAndRoutePlugins(sortedPlugins);
-    this.executePluginHook(
-      "onHandlerLoad",
-      (plugin) => {
-        plugin.onHandlerLoad?.(handlers);
-      },
-      wrapperPlugins
-    );
-    this.applyWrapperChains();
-    this.executePluginHook(
-      "onHandlerLoad",
-      (plugin) => {
-        plugin.onHandlerLoad?.(handlers);
-      },
-      routePlugins
+  onHandlerLoad(handlers) {
+    const actionHandlers = handlers.filter(
+      (handler) => handler.type === "action"
     );
-  }
-  /**
-   * 执行插件启动钩子
-   */
-  async executePluginStartHooks() {
-    this.executePluginHook("onBeforeStart", (plugin) => {
-      plugin.onBeforeStart?.(this);
-    });
-    for (const plugin of this.plugins) {
-      try {
-        await plugin.onAfterStart?.(this);
-      } catch (error) {
-        throw new Error(
-          `Plugin ${plugin.name} failed in onAfterStart: ${error instanceof Error ? error.message : String(error)}`
+    logger_default.info(`Found ${actionHandlers.length} action handler(s)`);
+    for (const handler of actionHandlers) {
+      const actionOptions = handler.options;
+      const methodName = handler.methodName;
+      const moduleClass = handler.module;
+      const moduleInstance = this.engine.get(moduleClass);
+      if (!moduleInstance) {
+        logger_default.warn(
+          `Module instance not found for ${moduleClass.name}, skipping action registration`
         );
+        continue;
       }
-    }
-    this.registerVersionRoute();
-  }
-  /**
-   * 注册版本路由（/prefix/version）
-   * 用于健康检查和探针
-   */
-  registerVersionRoute() {
-    const prefix = this.options.prefix || "";
-    const versionPath = prefix ? `${prefix}` : "/";
-    const existingRoutes = this.hono.routes;
-    const routeExists = existingRoutes.some(
-      (route) => route.path === versionPath && route.method === "GET"
-    );
-    if (routeExists) {
-      logger_default.info(
-        `Version route ${versionPath} already exists, skipping registration`
-      );
-      return;
-    }
-    try {
-      this.hono.get(versionPath, async (ctx) => {
-        return ctx.json({
-          name: this.options.name,
-          version: this.options.version,
-          status: "running"
-        });
-      });
-      logger_default.info(`Registered version route: GET ${versionPath}`);
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("matcher is already built")) {
+      const moduleMetadata = this.engine.getModules().find((m) => m.clazz === moduleClass);
+      if (!moduleMetadata) {
         logger_default.warn(
-          `Cannot register version route ${versionPath}: route matcher is already built. If you have already registered a route at ${versionPath}, it will be used instead.`
+          `Module metadata not found for ${moduleClass.name}, skipping action registration`
         );
-      } else {
-        throw error;
+        continue;
       }
+      const moduleOptions = moduleMetadata.options || {};
+      const enginePrefix = this.engine.options.prefix || "";
+      const actionPath = buildActionPath(
+        enginePrefix,
+        moduleMetadata.name,
+        methodName
+      );
+      const paramSchemas = actionOptions.params || [];
+      const returnSchema = actionOptions.returns;
+      const actionHandler = async (ctx) => {
+        const method = moduleInstance[methodName];
+        if (typeof method !== "function") {
+          const errorResponse = ejson.stringify({
+            success: false,
+            error: "Action method not found"
+          });
+          return ctx.text(errorResponse, 500, {
+            "Content-Type": "application/json"
+          });
+        }
+        try {
+          let body = {};
+          if (ctx.req.method === "GET") {
+            const url = new URL(ctx.req.url);
+            url.searchParams.forEach((value, key) => {
+              body[key] = value;
+            });
+          } else {
+            try {
+              const rawBody = await ctx.req.text();
+              if (rawBody) {
+                body = ejson.parse(rawBody);
+              }
+            } catch (parseError) {
+              try {
+                body = await ctx.req.json().catch(() => ({}));
+              } catch {
+                body = {};
+              }
+            }
+          }
+          const validation = parseAndValidateParams(body, paramSchemas);
+          if (!validation.success) {
+            const errors = validation.error.issues || [];
+            const errorMessage = `Validation failed: ${errors.map((e) => {
+              const path = e.path || [];
+              const pathStr = path.length > 0 ? path.map((p, i) => {
+                if (i === 0 && typeof p === "string" && /^\d+$/.test(p)) {
+                  return `\u53C2\u6570[${p}]`;
+                }
+                return String(p);
+              }).join(".") : "unknown";
+              return `${pathStr}: ${e.message}`;
+            }).join(", ")}`;
+            const errorResponse = ejson.stringify({
+              success: false,
+              error: errorMessage
+            });
+            return ctx.text(errorResponse, 400, {
+              "Content-Type": "application/json"
+            });
+          }
+          const methodLength = method.length;
+          const paramsLength = paramSchemas.length;
+          const args = [...validation.data];
+          if (methodLength > paramsLength) {
+            args.unshift(ctx);
+          }
+          const result = await method.apply(moduleInstance, args);
+          if (actionOptions.stream) {
+            if (!isAsyncIterable(result)) {
+              const errorResponse = ejson.stringify({
+                success: false,
+                error: "Stream action must return AsyncIterable"
+              });
+              return ctx.text(errorResponse, 500, {
+                "Content-Type": "application/json"
+              });
+            }
+            const encoder = new TextEncoder();
+            const iterator = result[Symbol.asyncIterator]();
+            const stream = new ReadableStream({
+              async start(controller) {
+                try {
+                  while (true) {
+                    const { value, done } = await iterator.next();
+                    if (done) {
+                      controller.enqueue(
+                        encoder.encode(ejson.stringify({ done: true }))
+                      );
+                      controller.close();
+                      break;
+                    }
+                    controller.enqueue(
+                      encoder.encode(ejson.stringify({ value, done: false }))
+                    );
+                  }
+                } catch (error) {
+                  controller.enqueue(
+                    encoder.encode(
+                      ejson.stringify({
+                        error: error instanceof Error ? error.message : String(error),
+                        done: true
+                      })
+                    )
+                  );
+                  controller.close();
+                }
+              }
+            });
+            return new Response(stream, {
+              headers: {
+                "Content-Type": "text/event-stream",
+                "Cache-Control": "no-cache",
+                Connection: "keep-alive"
+              }
+            });
+          }
+          if (returnSchema) {
+            const returnValidation = returnSchema.safeParse(result);
+            if (!returnValidation.success) {
+              logger_default.error(
+                `Return value validation failed for ${moduleClass.name}.${methodName}`,
+                returnValidation.error
+              );
+              const returnErrors = returnValidation.error.issues || [];
+              const errorMessage = `Return value validation failed: ${returnErrors.map((e) => {
+                const path = e.path || [];
+                const pathStr = path.length > 0 ? path.map((p) => String(p)).join(".") : "root";
+                return `${pathStr}: ${e.message}`;
+              }).join(", ")}`;
+              const errorResponse = ejson.stringify({
+                success: false,
+                error: errorMessage
+              });
+              return ctx.text(errorResponse, 400, {
+                "Content-Type": "application/json"
+              });
+            }
+            const successResponse2 = ejson.stringify({
+              success: true,
+              data: returnValidation.data
+            });
+            return ctx.text(successResponse2, 200, {
+              "Content-Type": "application/json"
+            });
+          }
+          const successResponse = ejson.stringify({
+            success: true,
+            data: result
+          });
+          return ctx.text(successResponse, 200, {
+            "Content-Type": "application/json"
+          });
+        } catch (error) {
+          logger_default.error(
+            `Error in action handler ${moduleClass.name}.${methodName}`,
+            error
+          );
+          const errorResponse = ejson.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+          });
+          return ctx.text(errorResponse, 500, {
+            "Content-Type": "application/json"
+          });
+        }
+      };
+      const hono = this.engine.getHono();
+      let route = hono;
+      if (moduleOptions.actionMiddlewares && moduleOptions.actionMiddlewares.length > 0) {
+        route = route.use(actionPath, ...moduleOptions.actionMiddlewares);
+      }
+      if (actionOptions.middlewares && actionOptions.middlewares.length > 0) {
+        route = route.use(actionPath, ...actionOptions.middlewares);
+      }
+      route.get(actionPath, actionHandler);
+      route.post(actionPath, actionHandler);
+      logger_default.info(
+        `[\u6CE8\u518C\u52A8\u4F5C] ${moduleClass.name}.${methodName} ${actionOptions.description}`
+      );
     }
   }
-  /**
-   * 启动 HTTP 服务器
-   */
-  startHttpServer(port, hostname) {
-    this.server = serve({
-      fetch: this.hono.fetch,
-      port,
-      hostname
-    });
-    logger_default.info(`HTTP server started on http://${hostname}:${port}`);
+};
+
+// src/plugins/action/decorator.ts
+function Action(options) {
+  return Handler({
+    type: "action",
+    options
+  });
+}
+
+// src/plugins/cache/adapter.ts
+var MemoryCacheAdapter = class {
+  cache = /* @__PURE__ */ new Map();
+  async get(key) {
+    const item = this.cache.get(key);
+    if (!item) {
+      return null;
+    }
+    if (item.expiresAt <= Date.now()) {
+      this.cache.delete(key);
+      return null;
+    }
+    return item;
   }
-  /**
-   * 按优先级排序插件
-   */
-  sortPluginsByPriority() {
-    return [...this.plugins].sort((a, b) => {
-      const priorityA = this.getPluginPriority(a);
-      const priorityB = this.getPluginPriority(b);
-      if (priorityA !== priorityB) {
-        return priorityA - priorityB;
-      }
-      const indexA = this.plugins.indexOf(a);
-      const indexB = this.plugins.indexOf(b);
-      return indexA - indexB;
-    });
+  async set(key, item) {
+    this.cache.set(key, item);
   }
-  /**
-   * 获取插件优先级
-   */
-  getPluginPriority(plugin) {
-    return plugin.priority ?? 300 /* BUSINESS */;
+  async delete(key) {
+    return this.cache.delete(key);
   }
-  /**
-   * 分离包装插件和路由插件
-   */
-  separateWrapperAndRoutePlugins(sortedPlugins) {
-    const wrapperPlugins = [];
-    const routePlugins = [];
-    for (const plugin of sortedPlugins) {
-      const priority = this.getPluginPriority(plugin);
-      if (priority === 1e3 /* ROUTE */) {
-        routePlugins.push(plugin);
-      } else {
-        wrapperPlugins.push(plugin);
-      }
-    }
-    return { wrapperPlugins, routePlugins };
+  async clear() {
+    this.cache.clear();
+  }
+  async keys() {
+    const now = Date.now();
+    return Array.from(this.cache.entries()).filter(([_, item]) => item.expiresAt > now).map(([key]) => key);
   }
   /**
-   * 执行插件钩子（通用方法）
+   * 清理所有过期项（高效批量清理）
+   * 这个方法比通过 keys() + get() + delete() 更高效
    */
-  executePluginHook(hookName, callback, plugins = this.plugins) {
-    for (const plugin of plugins) {
-      try {
-        callback(plugin);
-      } catch (error) {
-        throw new Error(
-          `Plugin ${plugin.name} failed in ${hookName}: ${error instanceof Error ? error.message : String(error)}`
-        );
+  async cleanupExpired() {
+    const now = Date.now();
+    let cleaned = 0;
+    for (const [key, item] of this.cache.entries()) {
+      if (item.expiresAt <= now) {
+        this.cache.delete(key);
+        cleaned++;
       }
     }
+    return cleaned;
   }
-  /**
-   * 停止引擎
-   */
-  async stop() {
-    if (!this.started) {
-      return;
+  async getStats() {
+    const now = Date.now();
+    const validEntries = Array.from(this.cache.entries()).filter(([_, item]) => item.expiresAt > now).map(([key, item]) => ({
+      key,
+      expiresAt: item.expiresAt,
+      createdAt: item.createdAt
+    }));
+    return {
+      size: validEntries.length,
+      entries: validEntries
+    };
+  }
+};
+var RedisCacheAdapter = class {
+  client;
+  keyPrefix;
+  constructor(options) {
+    this.client = options.client;
+    this.keyPrefix = options.keyPrefix || "cache:";
+  }
+  getKey(key) {
+    return `${this.keyPrefix}${key}`;
+  }
+  async get(key) {
+    const redisKey = this.getKey(key);
+    const data = await this.client.get(redisKey);
+    if (!data) {
+      return null;
     }
     try {
-      if (this.server) {
-        if (typeof this.server.close === "function") {
-          if (this.server.close.length > 0) {
-            await new Promise((resolve, reject) => {
-              this.server.close((err) => {
-                if (err) {
-                  reject(err);
-                } else {
-                  resolve();
-                }
-              });
-            });
-          } else {
-            this.server.close();
-            await new Promise((resolve) => setTimeout(resolve, 10));
-          }
-        }
-        this.server = null;
-        logger_default.info("HTTP server stopped");
-      }
-      for (let i = this.plugins.length - 1; i >= 0; i--) {
-        const plugin = this.plugins[i];
-        try {
-          await plugin.onDestroy?.();
-        } catch (error) {
-          logger_default.error(`Plugin ${plugin.name} failed in onDestroy`, error);
-        }
+      const item = JSON.parse(data);
+      if (item.expiresAt <= Date.now()) {
+        await this.delete(key);
+        return null;
       }
-      this.modules = [];
-      this.moduleInstances.clear();
-      this.started = false;
-      this.actualPort = null;
-      logger_default.info(`${this.options.name} stopped`);
+      return item;
     } catch (error) {
-      logger_default.error("Failed to stop engine", error);
-      throw error;
+      await this.delete(key);
+      return null;
     }
   }
-  /**
-   * 获取模块实例（单例）
-   * @param moduleClass 模块类
-   * @returns 模块实例
-   */
-  get(moduleClass) {
-    if (!this.moduleInstances.has(moduleClass)) {
-      this.moduleInstances.set(moduleClass, new moduleClass());
-    }
-    return this.moduleInstances.get(moduleClass);
+  async set(key, item) {
+    const redisKey = this.getKey(key);
+    const data = JSON.stringify(item);
+    const ttl = Math.max(0, Math.floor((item.expiresAt - Date.now()) / 1e3));
+    await this.client.set(redisKey, data, "EX", ttl);
   }
-  /**
-   * 获取已注册的模块列表
-   */
-  getModules() {
-    if (this.modules.length === 0 && !this.started) {
-      this.loadModules();
+  async delete(key) {
+    const redisKey = this.getKey(key);
+    const result = await this.client.del(redisKey);
+    return result > 0;
+  }
+  async clear() {
+    const pattern = `${this.keyPrefix}*`;
+    const keys = await this.client.keys(pattern);
+    if (keys.length > 0) {
+      await Promise.all(keys.map((key) => this.client.del(key)));
     }
-    return [...this.modules];
+  }
+  async keys() {
+    const pattern = `${this.keyPrefix}*`;
+    const redisKeys = await this.client.keys(pattern);
+    return redisKeys.map((key) => key.replace(this.keyPrefix, ""));
   }
   /**
-   * 获取实际使用的端口
+   * 清理所有过期项
+   *
+   * 注意：Redis 本身支持自动过期（通过 SET key value EX seconds），
+   * 过期键会被 Redis 自动删除。但在某些情况下（如测试环境、某些 Redis 客户端），
+   * 可能需要手动清理。此方法会检查并清理：
+   * 1. 已过期但尚未被 Redis 删除的键（双重保险）
+   * 2. JSON 解析失败的数据
    */
-  getPort() {
-    return this.actualPort;
-  }
-};
-
-// src/core/types.ts
-var PluginPriority = /* @__PURE__ */ ((PluginPriority2) => {
-  PluginPriority2[PluginPriority2["SYSTEM"] = 50] = "SYSTEM";
-  PluginPriority2[PluginPriority2["SECURITY"] = 100] = "SECURITY";
-  PluginPriority2[PluginPriority2["LOGGING"] = 200] = "LOGGING";
-  PluginPriority2[PluginPriority2["BUSINESS"] = 300] = "BUSINESS";
-  PluginPriority2[PluginPriority2["PERFORMANCE"] = 400] = "PERFORMANCE";
-  PluginPriority2[PluginPriority2["ROUTE"] = 1e3] = "ROUTE";
-  return PluginPriority2;
-})(PluginPriority || {});
-
-// src/core/checker.ts
-async function startCheck(checkers, pass) {
-  logger_default.info("[ \u9884\u68C0\u5F00\u59CB ]");
-  for (const [index, checker] of checkers.entries()) {
-    const seq = index + 1;
-    logger_default.info(`${seq}. ${checker.name}`);
-    try {
-      if (checker.skip) {
-        logger_default.warn(`${seq}. ${checker.name} [\u8DF3\u8FC7]`);
+  async cleanupExpired() {
+    const pattern = `${this.keyPrefix}*`;
+    const redisKeys = await this.client.keys(pattern);
+    let cleaned = 0;
+    for (const redisKey of redisKeys) {
+      const data = await this.client.get(redisKey);
+      if (!data) {
         continue;
       }
-      await checker.check();
-      logger_default.info(`${seq}. ${checker.name} [\u6210\u529F]`);
-    } catch (error) {
-      logger_default.error(`${seq}. ${checker.name} [\u5931\u8D25]`);
-      throw error;
+      try {
+        const item = JSON.parse(data);
+        if (item.expiresAt <= Date.now()) {
+          await this.client.del(redisKey);
+          cleaned++;
+        }
+      } catch {
+        await this.client.del(redisKey);
+        cleaned++;
+      }
     }
+    return cleaned;
   }
-  logger_default.info("[ \u9884\u68C0\u5B8C\u6210 ]");
-  if (pass) await pass();
-}
+  async getStats() {
+    const allKeys = await this.keys();
+    const entries = [];
+    for (const key of allKeys) {
+      const item = await this.get(key);
+      if (item) {
+        entries.push({
+          key,
+          expiresAt: item.expiresAt,
+          createdAt: item.createdAt
+        });
+      }
+    }
+    return {
+      size: entries.length,
+      entries
+    };
+  }
+};
 
-// src/plugins/route/plugin.ts
-var RoutePlugin = class {
-  name = "route-plugin";
-  priority = 1e3 /* ROUTE */;
-  engine;
-  globalMiddlewares;
+// src/plugins/cache/plugin.ts
+var CachePlugin = class {
+  name = "cache-plugin";
+  priority = 400 /* PERFORMANCE */;
+  // 性能优化插件，优先级较低
+  // 缓存适配器
+  adapter;
+  // 清理定时器
+  cleanupTimer = null;
+  // 引擎引用
+  engine = null;
+  // 模块配置
+  defaultTtl = 6e4;
+  // 默认1分钟
+  cacheEnabled = true;
+  cleanupInterval = 6e4;
+  // 默认1分钟清理一次
   /**
    * 构造函数
-   * @param options 插件配置选项
+   * @param adapter 缓存适配器，如果不提供则使用默认的内存缓存适配器
    */
-  constructor(options) {
-    this.globalMiddlewares = options?.globalMiddlewares || [];
+  constructor(adapter) {
+    this.adapter = adapter || new MemoryCacheAdapter();
   }
   /**
-   * 声明Module配置Schema（用于类型推导+运行时校验）
+   * 声明Module配置Schema
    */
   getModuleOptionsSchema() {
     return {
       _type: {},
       validate: (options) => {
-        if (options.routePrefix !== void 0 && typeof options.routePrefix !== "string") {
-          return "routePrefix must be a string";
-        }
-        if (options.routePrefix && !options.routePrefix.startsWith("/")) {
-          return `routePrefix must start with '/'`;
+        if (options.cacheDefaultTtl !== void 0 && options.cacheDefaultTtl < 0) {
+          return `cacheDefaultTtl must be >= 0`;
         }
-        if (options.routeMiddlewares !== void 0 && !Array.isArray(options.routeMiddlewares)) {
-          return "routeMiddlewares must be an array";
+        if (options.cacheCleanupInterval !== void 0 && options.cacheCleanupInterval < 0) {
+          return `cacheCleanupInterval must be >= 0`;
         }
         return true;
       }
     };
   }
   /**
-   * 引擎初始化钩子：获取Hono实例
+   * 引擎初始化前钩子
    */
   onInit(engine) {
     this.engine = engine;
-    logger_default.info("RoutePlugin initialized");
+    logger_default.info("CachePlugin initialized cache storage");
   }
   /**
-   * Handler加载钩子：解析type="route"的Handler元数据，注册HTTP路由
+   * Handler加载后钩子
+   * 拦截带有 type="cache" 的 Handler，包装原始方法实现缓存逻辑
    */
   onHandlerLoad(handlers) {
-    const routeHandlers = handlers.filter(
-      (handler) => handler.type === "route"
+    const cacheHandlers = handlers.filter(
+      (handler) => handler.type === "cache"
     );
-    logger_default.info(`Found ${routeHandlers.length} route handler(s)`);
-    for (const handler of routeHandlers) {
-      const routeOptions = handler.options;
+    logger_default.info(`Found ${cacheHandlers.length} cache handler(s)`);
+    for (const handler of cacheHandlers) {
       const methodName = handler.methodName;
       const moduleClass = handler.module;
-      const moduleInstance = this.engine.get(moduleClass);
-      if (!moduleInstance) {
-        logger_default.warn(
-          `Module instance not found for ${moduleClass.name}, skipping route registration`
-        );
+      const cacheOptions = handler.options || {};
+      const moduleMetadata = this.engine?.getModules().find((m) => m.clazz === moduleClass);
+      if (!moduleMetadata) {
+        logger_default.warn(`Module metadata not found for ${moduleClass.name}`);
         continue;
       }
-      const moduleMetadata = this.engine.getModules().find((m) => m.clazz === moduleClass);
-      const moduleOptions = moduleMetadata?.options || {};
-      const routePrefix = moduleOptions.routePrefix || "";
-      const paths = Array.isArray(routeOptions.path) ? routeOptions.path : [routeOptions.path];
-      const fullPaths = paths.map((p) => routePrefix + p);
-      const routeHandler = async (ctx) => {
-        const method = moduleInstance[methodName];
-        if (typeof method !== "function") {
-          return ctx.json({ error: "Handler method not found" }, 500);
-        }
-        try {
-          const result = await method.call(moduleInstance, ctx);
-          if (result instanceof Response) {
-            return result;
-          }
-          if (typeof result === "string" || typeof result === "object" && result !== null && "type" in result) {
-            return result;
-          }
-          return ctx.json(result);
-        } catch (error) {
-          logger_default.error(
-            `Error in route handler ${moduleClass.name}.${methodName}`,
-            error
-          );
-          return ctx.json(
-            {
-              error: "Internal server error",
-              message: error instanceof Error ? error.message : String(error)
-            },
-            500
-          );
-        }
-      };
-      const hono = this.engine.getHono();
-      const methods = routeOptions.method ? Array.isArray(routeOptions.method) ? routeOptions.method : [routeOptions.method] : ["GET"];
-      for (const fullPath of fullPaths) {
-        let route = hono;
-        if (this.globalMiddlewares.length > 0) {
-          route = route.use(fullPath, ...this.globalMiddlewares);
-        }
-        if (moduleOptions.routeMiddlewares && moduleOptions.routeMiddlewares.length > 0) {
-          route = route.use(fullPath, ...moduleOptions.routeMiddlewares);
-        }
-        if (routeOptions.middlewares && routeOptions.middlewares.length > 0) {
-          route = route.use(fullPath, ...routeOptions.middlewares);
-        }
-        for (const method of methods) {
-          const methodLower = method.toLowerCase();
-          if (methodLower === "get" || methodLower === "post" || methodLower === "put" || methodLower === "delete" || methodLower === "patch" || methodLower === "head" || methodLower === "options") {
-            route[methodLower](fullPath, routeHandler);
-            const description = routeOptions.description ? ` (${routeOptions.description})` : "";
-            logger_default.info(
-              `Registered route: ${method.toUpperCase()} ${fullPath} -> ${moduleClass.name}.${methodName}${description}`
-            );
-          } else {
-            logger_default.warn(
-              `Unsupported HTTP method: ${method}, skipping route ${fullPath}`
-            );
-          }
-        }
+      const moduleOptions = moduleMetadata.options;
+      const moduleDefaultTtl = moduleOptions?.cacheDefaultTtl ?? this.defaultTtl;
+      const moduleCacheEnabled = moduleOptions?.cacheEnabled ?? this.cacheEnabled;
+      const ttl = cacheOptions.ttl ?? moduleDefaultTtl;
+      const enabled = cacheOptions.enabled ?? moduleCacheEnabled;
+      if (!enabled) {
+        logger_default.info(`Cache disabled for ${moduleClass.name}.${methodName}`);
+        continue;
       }
+      const moduleName = moduleMetadata.name;
+      handler.wrap(async (next, instance, ...args) => {
+        const cacheKey = this.generateCacheKey(
+          moduleName,
+          methodName,
+          cacheOptions.key,
+          args
+        );
+        const cached = await this.adapter.get(cacheKey);
+        if (cached) {
+          logger_default.debug(`Cache hit for ${cacheKey}`);
+          return cached.value;
+        }
+        logger_default.debug(`Cache miss for ${cacheKey}`);
+        const result = await next();
+        await this.adapter.set(cacheKey, {
+          value: result,
+          expiresAt: Date.now() + ttl,
+          createdAt: Date.now()
+        });
+        return result;
+      });
+      logger_default.info(
+        `Wrapped ${moduleClass.name}.${methodName} with cache (TTL: ${ttl}ms)`
+      );
     }
   }
-};
-
-// src/plugins/route/decorator.ts
-function Route(options) {
-  return Handler({
-    type: "route",
-    options
-  });
-}
-function Page(options) {
-  const pageOptions = {
-    method: options.method || "GET",
-    ...options
-  };
-  return Route(pageOptions);
-}
-var DEFAULT_FAVICON = /* @__PURE__ */ jsx(
-  "link",
-  {
-    rel: "icon",
-    href: "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100' width='100' height='100'><defs><linearGradient id='nodeGradient' x1='0%' y1='0%' x2='100%' y2='100%'><stop offset='0%' stop-color='%233498db'/><stop offset='100%' stop-color='%232980b9'/></linearGradient><linearGradient id='centerNodeGradient' x1='0%' y1='0%' x2='100%' y2='100%'><stop offset='0%' stop-color='%232ecc71'/><stop offset='100%' stop-color='%2327ae60'/></linearGradient></defs><circle cx='50' cy='50' r='45' fill='%23f5f7fa'/><path d='M30,30 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><path d='M70,30 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><path d='M30,70 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><path d='M70,70 L50,50' stroke='%23bdc3c7' stroke-width='2' stroke-linecap='round'/><polygon points='30,15 45,25 45,45 30,55 15,45 15,25' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='70,15 85,25 85,45 70,55 55,45 55,25' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='30,45 45,55 45,75 30,85 15,75 15,55' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='70,45 85,55 85,75 70,85 55,75 55,55' fill='url(%23nodeGradient)' stroke='%232980b9' stroke-width='1.5'/><polygon points='50,30 65,40 65,60 50,70 35,60 35,40' fill='url(%23centerNodeGradient)' stroke='%2327ae60' stroke-width='2'/><circle cx='30' cy='30' r='3' fill='%23ffffff'/><circle cx='70' cy='30' r='3' fill='%23ffffff'/><circle cx='30' cy='70' r='3' fill='%23ffffff'/><circle cx='70' cy='70' r='3' fill='%23ffffff'/><circle cx='50' cy='50' r='4' fill='%23ffffff'/></svg>",
-    type: "image/svg+xml"
-  }
-);
-var BaseLayout = (props = {
-  title: "Microservice Template"
-}) => html`<!DOCTYPE html>
-    <html>
-      <head>
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>${props.title}</title>
-        ${props.heads}
-      </head>
-      <body>
-        ${props.children}
-      </body>
-    </html>`;
-var HtmxLayout = (props = {
-  title: "Microservice Template"
-}) => BaseLayout({
-  title: props.title,
-  heads: html`
-      <script src="https://unpkg.com/htmx.org@latest"></script>
-      <script src="https://unpkg.com/hyperscript.org@latest"></script>
-      <script src="https://cdn.tailwindcss.com"></script>
-      ${props.favicon || DEFAULT_FAVICON}
-    `,
-  children: props.children
-});
-function buildParamsSchema(schemas) {
-  const shape = {};
-  for (let i = 0; i < schemas.length; i++) {
-    shape[String(i)] = schemas[i];
-  }
-  return z.object(shape);
-}
-function parseAndValidateParams(body, schemas) {
-  if (!body || typeof body !== "object") {
-    body = {};
-  }
-  if (schemas.length === 0) {
-    return { success: true, data: [] };
-  }
-  const paramsSchema = buildParamsSchema(schemas);
-  const validation = paramsSchema.safeParse(body);
-  if (!validation.success) {
-    return {
-      success: false,
-      error: validation.error
-    };
-  }
-  const validatedData = [];
-  for (let i = 0; i < schemas.length; i++) {
-    validatedData[i] = validation.data[String(i)];
-  }
-  return {
-    success: true,
-    data: validatedData
-  };
-}
-function buildActionPath(enginePrefix, moduleName, handlerName) {
-  const normalizedPrefix = enginePrefix.replace(/\/+$/, "");
-  return `/${normalizedPrefix}/${moduleName}/${handlerName}`.replace(/\/+/g, "/").replace(/^\/\//, "/");
-}
-
-// src/plugins/action/plugin.ts
-function isAsyncIterable(obj) {
-  return obj != null && typeof obj[Symbol.asyncIterator] === "function";
-}
-var ActionPlugin = class {
-  name = "action-plugin";
-  priority = 1e3 /* ROUTE */;
-  // 路由插件优先级最低，必须最后执行
-  engine;
   /**
-   * 声明Module配置Schema（用于类型推导+运行时校验）
+   * 引擎启动前钩子
    */
-  getModuleOptionsSchema() {
-    return {
-      _type: {},
-      validate: (options) => {
-        if (options.actionMiddlewares !== void 0 && !Array.isArray(options.actionMiddlewares)) {
-          return "actionMiddlewares must be an array";
-        }
-        return true;
-      }
-    };
+  onBeforeStart(engine) {
+    const moduleOptions = engine.options;
+    const cleanupInterval = moduleOptions?.cacheCleanupInterval ?? this.cleanupInterval;
+    if (cleanupInterval > 0) {
+      this.cleanupTimer = setInterval(() => {
+        this.cleanup().catch((error) => {
+          logger_default.error("Cache cleanup failed", error);
+        });
+      }, cleanupInterval);
+      logger_default.info(
+        `Started cache cleanup timer (interval: ${cleanupInterval}ms)`
+      );
+    }
   }
   /**
-   * 引擎初始化钩子：获取Hono实例
+   * 引擎停止时钩子
    */
-  onInit(engine) {
-    this.engine = engine;
-    logger_default.info("ActionPlugin initialized");
+  async onDestroy() {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer);
+      this.cleanupTimer = null;
+    }
+    await this.adapter.clear();
+    logger_default.info("Cache storage cleared");
   }
   /**
-   * Handler加载钩子：解析type="action"的Handler元数据，注册HTTP路由
+   * 生成缓存键
+   * @param moduleName 模块名
+   * @param methodName 方法名
+   * @param keyFunction 可选的 key 函数
+   * @param args 方法参数
+   * @returns 缓存键（格式：模块名:方法名:hash）
    */
-  onHandlerLoad(handlers) {
-    const actionHandlers = handlers.filter(
-      (handler) => handler.type === "action"
-    );
-    logger_default.info(`Found ${actionHandlers.length} action handler(s)`);
-    for (const handler of actionHandlers) {
-      const actionOptions = handler.options;
-      const methodName = handler.methodName;
-      const moduleClass = handler.module;
-      const moduleInstance = this.engine.get(moduleClass);
-      if (!moduleInstance) {
-        logger_default.warn(
-          `Module instance not found for ${moduleClass.name}, skipping action registration`
-        );
-        continue;
-      }
-      const moduleMetadata = this.engine.getModules().find((m) => m.clazz === moduleClass);
-      if (!moduleMetadata) {
-        logger_default.warn(
-          `Module metadata not found for ${moduleClass.name}, skipping action registration`
-        );
-        continue;
+  generateCacheKey(moduleName, methodName, keyFunction, args) {
+    const keyData = keyFunction ? keyFunction(...args) : args;
+    const serialized = ejson.stringify(keyData);
+    const hash = createHash("sha256").update(serialized).digest("hex");
+    return `${moduleName}:${methodName}:${hash}`;
+  }
+  /**
+   * 清理过期缓存
+   */
+  async cleanup() {
+    if (typeof this.adapter.cleanupExpired === "function") {
+      const cleaned = await this.adapter.cleanupExpired();
+      if (cleaned > 0) {
+        logger_default.debug(`Cleaned up ${cleaned} expired cache entry(ies)`);
       }
-      const moduleOptions = moduleMetadata.options || {};
-      const enginePrefix = this.engine.options.prefix || "";
-      const actionPath = buildActionPath(
-        enginePrefix,
-        moduleMetadata.name,
-        methodName
-      );
-      const paramSchemas = actionOptions.params || [];
-      const returnSchema = actionOptions.returns;
-      const actionHandler = async (ctx) => {
-        const method = moduleInstance[methodName];
-        if (typeof method !== "function") {
-          const errorResponse = ejson.stringify({
-            success: false,
-            error: "Action method not found"
-          });
-          return ctx.text(errorResponse, 500, {
-            "Content-Type": "application/json"
-          });
-        }
-        try {
-          let body = {};
-          if (ctx.req.method === "GET") {
-            const url = new URL(ctx.req.url);
-            url.searchParams.forEach((value, key) => {
-              body[key] = value;
-            });
-          } else {
-            try {
-              const rawBody = await ctx.req.text();
-              if (rawBody) {
-                body = ejson.parse(rawBody);
-              }
-            } catch (parseError) {
-              try {
-                body = await ctx.req.json().catch(() => ({}));
-              } catch {
-                body = {};
-              }
-            }
-          }
-          const validation = parseAndValidateParams(body, paramSchemas);
-          if (!validation.success) {
-            const errors = validation.error.issues || [];
-            const errorMessage = `Validation failed: ${errors.map((e) => {
-              const path = e.path || [];
-              const pathStr = path.length > 0 ? path.map((p, i) => {
-                if (i === 0 && typeof p === "string" && /^\d+$/.test(p)) {
-                  return `\u53C2\u6570[${p}]`;
-                }
-                return String(p);
-              }).join(".") : "unknown";
-              return `${pathStr}: ${e.message}`;
-            }).join(", ")}`;
-            const errorResponse = ejson.stringify({
-              success: false,
-              error: errorMessage
-            });
-            return ctx.text(errorResponse, 400, {
-              "Content-Type": "application/json"
-            });
-          }
-          const methodLength = method.length;
-          const paramsLength = paramSchemas.length;
-          const args = [...validation.data];
-          if (methodLength > paramsLength) {
-            args.unshift(ctx);
-          }
-          const result = await method.apply(moduleInstance, args);
-          if (actionOptions.stream) {
-            if (!isAsyncIterable(result)) {
-              const errorResponse = ejson.stringify({
-                success: false,
-                error: "Stream action must return AsyncIterable"
-              });
-              return ctx.text(errorResponse, 500, {
-                "Content-Type": "application/json"
-              });
-            }
-            const encoder = new TextEncoder();
-            const iterator = result[Symbol.asyncIterator]();
-            const stream = new ReadableStream({
-              async start(controller) {
-                try {
-                  while (true) {
-                    const { value, done } = await iterator.next();
-                    if (done) {
-                      controller.enqueue(
-                        encoder.encode(ejson.stringify({ done: true }))
-                      );
-                      controller.close();
-                      break;
-                    }
-                    controller.enqueue(
-                      encoder.encode(ejson.stringify({ value, done: false }))
-                    );
-                  }
-                } catch (error) {
-                  controller.enqueue(
-                    encoder.encode(
-                      ejson.stringify({
-                        error: error instanceof Error ? error.message : String(error),
-                        done: true
-                      })
-                    )
-                  );
-                  controller.close();
-                }
-              }
-            });
-            return new Response(stream, {
-              headers: {
-                "Content-Type": "text/event-stream",
-                "Cache-Control": "no-cache",
-                Connection: "keep-alive"
-              }
-            });
-          }
-          if (returnSchema) {
-            const returnValidation = returnSchema.safeParse(result);
-            if (!returnValidation.success) {
-              logger_default.error(
-                `Return value validation failed for ${moduleClass.name}.${methodName}`,
-                returnValidation.error
-              );
-              const returnErrors = returnValidation.error.issues || [];
-              const errorMessage = `Return value validation failed: ${returnErrors.map((e) => {
-                const path = e.path || [];
-                const pathStr = path.length > 0 ? path.map((p) => String(p)).join(".") : "root";
-                return `${pathStr}: ${e.message}`;
-              }).join(", ")}`;
-              const errorResponse = ejson.stringify({
-                success: false,
-                error: errorMessage
-              });
-              return ctx.text(errorResponse, 400, {
-                "Content-Type": "application/json"
-              });
-            }
-            const successResponse2 = ejson.stringify({
-              success: true,
-              data: returnValidation.data
-            });
-            return ctx.text(successResponse2, 200, {
-              "Content-Type": "application/json"
-            });
-          }
-          const successResponse = ejson.stringify({
-            success: true,
-            data: result
-          });
-          return ctx.text(successResponse, 200, {
-            "Content-Type": "application/json"
-          });
-        } catch (error) {
-          logger_default.error(
-            `Error in action handler ${moduleClass.name}.${methodName}`,
-            error
-          );
-          const errorResponse = ejson.stringify({
-            success: false,
-            error: error instanceof Error ? error.message : String(error)
-          });
-          return ctx.text(errorResponse, 500, {
-            "Content-Type": "application/json"
-          });
+    } else {
+      const now = Date.now();
+      let cleaned = 0;
+      const keys = await this.adapter.keys();
+      for (const key of keys) {
+        const item = await this.adapter.get(key);
+        if (!item || item.expiresAt <= now) {
+          await this.adapter.delete(key);
+          cleaned++;
         }
-      };
-      const hono = this.engine.getHono();
-      let route = hono;
-      if (moduleOptions.actionMiddlewares && moduleOptions.actionMiddlewares.length > 0) {
-        route = route.use(actionPath, ...moduleOptions.actionMiddlewares);
       }
-      if (actionOptions.middlewares && actionOptions.middlewares.length > 0) {
-        route = route.use(actionPath, ...actionOptions.middlewares);
+      if (cleaned > 0) {
+        logger_default.debug(`Cleaned up ${cleaned} expired cache entry(ies)`);
       }
-      route.get(actionPath, actionHandler);
-      route.post(actionPath, actionHandler);
-      logger_default.info(
-        `[\u6CE8\u518C\u52A8\u4F5C] ${moduleClass.name}.${methodName} ${actionOptions.description}`
-      );
     }
   }
+  /**
+   * 获取缓存统计信息
+   */
+  async getStats() {
+    return await this.adapter.getStats();
+  }
+  /**
+   * 清空所有缓存
+   */
+  async clear() {
+    await this.adapter.clear();
+    logger_default.info("All cache cleared");
+  }
+  /**
+   * 删除指定的缓存项
+   */
+  async delete(key) {
+    return await this.adapter.delete(key);
+  }
 };
 
-// src/plugins/action/decorator.ts
-function Action(options) {
+// src/plugins/cache/decorator.ts
+function Cache(options = {}) {
   return Handler({
-    type: "action",
-    options
+    type: "cache",
+    options: {
+      ttl: options.ttl ?? 6e4,
+      // 默认1分钟
+      key: options.key,
+      // key 函数
+      enabled: options.enabled ?? true
+    }
   });
 }
 
-// src/plugins/cache/adapter.ts
-var MemoryCacheAdapter = class {
-  cache = /* @__PURE__ */ new Map();
-  async get(key) {
-    const item = this.cache.get(key);
-    if (!item) {
-      return null;
-    }
-    if (item.expiresAt <= Date.now()) {
-      this.cache.delete(key);
-      return null;
-    }
-    return item;
-  }
-  async set(key, item) {
-    this.cache.set(key, item);
-  }
-  async delete(key) {
-    return this.cache.delete(key);
-  }
-  async clear() {
-    this.cache.clear();
+// src/plugins/graceful-shutdown/plugin.ts
+var GracefulShutdownPlugin = class {
+  name = "graceful-shutdown-plugin";
+  priority = 50 /* SYSTEM */;
+  // 系统级插件，最高优先级
+  engine = null;
+  options;
+  // 正在执行的处理器计数
+  activeHandlers = 0;
+  // 是否正在停机
+  isShuttingDown = false;
+  // 停机超时定时器
+  shutdownTimer = null;
+  // 信号监听器（用于清理）
+  signalListeners = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.options = {
+      shutdownTimeout: options?.shutdownTimeout ?? 10 * 60 * 1e3,
+      // 默认10分钟
+      enabled: options?.enabled ?? true
+    };
   }
-  async keys() {
-    const now = Date.now();
-    return Array.from(this.cache.entries()).filter(([_, item]) => item.expiresAt > now).map(([key]) => key);
+  /**
+   * 引擎初始化钩子
+   */
+  onInit(engine) {
+    this.engine = engine;
+    logger_default.info("GracefulShutdownPlugin initialized");
   }
   /**
-   * 清理所有过期项（高效批量清理）
-   * 这个方法比通过 keys() + get() + delete() 更高效
+   * Handler加载钩子：拦截所有处理器，追踪执行状态
    */
-  async cleanupExpired() {
-    const now = Date.now();
-    let cleaned = 0;
-    for (const [key, item] of this.cache.entries()) {
-      if (item.expiresAt <= now) {
-        this.cache.delete(key);
-        cleaned++;
-      }
+  onHandlerLoad(handlers) {
+    if (!this.options.enabled) {
+      return;
     }
-    return cleaned;
-  }
-  async getStats() {
-    const now = Date.now();
-    const validEntries = Array.from(this.cache.entries()).filter(([_, item]) => item.expiresAt > now).map(([key, item]) => ({
-      key,
-      expiresAt: item.expiresAt,
-      createdAt: item.createdAt
-    }));
-    return {
-      size: validEntries.length,
-      entries: validEntries
-    };
-  }
-};
-var RedisCacheAdapter = class {
-  client;
-  keyPrefix;
-  constructor(options) {
-    this.client = options.client;
-    this.keyPrefix = options.keyPrefix || "cache:";
-  }
-  getKey(key) {
-    return `${this.keyPrefix}${key}`;
+    for (const handler of handlers) {
+      handler.wrap(async (next, instance, ...args) => {
+        if (this.isShuttingDown) {
+          throw new Error("Service is shutting down, new requests are not accepted");
+        }
+        this.incrementActiveHandlers();
+        try {
+          const result = await next();
+          return result;
+        } catch (error) {
+          throw error;
+        } finally {
+          this.decrementActiveHandlers();
+        }
+      });
+    }
+    logger_default.info(
+      `GracefulShutdownPlugin: Tracking ${handlers.length} handler(s)`
+    );
   }
-  async get(key) {
-    const redisKey = this.getKey(key);
-    const data = await this.client.get(redisKey);
-    if (!data) {
-      return null;
+  /**
+   * 引擎启动后钩子：注册系统信号监听器
+   */
+  async onAfterStart(engine) {
+    if (!this.options.enabled) {
+      return;
     }
-    try {
-      const item = JSON.parse(data);
-      if (item.expiresAt <= Date.now()) {
-        await this.delete(key);
-        return null;
+    this.engine = engine;
+    this.registerSignalHandlers();
+    logger_default.info(
+      `GracefulShutdownPlugin: Signal handlers registered, shutdown timeout: ${this.options.shutdownTimeout}ms`
+    );
+  }
+  /**
+   * 注册系统信号监听器
+   */
+  registerSignalHandlers() {
+    const signals = [
+      "SIGINT",
+      // Ctrl+C (Unix/Linux/Mac)
+      "SIGTERM",
+      // 终止信号 (Unix/Linux/Mac)
+      "SIGBREAK"
+      // Ctrl+Break (Windows)
+    ];
+    for (const signal of signals) {
+      if (process.platform === "win32" && signal === "SIGTERM") {
+        continue;
       }
-      return item;
-    } catch (error) {
-      await this.delete(key);
-      return null;
+      const handler = () => {
+        logger_default.info(`GracefulShutdownPlugin: Received ${signal} signal`);
+        this.initiateShutdown();
+      };
+      process.on(signal, handler);
+      this.signalListeners.set(signal, handler);
     }
   }
-  async set(key, item) {
-    const redisKey = this.getKey(key);
-    const data = JSON.stringify(item);
-    const ttl = Math.max(0, Math.floor((item.expiresAt - Date.now()) / 1e3));
-    await this.client.set(redisKey, data, "EX", ttl);
-  }
-  async delete(key) {
-    const redisKey = this.getKey(key);
-    const result = await this.client.del(redisKey);
-    return result > 0;
+  /**
+   * 增加活跃处理器计数
+   */
+  incrementActiveHandlers() {
+    this.activeHandlers++;
+    logger_default.debug(
+      `GracefulShutdownPlugin: Active handlers: ${this.activeHandlers}`
+    );
   }
-  async clear() {
-    const pattern = `${this.keyPrefix}*`;
-    const keys = await this.client.keys(pattern);
-    if (keys.length > 0) {
-      await Promise.all(keys.map((key) => this.client.del(key)));
+  /**
+   * 减少活跃处理器计数
+   */
+  decrementActiveHandlers() {
+    this.activeHandlers = Math.max(0, this.activeHandlers - 1);
+    logger_default.debug(
+      `GracefulShutdownPlugin: Active handlers: ${this.activeHandlers}`
+    );
+    if (this.isShuttingDown && this.activeHandlers === 0) {
+      logger_default.info(
+        "GracefulShutdownPlugin: All handlers completed, proceeding with shutdown"
+      );
+      this.completeShutdown();
     }
   }
-  async keys() {
-    const pattern = `${this.keyPrefix}*`;
-    const redisKeys = await this.client.keys(pattern);
-    return redisKeys.map((key) => key.replace(this.keyPrefix, ""));
-  }
   /**
-   * 清理所有过期项
-   *
-   * 注意：Redis 本身支持自动过期（通过 SET key value EX seconds），
-   * 过期键会被 Redis 自动删除。但在某些情况下（如测试环境、某些 Redis 客户端），
-   * 可能需要手动清理。此方法会检查并清理：
-   * 1. 已过期但尚未被 Redis 删除的键（双重保险）
-   * 2. JSON 解析失败的数据
+   * 启动优雅停机流程
    */
-  async cleanupExpired() {
-    const pattern = `${this.keyPrefix}*`;
-    const redisKeys = await this.client.keys(pattern);
-    let cleaned = 0;
-    for (const redisKey of redisKeys) {
-      const data = await this.client.get(redisKey);
-      if (!data) {
-        continue;
-      }
-      try {
-        const item = JSON.parse(data);
-        if (item.expiresAt <= Date.now()) {
-          await this.client.del(redisKey);
-          cleaned++;
-        }
-      } catch {
-        await this.client.del(redisKey);
-        cleaned++;
-      }
+  async initiateShutdown() {
+    if (this.isShuttingDown) {
+      return;
+    }
+    this.isShuttingDown = true;
+    logger_default.info(
+      `GracefulShutdownPlugin: Initiating graceful shutdown, waiting for ${this.activeHandlers} active handler(s) to complete`
+    );
+    if (this.activeHandlers === 0) {
+      logger_default.info(
+        "GracefulShutdownPlugin: No active handlers, proceeding with shutdown immediately"
+      );
+      await this.completeShutdown();
+      return;
     }
-    return cleaned;
+    this.shutdownTimer = setTimeout(() => {
+      logger_default.warn(
+        `GracefulShutdownPlugin: Shutdown timeout (${this.options.shutdownTimeout}ms) reached, forcing shutdown`
+      );
+      this.completeShutdown();
+    }, this.options.shutdownTimeout);
   }
-  async getStats() {
-    const allKeys = await this.keys();
-    const entries = [];
-    for (const key of allKeys) {
-      const item = await this.get(key);
-      if (item) {
-        entries.push({
-          key,
-          expiresAt: item.expiresAt,
-          createdAt: item.createdAt
-        });
+  /**
+   * 完成停机流程
+   */
+  async completeShutdown() {
+    if (this.shutdownTimer) {
+      clearTimeout(this.shutdownTimer);
+      this.shutdownTimer = null;
+    }
+    this.cleanupSignalHandlers();
+    if (this.engine) {
+      try {
+        await this.engine.stop();
+        logger_default.info("GracefulShutdownPlugin: Engine stopped successfully");
+      } catch (error) {
+        logger_default.error("GracefulShutdownPlugin: Failed to stop engine", error);
       }
     }
-    return {
-      size: entries.length,
-      entries
-    };
+    logger_default.info("GracefulShutdownPlugin: Process exiting");
+    process.exit(0);
   }
-};
-
-// src/plugins/cache/plugin.ts
-var CachePlugin = class {
-  name = "cache-plugin";
-  priority = 400 /* PERFORMANCE */;
-  // 性能优化插件，优先级较低
-  // 缓存适配器
-  adapter;
-  // 清理定时器
-  cleanupTimer = null;
-  // 引擎引用
-  engine = null;
-  // 模块配置
-  defaultTtl = 6e4;
-  // 默认1分钟
-  cacheEnabled = true;
-  cleanupInterval = 6e4;
-  // 默认1分钟清理一次
   /**
-   * 构造函数
-   * @param adapter 缓存适配器，如果不提供则使用默认的内存缓存适配器
+   * 清理信号监听器
    */
-  constructor(adapter) {
-    this.adapter = adapter || new MemoryCacheAdapter();
+  cleanupSignalHandlers() {
+    for (const [signal, handler] of this.signalListeners.entries()) {
+      process.removeListener(signal, handler);
+    }
+    this.signalListeners.clear();
   }
   /**
-   * 声明Module配置Schema
+   * 引擎销毁钩子：清理资源
    */
-  getModuleOptionsSchema() {
-    return {
-      _type: {},
-      validate: (options) => {
-        if (options.cacheDefaultTtl !== void 0 && options.cacheDefaultTtl < 0) {
-          return `cacheDefaultTtl must be >= 0`;
-        }
-        if (options.cacheCleanupInterval !== void 0 && options.cacheCleanupInterval < 0) {
-          return `cacheCleanupInterval must be >= 0`;
-        }
-        return true;
-      }
-    };
+  async onDestroy() {
+    this.cleanupSignalHandlers();
+    if (this.shutdownTimer) {
+      clearTimeout(this.shutdownTimer);
+      this.shutdownTimer = null;
+    }
+    logger_default.info("GracefulShutdownPlugin: Cleaned up");
   }
   /**
-   * 引擎初始化前钩子
+   * 获取当前活跃处理器数量（用于测试和监控）
    */
-  onInit(engine) {
-    this.engine = engine;
-    logger_default.info("CachePlugin initialized cache storage");
+  getActiveHandlersCount() {
+    return this.activeHandlers;
   }
   /**
-   * Handler加载后钩子
-   * 拦截带有 type="cache" 的 Handler，包装原始方法实现缓存逻辑
+   * 检查是否正在停机（用于测试和监控）
    */
-  onHandlerLoad(handlers) {
-    const cacheHandlers = handlers.filter(
-      (handler) => handler.type === "cache"
-    );
-    logger_default.info(`Found ${cacheHandlers.length} cache handler(s)`);
-    for (const handler of cacheHandlers) {
-      const methodName = handler.methodName;
-      const moduleClass = handler.module;
-      const cacheOptions = handler.options || {};
-      const moduleMetadata = this.engine?.getModules().find((m) => m.clazz === moduleClass);
-      if (!moduleMetadata) {
-        logger_default.warn(
-          `Module metadata not found for ${moduleClass.name}`
-        );
-        continue;
-      }
-      const moduleOptions = moduleMetadata.options;
-      const moduleDefaultTtl = moduleOptions?.cacheDefaultTtl ?? this.defaultTtl;
-      const moduleCacheEnabled = moduleOptions?.cacheEnabled ?? this.cacheEnabled;
-      const ttl = cacheOptions.ttl ?? moduleDefaultTtl;
-      const enabled = cacheOptions.enabled ?? moduleCacheEnabled;
-      if (!enabled) {
-        logger_default.info(
-          `Cache disabled for ${moduleClass.name}.${methodName}`
-        );
-        continue;
-      }
-      const moduleName = moduleMetadata.name;
-      handler.wrap(async (next, instance, ...args) => {
-        const cacheKey = this.generateCacheKey(
-          moduleName,
-          methodName,
-          cacheOptions.key,
-          args
-        );
-        const cached = await this.adapter.get(cacheKey);
-        if (cached) {
-          logger_default.debug(`Cache hit for ${cacheKey}`);
-          return cached.value;
+  isShuttingDownNow() {
+    return this.isShuttingDown;
+  }
+};
+
+// src/plugins/schedule/types.ts
+var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
+  ScheduleMode2["FIXED_RATE"] = "FIXED_RATE";
+  ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
+  return ScheduleMode2;
+})(ScheduleMode || {});
+
+// src/plugins/schedule/decorator.ts
+function Schedule(options) {
+  return Handler({
+    type: "schedule",
+    options: {
+      interval: options.interval,
+      mode: options.mode || "FIXED_RATE" /* FIXED_RATE */
+    }
+  });
+}
+
+// src/plugins/schedule/mock-etcd.ts
+var MockEtcd3 = class {
+  elections = /* @__PURE__ */ new Map();
+  election(key, ttl) {
+    if (!this.elections.has(key)) {
+      this.elections.set(key, new MockElection(key));
+    }
+    return this.elections.get(key);
+  }
+  getElection(key) {
+    return this.elections.get(key);
+  }
+  clearElections() {
+    this.elections.clear();
+  }
+};
+var MockElection = class {
+  constructor(key) {
+    this.key = key;
+  }
+  observers = [];
+  campaigns = [];
+  currentLeader = null;
+  async observe() {
+    const observer = new MockObserver(this);
+    this.observers.push(observer);
+    if (this.currentLeader) {
+      setTimeout(() => {
+        observer.notifyChange(this.currentLeader);
+      }, 0);
+    }
+    return observer;
+  }
+  campaign(candidate) {
+    const campaign = new MockCampaign(candidate, this);
+    this.campaigns.push(campaign);
+    if (!this.currentLeader) {
+      setTimeout(() => {
+        this.setLeader(candidate);
+      }, 50);
+    }
+    return campaign;
+  }
+  setLeader(leader) {
+    this.currentLeader = leader;
+    for (const observer of this.observers) {
+      observer.notifyChange(leader);
+    }
+    setTimeout(() => {
+      for (const campaign of this.campaigns) {
+        if (campaign.candidate === leader && !campaign.resigned) {
+          campaign.notifyElected();
         }
-        logger_default.debug(`Cache miss for ${cacheKey}`);
-        const result = await next();
-        await this.adapter.set(cacheKey, {
-          value: result,
-          expiresAt: Date.now() + ttl,
-          createdAt: Date.now()
-        });
-        return result;
-      });
-      logger_default.info(
-        `Wrapped ${moduleClass.name}.${methodName} with cache (TTL: ${ttl}ms)`
-      );
+      }
+    }, 50);
+  }
+  getCurrentLeader() {
+    return this.currentLeader;
+  }
+};
+var MockObserver = class {
+  constructor(election) {
+    this.election = election;
+  }
+  changeCallbacks = [];
+  on(event, callback) {
+    if (event === "change") {
+      this.changeCallbacks.push(callback);
+    }
+  }
+  notifyChange(leader) {
+    for (const callback of this.changeCallbacks) {
+      callback(leader);
+    }
+  }
+};
+var MockCampaign = class {
+  constructor(candidate, election) {
+    this.candidate = candidate;
+    this.election = election;
+  }
+  errorCallbacks = [];
+  electedCallbacks = [];
+  resigned = false;
+  on(event, callback) {
+    if (event === "error") {
+      this.errorCallbacks.push(callback);
+    } else if (event === "elected") {
+      this.electedCallbacks.push(callback);
     }
   }
-  /**
-   * 引擎启动前钩子
-   */
-  onBeforeStart(engine) {
-    const moduleOptions = engine.options;
-    const cleanupInterval = moduleOptions?.cacheCleanupInterval ?? this.cleanupInterval;
-    if (cleanupInterval > 0) {
-      this.cleanupTimer = setInterval(() => {
-        this.cleanup().catch((error) => {
-          logger_default.error("Cache cleanup failed", error);
-        });
-      }, cleanupInterval);
-      logger_default.info(
-        `Started cache cleanup timer (interval: ${cleanupInterval}ms)`
-      );
+  notifyElected() {
+    if (!this.resigned) {
+      for (const callback of this.electedCallbacks) {
+        callback();
+      }
     }
   }
-  /**
-   * 引擎停止时钩子
-   */
-  async onDestroy() {
-    if (this.cleanupTimer) {
-      clearInterval(this.cleanupTimer);
-      this.cleanupTimer = null;
+  notifyError(error) {
+    for (const callback of this.errorCallbacks) {
+      callback(error);
     }
-    await this.adapter.clear();
-    logger_default.info("Cache storage cleared");
   }
-  /**
-   * 生成缓存键
-   * @param moduleName 模块名
-   * @param methodName 方法名
-   * @param keyFunction 可选的 key 函数
-   * @param args 方法参数
-   * @returns 缓存键（格式：模块名:方法名:hash）
-   */
-  generateCacheKey(moduleName, methodName, keyFunction, args) {
-    const keyData = keyFunction ? keyFunction(...args) : args;
-    const serialized = ejson.stringify(keyData);
-    const hash = createHash("sha256").update(serialized).digest("hex");
-    return `${moduleName}:${methodName}:${hash}`;
+  async resign() {
+    this.resigned = true;
+  }
+};
+
+// src/plugins/schedule/scheduler.ts
+var import_api = __toESM(require_src());
+var tracer = import_api.trace.getTracer("scheduler");
+var Scheduler = class {
+  constructor(etcdClient) {
+    this.etcdClient = etcdClient;
   }
+  campaigns = /* @__PURE__ */ new Map();
+  timers = /* @__PURE__ */ new Map();
+  isLeader = /* @__PURE__ */ new Map();
   /**
-   * 清理过期缓存
+   * 启动调度任务
    */
-  async cleanup() {
-    if (typeof this.adapter.cleanupExpired === "function") {
-      const cleaned = await this.adapter.cleanupExpired();
-      if (cleaned > 0) {
-        logger_default.debug(`Cleaned up ${cleaned} expired cache entry(ies)`);
-      }
-    } else {
-      const now = Date.now();
-      let cleaned = 0;
-      const keys = await this.adapter.keys();
-      for (const key of keys) {
-        const item = await this.adapter.get(key);
-        if (!item || item.expiresAt <= now) {
-          await this.adapter.delete(key);
-          cleaned++;
-        }
-      }
-      if (cleaned > 0) {
-        logger_default.debug(`Cleaned up ${cleaned} expired cache entry(ies)`);
+  async startSchedule(serviceId, moduleName, methodName, electionKey, metadata, method) {
+    const election = this.etcdClient.election(electionKey, 10);
+    const observe = await election.observe();
+    observe.on("change", (leader) => {
+      const isLeader = leader === serviceId;
+      this.isLeader.set(serviceId, isLeader);
+      if (!isLeader) {
+        this.stopTimer(serviceId);
       }
-    }
+    });
+    const campaign = election.campaign(serviceId);
+    this.campaigns.set(serviceId, campaign);
+    campaign.on("error", (error) => {
+      logger_default.error(`Error in campaign for ${moduleName}.${methodName}:`, error);
+    });
+    campaign.on("elected", () => {
+      this.isLeader.set(serviceId, true);
+      this.startTimer(serviceId, metadata, moduleName, method);
+      logger_default.info(`become leader for ${moduleName}.${methodName}`);
+    });
   }
   /**
-   * 获取缓存统计信息
+   * 启动定时器
    */
-  async getStats() {
-    return await this.adapter.getStats();
+  startTimer(serviceId, metadata, moduleName, method) {
+    this.stopTimer(serviceId);
+    const wrappedMethod = async () => {
+      tracer.startActiveSpan(
+        `ScheduleTask ${moduleName}.${metadata.name}`,
+        { root: true },
+        async (span) => {
+          span.setAttribute("serviceId", serviceId);
+          span.setAttribute("methodName", metadata.name);
+          span.setAttribute("moduleName", moduleName);
+          span.setAttribute("interval", metadata.interval);
+          span.setAttribute("mode", metadata.mode);
+          try {
+            await method();
+          } catch (error) {
+            span.setStatus({
+              code: import_api.SpanStatusCode.ERROR,
+              message: error.message
+            });
+            logger_default.error(
+              `Error executing schedule task ${moduleName}.${metadata.name}:`,
+              error
+            );
+          } finally {
+            span.setStatus({ code: import_api.SpanStatusCode.OK });
+            span.end();
+          }
+        }
+      );
+    };
+    if (metadata.mode === "FIXED_DELAY" /* FIXED_DELAY */) {
+      const runTask = async () => {
+        if (!this.isLeader.get(serviceId)) return;
+        try {
+          await wrappedMethod();
+        } finally {
+          this.timers.set(serviceId, setTimeout(runTask, metadata.interval));
+        }
+      };
+      runTask();
+    } else {
+      this.timers.set(
+        serviceId,
+        setInterval(async () => {
+          if (!this.isLeader.get(serviceId)) return;
+          await wrappedMethod();
+        }, metadata.interval)
+      );
+    }
   }
   /**
-   * 清空所有缓存
+   * 停止定时器
    */
-  async clear() {
-    await this.adapter.clear();
-    logger_default.info("All cache cleared");
+  stopTimer(serviceId) {
+    const timer = this.timers.get(serviceId);
+    if (timer) {
+      clearTimeout(timer);
+      clearInterval(timer);
+      this.timers.delete(serviceId);
+    }
   }
   /**
-   * 删除指定的缓存项
+   * 停止所有调度任务
    */
-  async delete(key) {
-    return await this.adapter.delete(key);
+  async stop() {
+    for (const serviceId of this.timers.keys()) {
+      this.stopTimer(serviceId);
+    }
+    for (const [serviceId, campaign] of this.campaigns.entries()) {
+      try {
+        await campaign.resign().catch(() => {
+        });
+      } catch (error) {
+        logger_default.error(`Error stopping schedule ${serviceId}:`, error);
+      } finally {
+        this.campaigns.delete(serviceId);
+        this.isLeader.delete(serviceId);
+      }
+    }
   }
 };
 
-// src/plugins/cache/decorator.ts
-function Cache(options = {}) {
-  return Handler({
-    type: "cache",
-    options: {
-      ttl: options.ttl ?? 6e4,
-      // 默认1分钟
-      key: options.key,
-      // key 函数
-      enabled: options.enabled ?? true
+// src/plugins/schedule/utils.ts
+function extractScheduleMetadata(handlers) {
+  const result = /* @__PURE__ */ new Map();
+  const scheduleHandlers = handlers.filter(
+    (handler) => handler.type === "schedule"
+  );
+  for (const handler of scheduleHandlers) {
+    const moduleClass = handler.module;
+    const methodName = handler.methodName;
+    const options = handler.options || {};
+    if (!result.has(moduleClass)) {
+      result.set(moduleClass, /* @__PURE__ */ new Map());
     }
-  });
+    const moduleMetadata = result.get(moduleClass);
+    moduleMetadata.set(methodName, {
+      name: methodName,
+      interval: options.interval,
+      mode: options.mode || "FIXED_RATE" /* FIXED_RATE */
+    });
+  }
+  return result;
 }
 
-// src/plugins/graceful-shutdown/plugin.ts
-var GracefulShutdownPlugin = class {
-  name = "graceful-shutdown-plugin";
-  priority = 50 /* SYSTEM */;
-  // 系统级插件，最高优先级
-  engine = null;
-  options;
-  // 正在执行的处理器计数
-  activeHandlers = 0;
-  // 是否正在停机
-  isShuttingDown = false;
-  // 停机超时定时器
-  shutdownTimer = null;
-  // 信号监听器（用于清理）
-  signalListeners = /* @__PURE__ */ new Map();
+// src/plugins/schedule/plugin.ts
+var SchedulePlugin = class {
+  name = "schedule-plugin";
+  priority = 300 /* BUSINESS */;
+  // 业务逻辑优先级
+  engine;
+  scheduler = null;
+  etcdClient = null;
+  scheduleHandlers = [];
+  useMockEtcd = false;
   constructor(options) {
-    this.options = {
-      shutdownTimeout: options?.shutdownTimeout ?? 10 * 60 * 1e3,
-      // 默认10分钟
-      enabled: options?.enabled ?? true
-    };
+    if (options?.useMockEtcd) {
+      this.useMockEtcd = true;
+      this.etcdClient = new MockEtcd3();
+      logger_default.info("SchedulePlugin: Using MockEtcd3 for local development/testing");
+    } else if (options?.etcdClient) {
+      this.etcdClient = options.etcdClient;
+    }
   }
   /**
    * 引擎初始化钩子
    */
   onInit(engine) {
     this.engine = engine;
-    logger_default.info("GracefulShutdownPlugin initialized");
+    logger_default.info("SchedulePlugin initialized");
   }
   /**
-   * Handler加载钩子：拦截所有处理器，追踪执行状态
+   * Handler加载钩子：收集所有调度任务
    */
   onHandlerLoad(handlers) {
-    if (!this.options.enabled) {
-      return;
-    }
-    for (const handler of handlers) {
-      handler.wrap(async (next, instance, ...args) => {
-        if (this.isShuttingDown) {
-          throw new Error("Service is shutting down, new requests are not accepted");
-        }
-        this.incrementActiveHandlers();
-        try {
-          const result = await next();
-          return result;
-        } catch (error) {
-          throw error;
-        } finally {
-          this.decrementActiveHandlers();
-        }
-      });
-    }
+    this.scheduleHandlers = handlers.filter(
+      (handler) => handler.type === "schedule"
+    );
     logger_default.info(
-      `GracefulShutdownPlugin: Tracking ${handlers.length} handler(s)`
+      `SchedulePlugin: Found ${this.scheduleHandlers.length} schedule handler(s)`
     );
   }
   /**
-   * 引擎启动后钩子：注册系统信号监听器
+   * 引擎启动后钩子：启动所有调度任务
    */
   async onAfterStart(engine) {
-    if (!this.options.enabled) {
+    if (!this.etcdClient) {
+      logger_default.warn(
+        "SchedulePlugin: etcdClient not configured and useMockEtcd is false, schedule tasks will not start"
+      );
       return;
     }
-    this.engine = engine;
-    this.registerSignalHandlers();
-    logger_default.info(
-      `GracefulShutdownPlugin: Signal handlers registered, shutdown timeout: ${this.options.shutdownTimeout}ms`
-    );
-  }
-  /**
-   * 注册系统信号监听器
-   */
-  registerSignalHandlers() {
-    const signals = [
-      "SIGINT",
-      // Ctrl+C (Unix/Linux/Mac)
-      "SIGTERM",
-      // 终止信号 (Unix/Linux/Mac)
-      "SIGBREAK"
-      // Ctrl+Break (Windows)
-    ];
-    for (const signal of signals) {
-      if (process.platform === "win32" && signal === "SIGTERM") {
+    this.scheduler = new Scheduler(this.etcdClient);
+    const modules = engine.getModules();
+    if (!this.scheduleHandlers) {
+      logger_default.warn(
+        "SchedulePlugin: No schedule handlers found, schedule tasks will not start"
+      );
+      return;
+    }
+    const scheduleMetadataMap = extractScheduleMetadata(this.scheduleHandlers);
+    const serviceId = `${engine.options.name}-${Date.now()}-${Math.random()}`;
+    for (const moduleMetadata of modules) {
+      const moduleClass = moduleMetadata.clazz;
+      const moduleName = moduleMetadata.name;
+      const moduleInstance = engine.get(moduleClass);
+      const moduleScheduleMetadata = scheduleMetadataMap.get(moduleClass);
+      if (!moduleScheduleMetadata || moduleScheduleMetadata.size === 0) {
         continue;
       }
-      const handler = () => {
-        logger_default.info(`GracefulShutdownPlugin: Received ${signal} signal`);
-        this.initiateShutdown();
-      };
-      process.on(signal, handler);
-      this.signalListeners.set(signal, handler);
+      for (const [methodName, metadata] of moduleScheduleMetadata.entries()) {
+        const method = moduleInstance[methodName];
+        if (typeof method !== "function") {
+          logger_default.warn(
+            `SchedulePlugin: Method ${moduleName}.${methodName} is not a function, skipping`
+          );
+          continue;
+        }
+        const electionKey = `/schedule/${engine.options.name}/${moduleName}/${methodName}`;
+        const taskServiceId = `${serviceId}-${moduleName}-${methodName}`;
+        try {
+          await this.scheduler.startSchedule(
+            taskServiceId,
+            moduleName,
+            methodName,
+            electionKey,
+            metadata,
+            method.bind(moduleInstance)
+          );
+          logger_default.info(
+            `SchedulePlugin: Started schedule task ${moduleName}.${methodName} (interval: ${metadata.interval}ms, mode: ${metadata.mode})`
+          );
+        } catch (error) {
+          logger_default.error(
+            `SchedulePlugin: Failed to start schedule task ${moduleName}.${methodName}:`,
+            error
+          );
+        }
+      }
     }
   }
   /**
-   * 增加活跃处理器计数
-   */
-  incrementActiveHandlers() {
-    this.activeHandlers++;
-    logger_default.debug(
-      `GracefulShutdownPlugin: Active handlers: ${this.activeHandlers}`
-    );
-  }
-  /**
-   * 减少活跃处理器计数
+   * 引擎销毁钩子：停止所有调度任务
    */
-  decrementActiveHandlers() {
-    this.activeHandlers = Math.max(0, this.activeHandlers - 1);
-    logger_default.debug(
-      `GracefulShutdownPlugin: Active handlers: ${this.activeHandlers}`
-    );
-    if (this.isShuttingDown && this.activeHandlers === 0) {
-      logger_default.info(
-        "GracefulShutdownPlugin: All handlers completed, proceeding with shutdown"
-      );
-      this.completeShutdown();
+  async onDestroy() {
+    if (this.scheduler) {
+      try {
+        await this.scheduler.stop();
+        logger_default.info("SchedulePlugin: All schedule tasks stopped");
+      } catch (error) {
+        logger_default.error("SchedulePlugin: Error stopping schedule tasks:", error);
+      }
     }
   }
-  /**
-   * 启动优雅停机流程
-   */
-  async initiateShutdown() {
-    if (this.isShuttingDown) {
-      return;
+};
+async function formatCode(code) {
+  try {
+    return prettier.format(code, { parser: "typescript" });
+  } catch {
+    return code;
+  }
+}
+
+// src/plugins/client-code/generator.ts
+function getZodTypeString(schema, defaultOptional = false) {
+  function processType(type) {
+    if (!type) {
+      return "unknown";
     }
-    this.isShuttingDown = true;
-    logger_default.info(
-      `GracefulShutdownPlugin: Initiating graceful shutdown, waiting for ${this.activeHandlers} active handler(s) to complete`
-    );
-    if (this.activeHandlers === 0) {
-      logger_default.info(
-        "GracefulShutdownPlugin: No active handlers, proceeding with shutdown immediately"
-      );
-      await this.completeShutdown();
-      return;
+    const def = type._def;
+    const typeName = def.type;
+    if (typeName === "nullable") {
+      return `${processType(def.innerType)} | null`;
     }
-    this.shutdownTimer = setTimeout(() => {
-      logger_default.warn(
-        `GracefulShutdownPlugin: Shutdown timeout (${this.options.shutdownTimeout}ms) reached, forcing shutdown`
-      );
-      this.completeShutdown();
-    }, this.options.shutdownTimeout);
-  }
-  /**
-   * 完成停机流程
-   */
-  async completeShutdown() {
-    if (this.shutdownTimer) {
-      clearTimeout(this.shutdownTimer);
-      this.shutdownTimer = null;
+    if (typeName === "optional") {
+      return processType(def.innerType);
     }
-    this.cleanupSignalHandlers();
-    if (this.engine) {
-      try {
-        await this.engine.stop();
-        logger_default.info("GracefulShutdownPlugin: Engine stopped successfully");
-      } catch (error) {
-        logger_default.error("GracefulShutdownPlugin: Failed to stop engine", error);
+    if (typeName === "pipe" && def.in) {
+      return processType(def.in);
+    }
+    if (typeName === "effects" && def.schema) {
+      return processType(def.schema);
+    }
+    switch (typeName) {
+      case "string": {
+        return "string";
+      }
+      case "number": {
+        return "number";
+      }
+      case "bigint": {
+        return "bigint";
+      }
+      case "boolean": {
+        return "boolean";
+      }
+      case "array": {
+        const elementType = processType(def.element);
+        return `${elementType}[]`;
+      }
+      case "date": {
+        return "Date";
+      }
+      case "object": {
+        const shape = typeof def.shape === "function" ? def.shape() : def.shape;
+        const props = Object.entries(shape).map(([key, value]) => {
+          if (key.includes("-")) {
+            key = `'${key}'`;
+          }
+          const fieldDef = value._def;
+          const fieldTypeName = fieldDef.type;
+          const isOptional = fieldTypeName === "optional";
+          const isDefault = defaultOptional && fieldTypeName === "default";
+          const fieldType = processType(
+            isOptional ? fieldDef.innerType : value
+          );
+          return `${key}${isOptional || isDefault ? "?" : ""}: ${fieldType}`;
+        }).join("; ");
+        return `{ ${props} }`;
+      }
+      case "union": {
+        return def.options.map((opt) => processType(opt)).join(" | ");
+      }
+      case "null": {
+        return "null";
+      }
+      case "promise": {
+        return `Promise<${processType(def.type)}>`;
+      }
+      case "void": {
+        return "void";
+      }
+      case "record": {
+        if (def.valueType) {
+          const keyType = def.keyType ? processType(def.keyType) : "string";
+          return `Record<${keyType}, ${processType(def.valueType)}>`;
+        } else if (def.keyType) {
+          return `Record<string, ${processType(def.keyType)}>`;
+        }
+        return "Record<string, any>";
+      }
+      case "map": {
+        return `Map<${processType(def.keyType)}, ${processType(
+          def.valueType
+        )}>`;
+      }
+      case "any": {
+        return "any";
+      }
+      case "unknown": {
+        return "unknown";
+      }
+      case "enum": {
+        const values = def.entries ? Object.values(def.entries) : [];
+        return "(" + values.map((opt) => `"${String(opt)}"`).join(" | ") + ")";
+      }
+      case "default": {
+        return processType(def.innerType);
+      }
+      default: {
+        if (type.safeParse(new Uint8Array()).success) {
+          return "Uint8Array";
+        }
+        return "unknown";
       }
     }
-    logger_default.info("GracefulShutdownPlugin: Process exiting");
-    process.exit(0);
-  }
-  /**
-   * 清理信号监听器
-   */
-  cleanupSignalHandlers() {
-    for (const [signal, handler] of this.signalListeners.entries()) {
-      process.removeListener(signal, handler);
-    }
-    this.signalListeners.clear();
   }
-  /**
-   * 引擎销毁钩子：清理资源
-   */
-  async onDestroy() {
-    this.cleanupSignalHandlers();
-    if (this.shutdownTimer) {
-      clearTimeout(this.shutdownTimer);
-      this.shutdownTimer = null;
-    }
-    logger_default.info("GracefulShutdownPlugin: Cleaned up");
+  return processType(schema);
+}
+async function generateClientCode(modules) {
+  const imports = [
+    "// \u8FD9\u4E2A\u6587\u4EF6\u662F\u81EA\u52A8\u751F\u6210\u7684\uFF0C\u8BF7\u4E0D\u8981\u624B\u52A8\u4FEE\u6539",
+    "",
+    'import { MicroserviceClient as BaseMicroserviceClient } from "imean-service-client";',
+    'export * from "imean-service-client";',
+    ""
+  ].join("\n");
+  function toPascalCase(moduleName) {
+    return moduleName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
   }
-  /**
-   * 获取当前活跃处理器数量（用于测试和监控）
-   */
-  getActiveHandlersCount() {
-    return this.activeHandlers;
+  function toCamelCase(moduleName) {
+    const parts = moduleName.split("-");
+    return parts[0] + parts.slice(1).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
   }
-  /**
-   * 检查是否正在停机（用于测试和监控）
-   */
-  isShuttingDownNow() {
-    return this.isShuttingDown;
+  const interfaces = Object.entries(modules).map(([name, module]) => {
+    const methods = Object.entries(module.actions).map(([actionName, action]) => {
+      if (!action.params) {
+        throw new Error(`Missing params for action ${actionName}`);
+      }
+      const paramNames = action.paramNames || [];
+      const params = action.params.map((param, index) => {
+        const paramName = paramNames[index] || param.description || `arg${index}`;
+        const paramDef = param._def;
+        const isOptional = param.isOptional();
+        const hasDefault = paramDef?.type === "default";
+        return `${paramName}${isOptional || hasDefault ? "?" : ""}: ${getZodTypeString(
+          param,
+          true
+        )}`;
+      }).join(", ");
+      const returnType = action.returns ? getZodTypeString(action.returns) : "void";
+      return `
+        /**
+         * ${action.description || ""}
+         */
+        ${actionName}: (${params}) => Promise<${action.stream ? `AsyncIterable<${returnType}>` : returnType}>;`;
+    }).join("\n    ");
+    const interfaceName = `${toPascalCase(name)}Module`;
+    return `export interface ${interfaceName} {
+    ${methods}
+}`;
+  }).join("\n\n");
+  const clientClass = `export class MicroserviceClient extends BaseMicroserviceClient {
+  constructor(options: any) {
+    super(options);
   }
-};
-
-// src/plugins/schedule/types.ts
-var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
-  ScheduleMode2["FIXED_RATE"] = "FIXED_RATE";
-  ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
-  return ScheduleMode2;
-})(ScheduleMode || {});
 
-// src/plugins/schedule/decorator.ts
-function Schedule(options) {
-  return Handler({
-    type: "schedule",
-    options: {
-      interval: options.interval,
-      mode: options.mode || "FIXED_RATE" /* FIXED_RATE */
-    }
-  });
+  ${Object.entries(modules).map(([name, module]) => {
+    const methods = Object.entries(module.actions).map(([actionName, action]) => {
+      return `${actionName}: { idempotent: ${!!action.idempotence}, stream: ${!!action.stream} }`;
+    }).join(",\n      ");
+    const propertyName = toCamelCase(name);
+    const interfaceName = `${toPascalCase(name)}Module`;
+    return `public readonly ${propertyName} = this.registerModule<${interfaceName}>("${name}", {
+      ${methods}
+    });`;
+  }).join("\n\n  ")}
+}`;
+  return await formatCode([imports, interfaces, clientClass].join("\n\n"));
 }
 
-// src/plugins/schedule/mock-etcd.ts
-var MockEtcd3 = class {
-  elections = /* @__PURE__ */ new Map();
-  election(key, ttl) {
-    if (!this.elections.has(key)) {
-      this.elections.set(key, new MockElection(key));
-    }
-    return this.elections.get(key);
-  }
-  getElection(key) {
-    return this.elections.get(key);
-  }
-  clearElections() {
-    this.elections.clear();
-  }
-};
-var MockElection = class {
-  constructor(key) {
-    this.key = key;
+// src/plugins/client-code/utils.ts
+function extractParamNames(func) {
+  if (!func || typeof func !== "function") {
+    return [];
   }
-  observers = [];
-  campaigns = [];
-  currentLeader = null;
-  async observe() {
-    const observer = new MockObserver(this);
-    this.observers.push(observer);
-    if (this.currentLeader) {
-      setTimeout(() => {
-        observer.notifyChange(this.currentLeader);
-      }, 0);
+  try {
+    const funcStr = func.toString();
+    const match = funcStr.match(
+      /(?:async\s+)?(?:function\s+\w*\s*)?\(([^)]*)\)|(?:async\s+)?\(([^)]*)\)\s*=>/
+    );
+    if (!match) {
+      return [];
     }
-    return observer;
-  }
-  campaign(candidate) {
-    const campaign = new MockCampaign(candidate, this);
-    this.campaigns.push(campaign);
-    if (!this.currentLeader) {
-      setTimeout(() => {
-        this.setLeader(candidate);
-      }, 50);
+    const paramsStr = match[1] || match[2] || "";
+    if (!paramsStr.trim()) {
+      return [];
     }
-    return campaign;
+    return paramsStr.split(",").map((param) => {
+      return param.replace(/\/\*.*?\*\//g, "").replace(/\/\/.*$/g, "").replace(/:\s*[^=,]+/g, "").replace(/\s*=\s*[^,]+/g, "").trim();
+    }).filter((name) => name.length > 0);
+  } catch (error) {
+    return [];
   }
-  setLeader(leader) {
-    this.currentLeader = leader;
-    for (const observer of this.observers) {
-      observer.notifyChange(leader);
+}
+function convertHandlersToModuleInfo(handlers) {
+  const modules = {};
+  const actionHandlers = handlers.filter(
+    (handler) => handler.type === "action"
+  );
+  for (const handler of actionHandlers) {
+    const actionOptions = handler.options;
+    const moduleClass = handler.module;
+    const methodName = handler.methodName;
+    const moduleName = moduleClass.name.toLowerCase().replace(/service$/, "");
+    if (!modules[moduleName]) {
+      modules[moduleName] = {
+        name: moduleName,
+        actions: {}
+      };
     }
-    setTimeout(() => {
-      for (const campaign of this.campaigns) {
-        if (campaign.candidate === leader && !campaign.resigned) {
-          campaign.notifyElected();
-        }
-      }
-    }, 50);
-  }
-  getCurrentLeader() {
-    return this.currentLeader;
-  }
-};
-var MockObserver = class {
-  constructor(election) {
-    this.election = election;
+    const paramNames = extractParamNames(handler.method);
+    modules[moduleName].actions[methodName] = {
+      description: actionOptions.description,
+      params: actionOptions.params || [],
+      returns: actionOptions.returns,
+      stream: actionOptions.stream || false,
+      idempotence: actionOptions.idempotence || false,
+      paramNames
+    };
   }
-  changeCallbacks = [];
-  on(event, callback) {
-    if (event === "change") {
-      this.changeCallbacks.push(callback);
+  return modules;
+}
+function convertHandlersToModuleInfoWithMetadata(handlers, getModuleMetadata) {
+  const modules = {};
+  const actionHandlers = handlers.filter(
+    (handler) => handler.type === "action"
+  );
+  for (const handler of actionHandlers) {
+    const actionOptions = handler.options;
+    const moduleClass = handler.module;
+    const methodName = handler.methodName;
+    const moduleMetadata = getModuleMetadata(moduleClass);
+    if (!moduleMetadata) {
+      continue;
+    }
+    const moduleName = moduleMetadata.name;
+    if (!modules[moduleName]) {
+      modules[moduleName] = {
+        name: moduleName,
+        actions: {}
+      };
     }
+    const paramNames = extractParamNames(handler.method);
+    modules[moduleName].actions[methodName] = {
+      description: actionOptions.description,
+      params: actionOptions.params || [],
+      returns: actionOptions.returns,
+      stream: actionOptions.stream || false,
+      idempotence: actionOptions.idempotence || false,
+      paramNames
+    };
   }
-  notifyChange(leader) {
-    for (const callback of this.changeCallbacks) {
-      callback(leader);
-    }
+  return modules;
+}
+
+// src/plugins/client-code/plugin.ts
+var ClientCodePlugin = class {
+  name = "client-code-plugin";
+  priority = 1e3 /* ROUTE */;
+  // 路由插件优先级，在 ActionPlugin 之后
+  engine;
+  actionHandlers = [];
+  generatedCode = null;
+  clientSavePath;
+  constructor(options) {
+    this.clientSavePath = options?.clientSavePath;
   }
-};
-var MockCampaign = class {
-  constructor(candidate, election) {
-    this.candidate = candidate;
-    this.election = election;
+  /**
+   * 引擎初始化钩子
+   */
+  onInit(engine) {
+    this.engine = engine;
+    logger_default.info("ClientCodePlugin initialized");
   }
-  errorCallbacks = [];
-  electedCallbacks = [];
-  resigned = false;
-  on(event, callback) {
-    if (event === "error") {
-      this.errorCallbacks.push(callback);
-    } else if (event === "elected") {
-      this.electedCallbacks.push(callback);
-    }
+  /**
+   * Handler加载钩子：收集所有 Action handlers
+   */
+  onHandlerLoad(handlers) {
+    const actionHandlers = handlers.filter(
+      (handler) => handler.type === "action"
+    );
+    this.actionHandlers = actionHandlers;
+    logger_default.info(
+      `ClientCodePlugin collected ${actionHandlers.length} action handler(s)`
+    );
   }
-  notifyElected() {
-    if (!this.resigned) {
-      for (const callback of this.electedCallbacks) {
-        callback();
+  /**
+   * 引擎启动后钩子：注册客户端代码下载路由
+   */
+  async onAfterStart(engine) {
+    await this.generateCode();
+    const prefix = engine.options.prefix || "";
+    const clientPath = prefix ? `${prefix}/client.ts` : "/client.ts";
+    const hono = engine.getHono();
+    hono.get(clientPath, async (ctx) => {
+      if (!this.generatedCode) {
+        await this.generateCode();
       }
-    }
+      return ctx.text(this.generatedCode || "", 200, {
+        "Content-Type": "text/typescript; charset=utf-8",
+        "Content-Disposition": `attachment; filename="client.ts"`
+      });
+    });
+    logger_default.info(`Client code available at ${clientPath}`);
   }
-  notifyError(error) {
-    for (const callback of this.errorCallbacks) {
-      callback(error);
+  /**
+   * 生成客户端代码
+   */
+  async generateCode() {
+    try {
+      const getModuleMetadata = (moduleClass) => {
+        const modules2 = this.engine.getModules();
+        const moduleMetadata = modules2.find((m) => m.clazz === moduleClass);
+        return moduleMetadata ? { name: moduleMetadata.name } : void 0;
+      };
+      const modules = convertHandlersToModuleInfoWithMetadata(
+        this.actionHandlers,
+        getModuleMetadata
+      );
+      this.generatedCode = await generateClientCode(modules);
+      logger_default.debug(
+        `Generated client code for ${Object.keys(modules).length} module(s)`
+      );
+      if (this.clientSavePath && this.generatedCode) {
+        await this.saveCodeToFile(this.clientSavePath, this.generatedCode);
+      }
+    } catch (error) {
+      logger_default.error("Failed to generate client code", error);
+      this.generatedCode = "// Error: Failed to generate client code";
     }
   }
-  async resign() {
-    this.resigned = true;
+  /**
+   * 保存代码到文件
+   */
+  async saveCodeToFile(path, code) {
+    try {
+      const dir = dirname(path);
+      await promises.mkdir(dir, { recursive: true });
+      await promises.writeFile(path, code, "utf-8");
+      logger_default.info(`Client code saved to ${path}`);
+    } catch (error) {
+      logger_default.error(`Failed to save client code to ${path}`, error);
+    }
   }
 };
-
-// src/plugins/schedule/scheduler.ts
-var import_api = __toESM(require_src());
-var tracer = import_api.trace.getTracer("scheduler");
-var Scheduler = class {
-  constructor(etcdClient) {
-    this.etcdClient = etcdClient;
+var Microservice3 = class {
+  // 存储已注册的模块
+  modules = [];
+  // 存储已注册的插件（按注册顺序）
+  plugins = [];
+  // 插件注册表（以name为键，用于覆盖逻辑）
+  pluginRegistry = /* @__PURE__ */ new Map();
+  // 模块实例缓存（单例管理）
+  moduleInstances = /* @__PURE__ */ new Map();
+  // 引擎配置（冻结，只读）
+  options;
+  // 是否已启动
+  started = false;
+  // 模块元数据键（用于通过双向访问查找模块）
+  moduleMetadataKey;
+  // 实际使用的端口（启动后设置）
+  actualPort = null;
+  // Hono 实例（由引擎统一管理）
+  hono = new Hono();
+  // HTTP 服务器实例
+  server = null;
+  constructor(options, moduleMetadataKey) {
+    this.options = Object.freeze({
+      hostname: "0.0.0.0",
+      ...options
+    });
+    this.moduleMetadataKey = moduleMetadataKey;
   }
-  campaigns = /* @__PURE__ */ new Map();
-  timers = /* @__PURE__ */ new Map();
-  isLeader = /* @__PURE__ */ new Map();
   /**
-   * 启动调度任务
+   * 获取 Hono 实例（供插件使用）
    */
-  async startSchedule(serviceId, moduleName, methodName, electionKey, metadata, method) {
-    const election = this.etcdClient.election(electionKey, 10);
-    const observe = await election.observe();
-    observe.on("change", (leader) => {
-      const isLeader = leader === serviceId;
-      this.isLeader.set(serviceId, isLeader);
-      if (!isLeader) {
-        this.stopTimer(serviceId);
+  getHono() {
+    return this.hono;
+  }
+  /**
+   * 内部注册插件方法（供构造函数和子类使用）
+   * @protected
+   */
+  registerPlugin(plugin) {
+    if (!plugin.name || plugin.name.trim() === "") {
+      throw new PluginNameRequiredError();
+    }
+    const existingPlugin = this.pluginRegistry.get(plugin.name);
+    if (existingPlugin) {
+      const oldIndex = this.plugins.indexOf(existingPlugin);
+      if (oldIndex >= 0) {
+        this.plugins.splice(oldIndex, 1);
       }
-    });
-    const campaign = election.campaign(serviceId);
-    this.campaigns.set(serviceId, campaign);
-    campaign.on("error", (error) => {
-      logger_default.error(`Error in campaign for ${moduleName}.${methodName}:`, error);
-    });
-    campaign.on("elected", () => {
-      this.isLeader.set(serviceId, true);
-      this.startTimer(serviceId, metadata, moduleName, method);
-      logger_default.info(`become leader for ${moduleName}.${methodName}`);
-    });
+      logger_default.info(`Override plugin: ${plugin.name}`);
+    }
+    this.pluginRegistry.set(plugin.name, plugin);
+    this.plugins.push(plugin);
   }
   /**
-   * 启动定时器
+   * 加载并注册所有模块（通过唯一的 key 查找）
+   * 在引擎启动时调用，使用双向访问机制查找所有被装饰的类
+   *
+   * 注意：
+   * - 每个引擎实例使用唯一的 moduleMetadataKey，实现隔离
+   * - 模块类是静态的，可以被多个引擎实例共享
+   * - 每个引擎实例会创建独立的模块实例，互不影响
    */
-  startTimer(serviceId, metadata, moduleName, method) {
-    this.stopTimer(serviceId);
-    const wrappedMethod = async () => {
-      tracer.startActiveSpan(
-        `ScheduleTask ${moduleName}.${metadata.name}`,
-        { root: true },
-        async (span) => {
-          span.setAttribute("serviceId", serviceId);
-          span.setAttribute("methodName", metadata.name);
-          span.setAttribute("moduleName", moduleName);
-          span.setAttribute("interval", metadata.interval);
-          span.setAttribute("mode", metadata.mode);
-          try {
-            await method();
-          } catch (error) {
-            span.setStatus({
-              code: import_api.SpanStatusCode.ERROR,
-              message: error.message
-            });
-            logger_default.error(
-              `Error executing schedule task ${moduleName}.${metadata.name}:`,
-              error
-            );
-          } finally {
-            span.setStatus({ code: import_api.SpanStatusCode.OK });
-            span.end();
-          }
-        }
-      );
-    };
-    if (metadata.mode === "FIXED_DELAY" /* FIXED_DELAY */) {
-      const runTask = async () => {
-        if (!this.isLeader.get(serviceId)) return;
-        try {
-          await wrappedMethod();
-        } finally {
-          this.timers.set(serviceId, setTimeout(runTask, metadata.interval));
-        }
+  loadModules() {
+    this.modules = [];
+    const moduleClasses = getClassesByKey(this.moduleMetadataKey);
+    for (const moduleClass of moduleClasses) {
+      const metadata = getClassMetadata(moduleClass, this.moduleMetadataKey);
+      const moduleName = metadata.name || moduleClass.name;
+      const existingModule = this.modules.find((m) => m.name === moduleName);
+      if (existingModule) {
+        throw new DuplicateModuleError(moduleName);
+      }
+      const moduleMetadata = {
+        name: moduleName,
+        clazz: moduleClass,
+        options: metadata.options || {}
       };
-      runTask();
-    } else {
-      this.timers.set(
-        serviceId,
-        setInterval(async () => {
-          if (!this.isLeader.get(serviceId)) return;
-          await wrappedMethod();
-        }, metadata.interval)
-      );
+      this.modules.push(moduleMetadata);
     }
   }
   /**
-   * 停止定时器
+   * 加载Handler元数据（平铺结构）
+   * 每个装饰器都是独立的HandlerMetadata条目
+   * 为每个方法创建包装链管理器，提供简单的 wrap API
    */
-  stopTimer(serviceId) {
-    const timer = this.timers.get(serviceId);
-    if (timer) {
-      clearTimeout(timer);
-      clearInterval(timer);
-      this.timers.delete(serviceId);
+  loadHandlerMetadata() {
+    const handlers = [];
+    const wrapperChains = /* @__PURE__ */ new Map();
+    const originalMethods = /* @__PURE__ */ new Map();
+    for (const module of this.modules) {
+      if (!this.moduleInstances.has(module.clazz)) {
+        this.get(module.clazz);
+      }
+      const allMetadata = getAllHandlerMetadata(module.clazz);
+      for (const [methodName, metadataList] of allMetadata.entries()) {
+        const method = module.clazz.prototype[methodName];
+        const methodNameStr = String(methodName);
+        const methodKey = `${module.clazz.name}.${methodNameStr}`;
+        if (!originalMethods.has(methodKey)) {
+          originalMethods.set(methodKey, method);
+          wrapperChains.set(methodKey, []);
+        }
+        for (const meta of metadataList) {
+          const chain = wrapperChains.get(methodKey);
+          handlers.push({
+            ...meta,
+            method: originalMethods.get(methodKey),
+            methodName: methodNameStr,
+            module: module.clazz,
+            // 提供简单的 wrap API：插件只需要调用这个方法
+            wrap: (wrapper) => {
+              chain.push(wrapper);
+            }
+          });
+        }
+      }
     }
+    this.__wrapperChains__ = wrapperChains;
+    this.__originalMethods__ = originalMethods;
+    return handlers;
   }
   /**
-   * 停止所有调度任务
+   * 应用所有包装链到原型
+   * 在所有插件执行完 onHandlerLoad 后调用
    */
-  async stop() {
-    for (const serviceId of this.timers.keys()) {
-      this.stopTimer(serviceId);
-    }
-    for (const [serviceId, campaign] of this.campaigns.entries()) {
-      try {
-        await campaign.resign().catch(() => {
-        });
-      } catch (error) {
-        logger_default.error(`Error stopping schedule ${serviceId}:`, error);
-      } finally {
-        this.campaigns.delete(serviceId);
-        this.isLeader.delete(serviceId);
+  applyWrapperChains() {
+    const wrapperChains = this.__wrapperChains__;
+    const originalMethods = this.__originalMethods__;
+    if (!wrapperChains || !originalMethods) return;
+    for (const [methodKey, chain] of wrapperChains.entries()) {
+      if (chain.length === 0) continue;
+      const [moduleName, methodName] = methodKey.split(".");
+      const module = this.modules.find((m) => m.clazz.name === moduleName);
+      if (!module) continue;
+      const originalMethod = originalMethods.get(methodKey);
+      const prototype = module.clazz.prototype;
+      let wrappedMethod = originalMethod;
+      for (let i = chain.length - 1; i >= 0; i--) {
+        const wrapper = chain[i];
+        const next = wrappedMethod;
+        wrappedMethod = async function(...args) {
+          return wrapper(() => next.apply(this, args), this, ...args);
+        };
       }
+      prototype[methodName] = wrappedMethod;
     }
   }
-};
-
-// src/plugins/schedule/utils.ts
-function extractScheduleMetadata(handlers) {
-  const result = /* @__PURE__ */ new Map();
-  const scheduleHandlers = handlers.filter(
-    (handler) => handler.type === "schedule"
-  );
-  for (const handler of scheduleHandlers) {
-    const moduleClass = handler.module;
-    const methodName = handler.methodName;
-    const options = handler.options || {};
-    if (!result.has(moduleClass)) {
-      result.set(moduleClass, /* @__PURE__ */ new Map());
-    }
-    const moduleMetadata = result.get(moduleClass);
-    moduleMetadata.set(methodName, {
-      name: methodName,
-      interval: options.interval,
-      mode: options.mode || "FIXED_RATE" /* FIXED_RATE */
+  /**
+   * 寻找一个随机的可用端口
+   */
+  getRandomPort(hostname) {
+    return new Promise((resolve, reject) => {
+      const server = net.createServer();
+      server.unref();
+      server.on("error", reject);
+      server.listen(0, hostname, () => {
+        const port = server.address().port;
+        server.close((err) => {
+          if (err) {
+            return reject(err);
+          }
+          resolve(port);
+        });
+      });
     });
   }
-  return result;
-}
-
-// src/plugins/schedule/plugin.ts
-var SchedulePlugin = class {
-  name = "schedule-plugin";
-  priority = 300 /* BUSINESS */;
-  // 业务逻辑优先级
-  engine;
-  scheduler = null;
-  etcdClient = null;
-  scheduleHandlers = [];
-  useMockEtcd = false;
-  constructor(options) {
-    if (options?.useMockEtcd) {
-      this.useMockEtcd = true;
-      this.etcdClient = new MockEtcd3();
-      logger_default.info("SchedulePlugin: Using MockEtcd3 for local development/testing");
-    } else if (options?.etcdClient) {
-      this.etcdClient = options.etcdClient;
-    }
-  }
   /**
-   * 引擎初始化钩子
+   * 启动引擎
+   * @param requestedPort 启动端口（可选，默认0，表示随机端口）
+   * @returns 实际使用的端口号
    */
-  onInit(engine) {
-    this.engine = engine;
-    logger_default.info("SchedulePlugin initialized");
+  async start(requestedPort = 0) {
+    if (this.started) {
+      throw new Error("Engine is already started");
+    }
+    try {
+      const { port, hostname } = await this.determinePort(requestedPort);
+      this.initializeModulesAndPlugins();
+      this.processHandlers();
+      await this.executePluginStartHooks();
+      this.startHttpServer(port, hostname);
+      this.started = true;
+      logger_default.info(
+        `${this.options.name} v${this.options.version} started successfully on port ${this.actualPort}`
+      );
+      return this.actualPort;
+    } catch (error) {
+      logger_default.error("Failed to start engine", error);
+      throw error;
+    }
   }
   /**
-   * Handler加载钩子：收集所有调度任务
+   * 确定实际使用的端口
    */
-  onHandlerLoad(handlers) {
-    this.scheduleHandlers = handlers.filter(
-      (handler) => handler.type === "schedule"
-    );
-    logger_default.info(
-      `SchedulePlugin: Found ${this.scheduleHandlers.length} schedule handler(s)`
-    );
+  async determinePort(requestedPort) {
+    const hostname = this.options.hostname || "0.0.0.0";
+    if (requestedPort !== 0) {
+      this.actualPort = requestedPort;
+      return { port: this.actualPort, hostname };
+    }
+    this.actualPort = await this.getRandomPort(hostname);
+    return { port: this.actualPort, hostname };
   }
   /**
-   * 引擎启动后钩子：启动所有调度任务
+   * 初始化模块和插件
    */
-  async onAfterStart(engine) {
-    if (!this.etcdClient) {
-      logger_default.warn(
-        "SchedulePlugin: etcdClient not configured and useMockEtcd is false, schedule tasks will not start"
-      );
-      return;
-    }
-    this.scheduler = new Scheduler(this.etcdClient);
-    const modules = engine.getModules();
-    if (!this.scheduleHandlers) {
-      logger_default.warn(
-        "SchedulePlugin: No schedule handlers found, schedule tasks will not start"
-      );
-      return;
-    }
-    const scheduleMetadataMap = extractScheduleMetadata(this.scheduleHandlers);
-    const serviceId = `${engine.options.name}-${Date.now()}-${Math.random()}`;
-    for (const moduleMetadata of modules) {
-      const moduleClass = moduleMetadata.clazz;
-      const moduleName = moduleMetadata.name;
-      const moduleInstance = engine.get(moduleClass);
-      const moduleScheduleMetadata = scheduleMetadataMap.get(moduleClass);
-      if (!moduleScheduleMetadata || moduleScheduleMetadata.size === 0) {
-        continue;
-      }
-      for (const [methodName, metadata] of moduleScheduleMetadata.entries()) {
-        const method = moduleInstance[methodName];
-        if (typeof method !== "function") {
-          logger_default.warn(
-            `SchedulePlugin: Method ${moduleName}.${methodName} is not a function, skipping`
-          );
-          continue;
-        }
-        const electionKey = `/schedule/${engine.options.name}/${moduleName}/${methodName}`;
-        const taskServiceId = `${serviceId}-${moduleName}-${methodName}`;
-        try {
-          await this.scheduler.startSchedule(
-            taskServiceId,
-            moduleName,
-            methodName,
-            electionKey,
-            metadata,
-            method.bind(moduleInstance)
-          );
-          logger_default.info(
-            `SchedulePlugin: Started schedule task ${moduleName}.${methodName} (interval: ${metadata.interval}ms, mode: ${metadata.mode})`
-          );
-        } catch (error) {
-          logger_default.error(
-            `SchedulePlugin: Failed to start schedule task ${moduleName}.${methodName}:`,
-            error
-          );
-        }
-      }
-    }
+  initializeModulesAndPlugins() {
+    this.loadModules();
+    this.executePluginHook("onInit", (plugin) => {
+      plugin.onInit?.(this);
+    });
+    this.executePluginHook("onModuleLoad", (plugin) => {
+      plugin.onModuleLoad?.(
+        this.modules
+      );
+    });
   }
   /**
-   * 引擎销毁钩子：停止所有调度任务
+   * 处理 Handler 元数据和插件包装
    */
-  async onDestroy() {
-    if (this.scheduler) {
+  processHandlers() {
+    const handlers = this.loadHandlerMetadata();
+    const sortedPlugins = this.sortPluginsByPriority();
+    const { wrapperPlugins, routePlugins } = this.separateWrapperAndRoutePlugins(sortedPlugins);
+    this.executePluginHook(
+      "onHandlerLoad",
+      (plugin) => {
+        plugin.onHandlerLoad?.(handlers);
+      },
+      wrapperPlugins
+    );
+    this.applyWrapperChains();
+    this.executePluginHook(
+      "onHandlerLoad",
+      (plugin) => {
+        plugin.onHandlerLoad?.(handlers);
+      },
+      routePlugins
+    );
+  }
+  /**
+   * 执行插件启动钩子
+   */
+  async executePluginStartHooks() {
+    this.executePluginHook("onBeforeStart", (plugin) => {
+      plugin.onBeforeStart?.(this);
+    });
+    for (const plugin of this.plugins) {
       try {
-        await this.scheduler.stop();
-        logger_default.info("SchedulePlugin: All schedule tasks stopped");
+        await plugin.onAfterStart?.(this);
       } catch (error) {
-        logger_default.error("SchedulePlugin: Error stopping schedule tasks:", error);
+        throw new Error(
+          `Plugin ${plugin.name} failed in onAfterStart: ${error instanceof Error ? error.message : String(error)}`
+        );
       }
     }
+    this.registerVersionRoute();
   }
-};
-
-// src/plugins/client-code/utils.ts
-function extractParamNames(func) {
-  if (!func || typeof func !== "function") {
-    return [];
-  }
-  try {
-    const funcStr = func.toString();
-    const match = funcStr.match(
-      /(?:async\s+)?(?:function\s+\w*\s*)?\(([^)]*)\)|(?:async\s+)?\(([^)]*)\)\s*=>/
+  /**
+   * 注册版本路由（/prefix/version）
+   * 用于健康检查和探针
+   */
+  registerVersionRoute() {
+    const prefix = this.options.prefix || "";
+    const versionPath = prefix ? `${prefix}` : "/";
+    const existingRoutes = this.hono.routes;
+    const routeExists = existingRoutes.some(
+      (route) => route.path === versionPath && route.method === "GET"
     );
-    if (!match) {
-      return [];
-    }
-    const paramsStr = match[1] || match[2] || "";
-    if (!paramsStr.trim()) {
-      return [];
-    }
-    return paramsStr.split(",").map((param) => {
-      return param.replace(/\/\*.*?\*\//g, "").replace(/\/\/.*$/g, "").replace(/:\s*[^=,]+/g, "").replace(/\s*=\s*[^,]+/g, "").trim();
-    }).filter((name) => name.length > 0);
-  } catch (error) {
-    return [];
-  }
-}
-function convertHandlersToModuleInfo(handlers) {
-  const modules = {};
-  const actionHandlers = handlers.filter(
-    (handler) => handler.type === "action"
-  );
-  for (const handler of actionHandlers) {
-    const actionOptions = handler.options;
-    const moduleClass = handler.module;
-    const methodName = handler.methodName;
-    const moduleName = moduleClass.name.toLowerCase().replace(/service$/, "");
-    if (!modules[moduleName]) {
-      modules[moduleName] = {
-        name: moduleName,
-        actions: {}
-      };
-    }
-    const paramNames = extractParamNames(handler.method);
-    modules[moduleName].actions[methodName] = {
-      description: actionOptions.description,
-      params: actionOptions.params || [],
-      returns: actionOptions.returns,
-      stream: actionOptions.stream || false,
-      idempotence: actionOptions.idempotence || false,
-      paramNames
-    };
-  }
-  return modules;
-}
-function convertHandlersToModuleInfoWithMetadata(handlers, getModuleMetadata) {
-  const modules = {};
-  const actionHandlers = handlers.filter(
-    (handler) => handler.type === "action"
-  );
-  for (const handler of actionHandlers) {
-    const actionOptions = handler.options;
-    const moduleClass = handler.module;
-    const methodName = handler.methodName;
-    const moduleMetadata = getModuleMetadata(moduleClass);
-    if (!moduleMetadata) {
-      continue;
-    }
-    const moduleName = moduleMetadata.name;
-    if (!modules[moduleName]) {
-      modules[moduleName] = {
-        name: moduleName,
-        actions: {}
-      };
-    }
-    const paramNames = extractParamNames(handler.method);
-    modules[moduleName].actions[methodName] = {
-      description: actionOptions.description,
-      params: actionOptions.params || [],
-      returns: actionOptions.returns,
-      stream: actionOptions.stream || false,
-      idempotence: actionOptions.idempotence || false,
-      paramNames
-    };
-  }
-  return modules;
-}
-async function formatCode(code) {
-  try {
-    return prettier.format(code, { parser: "typescript" });
-  } catch {
-    return code;
-  }
-}
-
-// src/plugins/client-code/generator.ts
-function getZodTypeString(schema, defaultOptional = false) {
-  function processType(type) {
-    if (!type) {
-      return "unknown";
-    }
-    const def = type._def;
-    const typeName = def.type;
-    if (typeName === "nullable") {
-      return `${processType(def.innerType)} | null`;
-    }
-    if (typeName === "optional") {
-      return processType(def.innerType);
-    }
-    if (typeName === "pipe" && def.in) {
-      return processType(def.in);
-    }
-    if (typeName === "effects" && def.schema) {
-      return processType(def.schema);
-    }
-    switch (typeName) {
-      case "string": {
-        return "string";
-      }
-      case "number": {
-        return "number";
-      }
-      case "bigint": {
-        return "bigint";
-      }
-      case "boolean": {
-        return "boolean";
-      }
-      case "array": {
-        const elementType = processType(def.element);
-        return `${elementType}[]`;
-      }
-      case "date": {
-        return "Date";
-      }
-      case "object": {
-        const shape = typeof def.shape === "function" ? def.shape() : def.shape;
-        const props = Object.entries(shape).map(([key, value]) => {
-          if (key.includes("-")) {
-            key = `'${key}'`;
-          }
-          const fieldDef = value._def;
-          const fieldTypeName = fieldDef.type;
-          const isOptional = fieldTypeName === "optional";
-          const isDefault = defaultOptional && fieldTypeName === "default";
-          const fieldType = processType(
-            isOptional ? fieldDef.innerType : value
-          );
-          return `${key}${isOptional || isDefault ? "?" : ""}: ${fieldType}`;
-        }).join("; ");
-        return `{ ${props} }`;
-      }
-      case "union": {
-        return def.options.map((opt) => processType(opt)).join(" | ");
-      }
-      case "null": {
-        return "null";
-      }
-      case "promise": {
-        return `Promise<${processType(def.type)}>`;
-      }
-      case "void": {
-        return "void";
-      }
-      case "record": {
-        if (def.valueType) {
-          const keyType = def.keyType ? processType(def.keyType) : "string";
-          return `Record<${keyType}, ${processType(def.valueType)}>`;
-        } else if (def.keyType) {
-          return `Record<string, ${processType(def.keyType)}>`;
-        }
-        return "Record<string, any>";
-      }
-      case "map": {
-        return `Map<${processType(def.keyType)}, ${processType(
-          def.valueType
-        )}>`;
-      }
-      case "any": {
-        return "any";
-      }
-      case "unknown": {
-        return "unknown";
-      }
-      case "enum": {
-        const values = def.entries ? Object.values(def.entries) : [];
-        return "(" + values.map((opt) => `"${String(opt)}"`).join(" | ") + ")";
-      }
-      case "default": {
-        return processType(def.innerType);
-      }
-      default: {
-        if (type.safeParse(new Uint8Array()).success) {
-          return "Uint8Array";
-        }
-        return "unknown";
+    if (routeExists) {
+      logger_default.info(
+        `Version route ${versionPath} already exists, skipping registration`
+      );
+      return;
+    }
+    try {
+      this.hono.get(versionPath, async (ctx) => {
+        return ctx.json({
+          name: this.options.name,
+          version: this.options.version,
+          status: "running"
+        });
+      });
+      logger_default.info(`Registered version route: GET ${versionPath}`);
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("matcher is already built")) {
+        logger_default.warn(
+          `Cannot register version route ${versionPath}: route matcher is already built. If you have already registered a route at ${versionPath}, it will be used instead.`
+        );
+      } else {
+        throw error;
       }
     }
   }
-  return processType(schema);
-}
-async function generateClientCode(modules) {
-  const imports = [
-    "// \u8FD9\u4E2A\u6587\u4EF6\u662F\u81EA\u52A8\u751F\u6210\u7684\uFF0C\u8BF7\u4E0D\u8981\u624B\u52A8\u4FEE\u6539",
-    "",
-    'import { MicroserviceClient as BaseMicroserviceClient } from "imean-service-client";',
-    'export * from "imean-service-client";',
-    ""
-  ].join("\n");
-  function toPascalCase(moduleName) {
-    return moduleName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
-  }
-  function toCamelCase(moduleName) {
-    const parts = moduleName.split("-");
-    return parts[0] + parts.slice(1).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+  /**
+   * 启动 HTTP 服务器
+   */
+  startHttpServer(port, hostname) {
+    this.server = serve({
+      fetch: this.hono.fetch,
+      port,
+      hostname
+    });
+    logger_default.info(`HTTP server started on http://${hostname}:${port}`);
   }
-  const interfaces = Object.entries(modules).map(([name, module]) => {
-    const methods = Object.entries(module.actions).map(([actionName, action]) => {
-      if (!action.params) {
-        throw new Error(`Missing params for action ${actionName}`);
+  /**
+   * 按优先级排序插件
+   */
+  sortPluginsByPriority() {
+    return [...this.plugins].sort((a, b) => {
+      const priorityA = this.getPluginPriority(a);
+      const priorityB = this.getPluginPriority(b);
+      if (priorityA !== priorityB) {
+        return priorityA - priorityB;
       }
-      const paramNames = action.paramNames || [];
-      const params = action.params.map((param, index) => {
-        const paramName = paramNames[index] || param.description || `arg${index}`;
-        const paramDef = param._def;
-        const isOptional = param.isOptional();
-        const hasDefault = paramDef?.type === "default";
-        return `${paramName}${isOptional || hasDefault ? "?" : ""}: ${getZodTypeString(
-          param,
-          true
-        )}`;
-      }).join(", ");
-      const returnType = action.returns ? getZodTypeString(action.returns) : "void";
-      return `
-        /**
-         * ${action.description || ""}
-         */
-        ${actionName}: (${params}) => Promise<${action.stream ? `AsyncIterable<${returnType}>` : returnType}>;`;
-    }).join("\n    ");
-    const interfaceName = `${toPascalCase(name)}Module`;
-    return `export interface ${interfaceName} {
-    ${methods}
-}`;
-  }).join("\n\n");
-  const clientClass = `export class MicroserviceClient extends BaseMicroserviceClient {
-  constructor(options: any) {
-    super(options);
-  }
-
-  ${Object.entries(modules).map(([name, module]) => {
-    const methods = Object.entries(module.actions).map(([actionName, action]) => {
-      return `${actionName}: { idempotent: ${!!action.idempotence}, stream: ${!!action.stream} }`;
-    }).join(",\n      ");
-    const propertyName = toCamelCase(name);
-    const interfaceName = `${toPascalCase(name)}Module`;
-    return `public readonly ${propertyName} = this.registerModule<${interfaceName}>("${name}", {
-      ${methods}
-    });`;
-  }).join("\n\n  ")}
-}`;
-  return await formatCode([imports, interfaces, clientClass].join("\n\n"));
-}
-
-// src/plugins/client-code/plugin.ts
-var ClientCodePlugin = class {
-  name = "client-code-plugin";
-  priority = 1e3 /* ROUTE */;
-  // 路由插件优先级，在 ActionPlugin 之后
-  engine;
-  actionHandlers = [];
-  generatedCode = null;
-  clientSavePath;
-  constructor(options) {
-    this.clientSavePath = options?.clientSavePath;
+      const indexA = this.plugins.indexOf(a);
+      const indexB = this.plugins.indexOf(b);
+      return indexA - indexB;
+    });
   }
   /**
-   * 引擎初始化钩子
+   * 获取插件优先级
    */
-  onInit(engine) {
-    this.engine = engine;
-    logger_default.info("ClientCodePlugin initialized");
+  getPluginPriority(plugin) {
+    return plugin.priority ?? 300 /* BUSINESS */;
   }
   /**
-   * Handler加载钩子：收集所有 Action handlers
+   * 分离包装插件和路由插件
    */
-  onHandlerLoad(handlers) {
-    const actionHandlers = handlers.filter(
-      (handler) => handler.type === "action"
-    );
-    this.actionHandlers = actionHandlers;
-    logger_default.info(
-      `ClientCodePlugin collected ${actionHandlers.length} action handler(s)`
-    );
+  separateWrapperAndRoutePlugins(sortedPlugins) {
+    const wrapperPlugins = [];
+    const routePlugins = [];
+    for (const plugin of sortedPlugins) {
+      const priority = this.getPluginPriority(plugin);
+      if (priority === 1e3 /* ROUTE */) {
+        routePlugins.push(plugin);
+      } else {
+        wrapperPlugins.push(plugin);
+      }
+    }
+    return { wrapperPlugins, routePlugins };
   }
   /**
-   * 引擎启动后钩子：注册客户端代码下载路由
+   * 执行插件钩子（通用方法）
    */
-  async onAfterStart(engine) {
-    await this.generateCode();
-    const prefix = engine.options.prefix || "";
-    const clientPath = prefix ? `${prefix}/client.ts` : "/client.ts";
-    const hono = engine.getHono();
-    hono.get(clientPath, async (ctx) => {
-      if (!this.generatedCode) {
-        await this.generateCode();
+  executePluginHook(hookName, callback, plugins = this.plugins) {
+    for (const plugin of plugins) {
+      try {
+        callback(plugin);
+      } catch (error) {
+        throw new Error(
+          `Plugin ${plugin.name} failed in ${hookName}: ${error instanceof Error ? error.message : String(error)}`
+        );
       }
-      return ctx.text(this.generatedCode || "", 200, {
-        "Content-Type": "text/typescript; charset=utf-8",
-        "Content-Disposition": `attachment; filename="client.ts"`
-      });
-    });
-    logger_default.info(`Client code available at ${clientPath}`);
+    }
   }
   /**
-   * 生成客户端代码
+   * 停止引擎
    */
-  async generateCode() {
+  async stop() {
+    if (!this.started) {
+      return;
+    }
     try {
-      const getModuleMetadata = (moduleClass) => {
-        const modules2 = this.engine.getModules();
-        const moduleMetadata = modules2.find((m) => m.clazz === moduleClass);
-        return moduleMetadata ? { name: moduleMetadata.name } : void 0;
-      };
-      const modules = convertHandlersToModuleInfoWithMetadata(
-        this.actionHandlers,
-        getModuleMetadata
-      );
-      this.generatedCode = await generateClientCode(modules);
-      logger_default.debug(
-        `Generated client code for ${Object.keys(modules).length} module(s)`
-      );
-      if (this.clientSavePath && this.generatedCode) {
-        await this.saveCodeToFile(this.clientSavePath, this.generatedCode);
+      if (this.server) {
+        if (typeof this.server.close === "function") {
+          if (this.server.close.length > 0) {
+            await new Promise((resolve, reject) => {
+              this.server.close((err) => {
+                if (err) {
+                  reject(err);
+                } else {
+                  resolve();
+                }
+              });
+            });
+          } else {
+            this.server.close();
+            await new Promise((resolve) => setTimeout(resolve, 10));
+          }
+        }
+        this.server = null;
+        logger_default.info("HTTP server stopped");
       }
+      for (let i = this.plugins.length - 1; i >= 0; i--) {
+        const plugin = this.plugins[i];
+        try {
+          await plugin.onDestroy?.();
+        } catch (error) {
+          logger_default.error(`Plugin ${plugin.name} failed in onDestroy`, error);
+        }
+      }
+      this.modules = [];
+      this.moduleInstances.clear();
+      this.started = false;
+      this.actualPort = null;
+      logger_default.info(`${this.options.name} stopped`);
     } catch (error) {
-      logger_default.error("Failed to generate client code", error);
-      this.generatedCode = "// Error: Failed to generate client code";
+      logger_default.error("Failed to stop engine", error);
+      throw error;
     }
   }
   /**
-   * 保存代码到文件
+   * 获取模块实例（单例）
+   * @param moduleClass 模块类
+   * @returns 模块实例
    */
-  async saveCodeToFile(path, code) {
-    try {
-      const dir = dirname(path);
-      await promises.mkdir(dir, { recursive: true });
-      await promises.writeFile(path, code, "utf-8");
-      logger_default.info(`Client code saved to ${path}`);
-    } catch (error) {
-      logger_default.error(`Failed to save client code to ${path}`, error);
+  get(moduleClass) {
+    if (!this.moduleInstances.has(moduleClass)) {
+      this.moduleInstances.set(moduleClass, new moduleClass());
     }
+    return this.moduleInstances.get(moduleClass);
+  }
+  /**
+   * 获取已注册的模块列表
+   */
+  getModules() {
+    if (this.modules.length === 0 && !this.started) {
+      this.loadModules();
+    }
+    return [...this.modules];
+  }
+  /**
+   * 获取实际使用的端口
+   */
+  getPort() {
+    return this.actualPort;
   }
 };
 
@@ -4100,7 +4232,7 @@ var Factory = class {
     const moduleMetadataKey = /* @__PURE__ */ Symbol.for(
       `imean:moduleMetadata:${Date.now()}:${Math.random()}`
     );
-    class TypedMicroservice extends Microservice {
+    class TypedMicroservice extends Microservice3 {
       constructor(options) {
         super(options, moduleMetadataKey);
         for (const plugin of plugins) {
@@ -4130,8 +4262,8 @@ var DEFAULT_TEST_OPTIONS = {
 };
 function createTestEngine(config) {
   const factory = Factory.create(...config.plugins);
-  const Microservice6 = factory.Microservice;
-  const engine = new Microservice6({
+  const Microservice4 = factory.Microservice;
+  const engine = new Microservice4({
     ...DEFAULT_TEST_OPTIONS,
     ...config.options
   });
@@ -4149,4 +4281,4 @@ var Testing = {
   wait
 };
 
-export { Action, ActionPlugin, BaseLayout, Cache, CachePlugin, ClientCodePlugin, DEFAULT_TEST_OPTIONS, DuplicateModuleError, Factory, GracefulShutdownPlugin, Handler, HtmxLayout, MemoryCacheAdapter, Microservice, MockEtcd3, ModuleConfigValidationError, Page, PluginNameRequiredError, PluginPriority, RedisCacheAdapter, Route, RoutePlugin, Schedule, ScheduleMode, SchedulePlugin, Scheduler, Testing, convertHandlersToModuleInfo, convertHandlersToModuleInfoWithMetadata, generateClientCode, getZodTypeString, startCheck };
+export { Action, ActionPlugin, BaseLayout, Cache, CachePlugin, ClientCodePlugin, DEFAULT_TEST_OPTIONS, DuplicateModuleError, Factory, GracefulShutdownPlugin, Handler, HtmxLayout, MemoryCacheAdapter, MockEtcd3, ModuleConfigValidationError, Page, PluginNameRequiredError, PluginPriority, RedisCacheAdapter, Route, RoutePlugin, Schedule, ScheduleMode, SchedulePlugin, Scheduler, ServiceInfoCards, ServiceStatusPage, Testing, convertHandlersToModuleInfo, convertHandlersToModuleInfoWithMetadata, generateClientCode, getZodTypeString, startCheck };