imean-service-engine 1.6.0 → 1.7.1

package/dist/mod.cjs

@@ -7,6 +7,7 @@ var nodeServer = require('@hono/node-server');
 var etcd3 = require('etcd3');
 var fs = require('fs-extra');
 var hono = require('hono');
+var timing = require('hono/timing');
 var api = require('@opentelemetry/api');
 var winston = require('winston');
 var prettier = require('prettier');
@@ -17,6 +18,8 @@ var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var types_js = require('@modelcontextprotocol/sdk/types.js');
 var streaming = require('hono/streaming');
 var ulid = require('ulid');
+var html = require('hono/html');
+var jsxRuntime = require('hono/jsx/jsx-runtime');
 var dayjs = require('dayjs');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -595,6 +598,62 @@ var ActionHandler = class {
 function isAsyncIterable(obj) {
   return obj != null && typeof obj[Symbol.asyncIterator] === "function";
 }
+
+// decorators/page.ts
+var PAGE_METADATA = Symbol("page:metadata");
+function Page(options) {
+  return function(_target, context) {
+    const methodName = context.name;
+    context.addInitializer(function() {
+      const prototype = this.constructor.prototype;
+      const existingMetadata = prototype[PAGE_METADATA] || {};
+      existingMetadata[methodName] = {
+        name: methodName,
+        description: options.description || "",
+        method: options.method,
+        path: options.path
+      };
+      prototype[PAGE_METADATA] = existingMetadata;
+    });
+  };
+}
+function getPageMetadata(target) {
+  return target.constructor.prototype[PAGE_METADATA] ?? {};
+}
+var tracer3 = api.trace.getTracer("page-handler");
+var PageHandler = class {
+  constructor(moduleInstance, options, moduleName) {
+    this.moduleInstance = moduleInstance;
+    this.options = options;
+    this.moduleName = moduleName;
+  }
+  async handle(ctx) {
+    return await tracer3.startActiveSpan(
+      `handle ${this.moduleName}.${this.options.name}`,
+      async (span) => {
+        span.setAttribute("module", this.moduleName);
+        span.setAttribute("page", this.options.name);
+        span.setAttribute("path", this.options.path);
+        try {
+          const result = await this.moduleInstance[this.options.name].apply(
+            this.moduleInstance,
+            [ctx]
+          );
+          return ctx.html(result);
+        } catch (error) {
+          span.recordException(error);
+          span.setStatus({
+            code: api.SpanStatusCode.ERROR,
+            message: error.message
+          });
+          throw error;
+        } finally {
+          span.end();
+        }
+      }
+    );
+  }
+};
 var WebSocketHandler = class {
   constructor(microservice, options) {
     this.microservice = microservice;
@@ -782,6 +841,7 @@ var Microservice = class {
   statisticsTimer;
   wsHandler;
   actionHandlers = /* @__PURE__ */ new Map();
+  pageHandlers = /* @__PURE__ */ new Map();
   activeRequests = /* @__PURE__ */ new Map();
   status = "running";
   modules = /* @__PURE__ */ new Map();
@@ -791,6 +851,7 @@ var Microservice = class {
   serviceId;
   constructor(options) {
     this.app = new hono.Hono();
+    this.app.use(timing.timing());
     this.nodeWebSocket = nodeWs.createNodeWebSocket({ app: this.app });
     this.serviceId = crypto.randomUUID();
     this.options = {
@@ -829,6 +890,11 @@ var Microservice = class {
     }
     await this.registerService(true);
     await this.initPlugins();
+    this.app.get(this.options.prefix, (ctx) => {
+      const name = this.options.name ?? "Microservice";
+      const version = this.options.version ?? "1.0.0";
+      return ctx.text(`${name} is ${this.status}. version: ${version}`);
+    });
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -843,6 +909,7 @@ var Microservice = class {
       logger_default.info(`[ \u6CE8\u518C\u6A21\u5757 ] ${moduleName} ${metadata.options.description}`);
       this.modules.set(moduleName, moduleInstance);
       const actions = getActionMetadata(ModuleClass.prototype);
+      const pages = getPageMetadata(ModuleClass.prototype);
       for (const [actionName, actionMetadata] of Object.entries(actions)) {
         const handler = new ActionHandler(
           moduleInstance,
@@ -856,6 +923,18 @@ var Microservice = class {
           `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description} ${actionMetadata.mcp ? "MCP:" + actionMetadata.mcp?.type : ""}`
         );
       }
+      for (const [_, page] of Object.entries(pages)) {
+        const handler = new PageHandler(
+          moduleInstance,
+          page,
+          moduleName
+        );
+        this.pageHandlers.set(`${moduleName}.${page.name}`, handler);
+        this.app[page.method](`${this.options.prefix}${page.path}`, (ctx) => handler.handle(ctx));
+        logger_default.info(
+          `[ \u6CE8\u518C\u9875\u9762 ] ${moduleName}.${page.name} ${page.method.toUpperCase()} ${page.path} ${page.description}`
+        );
+      }
       const schedules = getScheduleMetadata(ModuleClass.prototype);
       if (schedules && Object.keys(schedules).length > 0) {
         if (!this.scheduler && this.etcdClient) {
@@ -885,11 +964,6 @@ var Microservice = class {
   initRoutes() {
     const startTime = Date.now();
     const prefix = this.options.prefix || "/api";
-    this.app.get(prefix, (ctx) => {
-      const name = this.options.name ?? "Microservice";
-      const version = this.options.version ?? "1.0.0";
-      return ctx.text(`${name} is ${this.status}. version: ${version}`);
-    });
     this.app.get(`${prefix}/health`, (ctx) => {
       return ctx.json({
         status: "ok",
@@ -1332,28 +1406,6 @@ Received SIGTERM signal`);
     await this.waitingInitialization;
   }
 };
-
-// utils/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 HonoTransport = class {
   constructor(url, stream, closeStream) {
     this.url = url;
@@ -1469,22 +1521,227 @@ var ModelContextProtocolPlugin = class extends Plugin {
     );
   };
 };
+var DEFAULT_FAVICON = /* @__PURE__ */ jsxRuntime.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.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.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__ */ jsxRuntime.jsxs("div", { className: `${bgColor} p-4 rounded-lg`, children: [
+  /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center mb-2", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "svg",
+      {
+        className: `w-5 h-5 ${iconColor} mr-2`,
+        fill: "none",
+        stroke: "currentColor",
+        viewBox: "0 0 24 24",
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          "path",
+          {
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            strokeWidth: 2,
+            d: icon
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm font-medium text-gray-600", children: label })
+  ] }),
+  /* @__PURE__ */ jsxRuntime.jsx("p", { className: `text-xl font-semibold text-gray-900`, children: value })
+] });
+var getEnvironmentBadgeClass = (env) => {
+  switch (env) {
+    case "prod":
+      return "bg-red-100 text-red-800";
+    case "stg":
+      return "bg-yellow-100 text-yellow-800";
+    case "dev":
+    default:
+      return "bg-blue-100 text-blue-800";
+  }
+};
+var ServiceInfoCards = ({
+  serviceInfo
+}) => {
+  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 || "/",
+      isMonospace: true
+    },
+    {
+      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__ */ jsxRuntime.jsx(
+        "span",
+        {
+          className: `px-2 py-1 rounded-full text-sm ${getEnvironmentBadgeClass(serviceInfo.env ?? "dev")}`,
+          children: serviceInfo.env ?? "dev"
+        }
+      )
+    },
+    {
+      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"
+    }
+  ];
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "bg-white rounded-lg shadow-md p-6 mb-8", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("h2", { className: "text-2xl font-semibold text-gray-800 mb-6 flex items-center", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "svg",
+        {
+          className: "w-6 h-6 mr-2 text-blue-600",
+          fill: "none",
+          stroke: "currentColor",
+          viewBox: "0 0 24 24",
+          children: /* @__PURE__ */ jsxRuntime.jsx(
+            "path",
+            {
+              strokeLinecap: "round",
+              strokeLinejoin: "round",
+              strokeWidth: 2,
+              d: "M13 10V3L4 14h7v7l9-11h-7z"
+            }
+          )
+        }
+      ),
+      "\u670D\u52A1\u57FA\u672C\u4FE1\u606F"
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-2 gap-6", children: infoCards.map((card, index) => /* @__PURE__ */ jsxRuntime.jsx(InfoCard, { ...card }, index)) })
+  ] });
+};
+var ServiceStatusPage = ({
+  serviceInfo
+}) => {
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "min-h-screen bg-gray-50 py-8", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "max-w-6xl mx-auto px-4", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-8", children: /* @__PURE__ */ jsxRuntime.jsx("h1", { className: "text-4xl font-bold text-gray-900 mb-2", children: "Service Status" }) }),
+    /* @__PURE__ */ jsxRuntime.jsx(ServiceInfoCards, { serviceInfo })
+  ] }) });
+};
+var ServiceStatusPage_default = ServiceStatusPage;
+
+// core/plugins/page/mod.ts
+var PageRenderPlugin = class extends Plugin {
+  constructor(options = {}) {
+    super();
+    this.options = options;
+  }
+  initialize = async (engine) => {
+    const app = engine.getApp();
+    if (this.options.useDefaultStatusPage) {
+      app.get(`${engine.options.prefix}`, async (ctx) => {
+        return ctx.html(HtmxLayout({
+          title: engine.options.name,
+          children: ServiceStatusPage_default({
+            serviceInfo: {
+              name: engine.options.name,
+              prefix: engine.options.prefix,
+              version: engine.options.version,
+              env: engine.options.env,
+              id: engine.serviceId,
+              modules: engine.getModules(false)
+            }
+          })
+        }));
+      });
+    }
+    logger_default.info(`PageRenderPlugin enabled`);
+  };
+};
+
+// utils/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();
+}
 
 Object.defineProperty(exports, "dayjs", {
   enumerable: true,
   get: function () { return dayjs__default.default; }
 });
 exports.Action = Action;
+exports.BaseLayout = BaseLayout;
 exports.CacheAdapter = CacheAdapter;
+exports.HtmxLayout = HtmxLayout;
 exports.MemoryCacheAdapter = MemoryCacheAdapter;
 exports.Microservice = Microservice;
 exports.ModelContextProtocolPlugin = ModelContextProtocolPlugin;
 exports.Module = Module;
+exports.Page = Page;
+exports.PageRenderPlugin = PageRenderPlugin;
 exports.Plugin = Plugin;
 exports.RedisCacheAdapter = RedisCacheAdapter;
 exports.Schedule = Schedule;
 exports.ScheduleMode = ScheduleMode;
 exports.ServiceContext = ServiceContext;
+exports.ServiceInfoCards = ServiceInfoCards;
+exports.ServiceStatusPage = ServiceStatusPage;
 exports.logger = logger_default;
 exports.startCheck = startCheck;
 Object.keys(zod).forEach(function (k) {

package/dist/mod.d.cts

@@ -6,6 +6,8 @@ import { Lease, Etcd3 } from 'etcd3';
 import { Hono } from 'hono';
 export { default as dayjs } from 'dayjs';
 import winston from 'winston';
+import * as hono_utils_html from 'hono/utils/html';
+import * as hono_jsx_jsx_dev_runtime from 'hono/jsx/jsx-dev-runtime';
 
 declare abstract class CacheAdapter {
     abstract get(key: string): Promise<any>;
@@ -39,6 +41,14 @@ interface ActionOptions {
     stream?: boolean;
     mcp?: McpOptions;
 }
+interface PageOptions {
+    method: "get" | "post" | "put" | "delete" | "patch" | "options";
+    path: string;
+    description?: string;
+}
+interface PageMetadata extends PageOptions {
+    name: string;
+}
 interface ActionMetadata extends ActionOptions {
     name: string;
     idempotence: boolean;
@@ -226,6 +236,7 @@ declare class Microservice {
     private statisticsTimer?;
     private wsHandler?;
     private actionHandlers;
+    private pageHandlers;
     private activeRequests;
     private status;
     modules: Map<string, ModuleInfo>;
@@ -304,13 +315,6 @@ declare class Microservice {
     init(): Promise<void>;
 }
 
-interface PreStartChecker {
-    name: string;
-    check: () => Promise<void> | void;
-    skip?: boolean;
-}
-declare function startCheck(checkers: PreStartChecker[], pass?: () => void | Promise<void>): Promise<void>;
-
 declare class ModelContextProtocolPlugin extends Plugin {
     private mcpServer;
     private transports;
@@ -318,6 +322,40 @@ declare class ModelContextProtocolPlugin extends Plugin {
     initialize: (engine: Microservice) => Promise<void>;
 }
 
+declare const BaseLayout: (props?: {
+    children?: any;
+    title?: string;
+    heads?: any;
+}) => hono_utils_html.HtmlEscapedString | Promise<hono_utils_html.HtmlEscapedString>;
+declare const HtmxLayout: (props?: {
+    children?: any;
+    title: string;
+    favicon?: any;
+}) => hono_utils_html.HtmlEscapedString | Promise<hono_utils_html.HtmlEscapedString>;
+
+declare const ServiceInfoCards: ({ serviceInfo, }: {
+    serviceInfo: ServiceInfo;
+}) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare const ServiceStatusPage: ({ serviceInfo, }: {
+    serviceInfo: ServiceInfo;
+}) => hono_jsx_jsx_dev_runtime.JSX.Element;
+
+interface PageRenderPluginOptions {
+    useDefaultStatusPage?: boolean;
+}
+declare class PageRenderPlugin extends Plugin {
+    private readonly options;
+    constructor(options?: PageRenderPluginOptions);
+    initialize: (engine: Microservice) => Promise<void>;
+}
+
+interface PreStartChecker {
+    name: string;
+    check: () => Promise<void> | void;
+    skip?: boolean;
+}
+declare function startCheck(checkers: PreStartChecker[], pass?: () => void | Promise<void>): Promise<void>;
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -330,6 +368,11 @@ declare function Action(options: ActionOptions): Function;
  */
 declare function Module(name: string, options?: ModuleOptions): Function;
 
+/**
+ * 用于给微服务模块方法添加的页面注解
+ */
+declare function Page(options: PageOptions): Function;
+
 /**
  * 用于给微服务模块方法添加的调度注解
  */
@@ -337,4 +380,4 @@ declare function Schedule(options: ScheduleOptions): Function;
 
 declare const logger: winston.Logger;
 
-export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type CleanupHook, type EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, type RequestInfo, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };
+export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, BaseLayout, CacheAdapter, type CacheFn, type CleanupHook, type EtcdConfig, type EventServiceInfo, HtmxLayout, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Page, type PageMetadata, type PageOptions, PageRenderPlugin, type PageRenderPluginOptions, Plugin, type PreStartChecker, RedisCacheAdapter, type RequestInfo, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, ServiceInfoCards, type ServiceStats, ServiceStatusPage, type StatisticsEvent, type StreamResponse, logger, startCheck };

package/dist/mod.d.ts

@@ -6,6 +6,8 @@ import { Lease, Etcd3 } from 'etcd3';
 import { Hono } from 'hono';
 export { default as dayjs } from 'dayjs';
 import winston from 'winston';
+import * as hono_utils_html from 'hono/utils/html';
+import * as hono_jsx_jsx_dev_runtime from 'hono/jsx/jsx-dev-runtime';
 
 declare abstract class CacheAdapter {
     abstract get(key: string): Promise<any>;
@@ -39,6 +41,14 @@ interface ActionOptions {
     stream?: boolean;
     mcp?: McpOptions;
 }
+interface PageOptions {
+    method: "get" | "post" | "put" | "delete" | "patch" | "options";
+    path: string;
+    description?: string;
+}
+interface PageMetadata extends PageOptions {
+    name: string;
+}
 interface ActionMetadata extends ActionOptions {
     name: string;
     idempotence: boolean;
@@ -226,6 +236,7 @@ declare class Microservice {
     private statisticsTimer?;
     private wsHandler?;
     private actionHandlers;
+    private pageHandlers;
     private activeRequests;
     private status;
     modules: Map<string, ModuleInfo>;
@@ -304,13 +315,6 @@ declare class Microservice {
     init(): Promise<void>;
 }
 
-interface PreStartChecker {
-    name: string;
-    check: () => Promise<void> | void;
-    skip?: boolean;
-}
-declare function startCheck(checkers: PreStartChecker[], pass?: () => void | Promise<void>): Promise<void>;
-
 declare class ModelContextProtocolPlugin extends Plugin {
     private mcpServer;
     private transports;
@@ -318,6 +322,40 @@ declare class ModelContextProtocolPlugin extends Plugin {
     initialize: (engine: Microservice) => Promise<void>;
 }
 
+declare const BaseLayout: (props?: {
+    children?: any;
+    title?: string;
+    heads?: any;
+}) => hono_utils_html.HtmlEscapedString | Promise<hono_utils_html.HtmlEscapedString>;
+declare const HtmxLayout: (props?: {
+    children?: any;
+    title: string;
+    favicon?: any;
+}) => hono_utils_html.HtmlEscapedString | Promise<hono_utils_html.HtmlEscapedString>;
+
+declare const ServiceInfoCards: ({ serviceInfo, }: {
+    serviceInfo: ServiceInfo;
+}) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare const ServiceStatusPage: ({ serviceInfo, }: {
+    serviceInfo: ServiceInfo;
+}) => hono_jsx_jsx_dev_runtime.JSX.Element;
+
+interface PageRenderPluginOptions {
+    useDefaultStatusPage?: boolean;
+}
+declare class PageRenderPlugin extends Plugin {
+    private readonly options;
+    constructor(options?: PageRenderPluginOptions);
+    initialize: (engine: Microservice) => Promise<void>;
+}
+
+interface PreStartChecker {
+    name: string;
+    check: () => Promise<void> | void;
+    skip?: boolean;
+}
+declare function startCheck(checkers: PreStartChecker[], pass?: () => void | Promise<void>): Promise<void>;
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -330,6 +368,11 @@ declare function Action(options: ActionOptions): Function;
  */
 declare function Module(name: string, options?: ModuleOptions): Function;
 
+/**
+ * 用于给微服务模块方法添加的页面注解
+ */
+declare function Page(options: PageOptions): Function;
+
 /**
  * 用于给微服务模块方法添加的调度注解
  */
@@ -337,4 +380,4 @@ declare function Schedule(options: ScheduleOptions): Function;
 
 declare const logger: winston.Logger;
 
-export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type CleanupHook, type EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, type RequestInfo, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };
+export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, BaseLayout, CacheAdapter, type CacheFn, type CleanupHook, type EtcdConfig, type EventServiceInfo, HtmxLayout, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Page, type PageMetadata, type PageOptions, PageRenderPlugin, type PageRenderPluginOptions, Plugin, type PreStartChecker, RedisCacheAdapter, type RequestInfo, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, ServiceInfoCards, type ServiceStats, ServiceStatusPage, type StatisticsEvent, type StreamResponse, logger, startCheck };