npm - imean-service-engine - Versions diffs - 1.6.0 → 1.7.0 - Mend

imean-service-engine 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md CHANGED Viewed

@@ -18,6 +18,7 @@
   - 支持双向通信
   - 使用 Brotli 压缩，减少数据传输量
   - 自动重连和心跳检测
+- 🌐 内置 PageRenderPlugin 支持服务端渲染页面，集成 HTMX 和 Hyperscript
 ## TODOs
@@ -135,6 +136,273 @@ const found = await client.users.getUser(user.id);
 ## 高级特性
+### PageRenderPlugin - 服务端渲染页面
+PageRenderPlugin 为微服务框架提供了服务端渲染页面的能力，集成了 HTMX 和 Hyperscript，让你可以轻松构建现代化的 Web 应用。
+#### 启用 PageRenderPlugin
+```typescript
+import { Microservice, PageRenderPlugin } from "imean-service-engine";
+const service = new Microservice({
+  modules: [UserService],
+  plugins: [new PageRenderPlugin()],
+});
+```
+#### 使用 @Page 装饰器
+使用 `@Page` 装饰器可以将模块方法暴露为 Web 页面：
+```typescript
+import { Page, HtmxLayout } from "imean-service-engine";
+@Module("web")
+class WebService {
+  @Page({
+    path: "/greeting",
+    method: "get",
+    description: "问候页面",
+  })
+  greetingPage(ctx: Context) {
+    return (
+      <HtmxLayout title="问候页面">
+        <div class="min-h-screen bg-gradient-to-br from-blue-50 to-indigo-100 p-8">
+          <div class="max-w-4xl mx-auto">
+            <h1 class="text-4xl font-bold text-center text-gray-800 mb-8">
+              HTMX 交互示例
+            </h1>
+            <div class="bg-white rounded-lg shadow-lg p-6">
+              <h2 class="text-2xl font-semibold mb-4 text-gray-700">问候语</h2>
+              <div id="greeting" class="text-xl p-4 bg-blue-50 rounded-lg">
+                欢迎使用微服务框架！
+              </div>
+              <button
+                class="mt-4 px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600"
+                hx-post="/api/greeting"
+                hx-target="#greeting"
+                hx-swap="innerHTML"
+              >
+                更新问候语
+              </button>
+            </div>
+          </div>
+        </div>
+      </HtmxLayout>
+    );
+  }
+  @Page({
+    path: "/greeting",
+    method: "post",
+    description: "更新问候语",
+  })
+  updateGreeting(ctx: Context) {
+    return "你好，世界！当前时间：" + new Date().toLocaleString();
+  }
+}
+```
+#### JSX 配置
+要使用 JSX 语法，需要在 `tsconfig.json` 中配置：
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "hono/jsx"
+  }
+}
+```
+#### HtmxLayout 组件
+`HtmxLayout` 提供了预配置的页面布局，包含：
+- HTMX 库（最新版本）
+- Hyperscript 库（最新版本）
+- Tailwind CSS（CDN 版本）
+- 响应式设计支持
+- 默认图标
+```typescript
+import { HtmxLayout } from "imean-service-engine";
+// 基本用法
+const page = (
+  <HtmxLayout title="我的页面">
+    <div>页面内容</div>
+  </HtmxLayout>
+);
+// 自定义图标
+const pageWithCustomIcon = (
+  <HtmxLayout title="我的页面" favicon={<link rel="icon" href="/custom-icon.ico" />}>
+    <div>页面内容</div>
+  </HtmxLayout>
+);
+```
+#### BaseLayout 组件
+如果你不想使用 HTMX 和 Hyperscript，而是想使用其他前端框架（如 React、Vue 等），可以使用 `BaseLayout` 组件：
+```typescript
+import { BaseLayout } from "imean-service-engine";
+// 使用 BaseLayout 自定义页面
+const customPage = (
+  <BaseLayout title="自定义页面">
+    <div>页面内容</div>
+  </BaseLayout>
+);
+// 自定义头部内容
+const pageWithCustomHead = (
+  <BaseLayout
+    title="自定义页面"
+    heads={
+      <>
+        <link rel="stylesheet" href="/custom.css" />
+        <script src="https://unpkg.com/react@18/umd/react.development.js"></script>
+        <script src="https://unpkg.com/react-dom@18/umd/react-dom.development.js"></script>
+      </>
+    }
+  >
+    <div id="root">React 应用将在这里渲染</div>
+  </BaseLayout>
+);
+```
+`BaseLayout` 提供：
+- 基本的 HTML 结构
+- 可自定义的 `<head>` 内容
+- 可自定义的页面标题
+- 可自定义的图标
+#### HTMX 交互示例
+结合 HTMX 可以实现丰富的交互效果：
+```typescript
+@Page({
+  path: "/users",
+  method: "get",
+  description: "用户列表页面",
+})
+usersPage(ctx: Context) {
+  return (
+    <HtmxLayout title="用户管理">
+      <div class="container mx-auto p-8">
+        <h1 class="text-3xl font-bold mb-6">用户管理</h1>
+        {/* 用户列表 */}
+        <div
+          id="user-list"
+          hx-get="/api/users/list"
+          hx-trigger="load"
+        >
+          加载中...
+        </div>
+        {/* 添加用户表单 */}
+        <div class="mt-8 bg-white rounded-lg shadow p-6">
+          <h2 class="text-xl font-semibold mb-4">添加新用户</h2>
+          <form
+            hx-post="/api/users/add"
+            hx-target="#user-list"
+            hx-swap="outerHTML"
+          >
+            <div class="grid grid-cols-2 gap-4">
+              <input
+                type="text"
+                name="name"
+                placeholder="姓名"
+                class="px-3 py-2 border rounded-md"
+                required
+              />
+              <input
+                type="number"
+                name="age"
+                placeholder="年龄"
+                class="px-3 py-2 border rounded-md"
+                required
+              />
+            </div>
+            <button
+              type="submit"
+              class="mt-4 px-4 py-2 bg-green-500 text-white rounded hover:bg-green-600"
+            >
+              添加用户
+            </button>
+          </form>
+        </div>
+      </div>
+    </HtmxLayout>
+  );
+}
+```
+#### Hyperscript 增强交互
+使用 Hyperscript 可以实现更复杂的客户端逻辑：
+```typescript
+// 带加载状态的按钮
+<button
+  hx-post="/api/users/refresh"
+  hx-target="#user-list"
+  hx-swap="innerHTML"
+  _="on htmx:beforeRequest hide #button-text then show #loading-spinner end
+     on htmx:afterRequest hide #loading-spinner then show #button-text end"
+>
+  <span id="loading-spinner" class="htmx-indicator">
+    <svg class="animate-spin h-4 w-4" viewBox="0 0 24 24">
+      <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+      <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+    </svg>
+    加载中...
+  </span>
+  <span id="button-text">刷新用户列表</span>
+</button>
+```
+#### 服务状态页面
+PageRenderPlugin 自动在服务根路径（`/api`）提供服务的状态页面，显示：
+- 服务基本信息（名称、版本、环境）
+- 模块列表和 API 端点
+- 服务健康状态
+访问 `http://localhost:3000/api` 即可查看服务状态页面。
+#### 最佳实践
+1. **页面组织**：将页面逻辑与 API 逻辑分离
+2. **组件复用**：使用 HtmxLayout 确保一致的页面结构
+3. **渐进增强**：优先使用 HTMX 实现交互，必要时使用 Hyperscript
+4. **响应式设计**：利用 Tailwind CSS 构建响应式界面
+5. **布局选择**：
+   - 使用 `HtmxLayout` 进行快速原型开发和简单交互
+   - 使用 `BaseLayout` 集成复杂的前端框架（React、Vue 等）
+   - 根据项目需求选择合适的布局组件
+```typescript
+// 推荐的目录结构
+src/
+├── pages/           # 页面组件
+│   ├── users.tsx
+│   └── dashboard.tsx
+├── services/        # 服务模块
+│   ├── user.ts
+│   └── web.ts
+└── layouts/         # 自定义布局
+    └── admin.tsx
+```
 ### 幂等性和重试机制
 框架提供了智能的重试机制，但仅对标记为幂等的操作生效：
@@ -180,6 +448,35 @@ interface ActionOptions {
 }
 ```
+#### @Page(options: PageOptions)
+定义一个页面路由（需要启用 PageRenderPlugin）。
+```typescript
+interface PageOptions {
+  method: "get" | "post" | "put" | "delete" | "patch" | "options";
+  path: string;
+  description?: string;
+}
+```
+示例：
+```typescript
+@Page({
+  path: "/dashboard",
+  method: "get",
+  description: "仪表板页面",
+})
+dashboardPage(ctx: Context) {
+  return (
+    <HtmxLayout title="仪表板">
+      <div>仪表板内容</div>
+    </HtmxLayout>
+  );
+}
+```
 ### Microservice
 #### constructor(options: MicroserviceOptions)
@@ -190,6 +487,7 @@ interface ActionOptions {
 interface MicroserviceOptions {
   modules: (new () => any)[]; // 模块类数组
   prefix?: string; // API 前缀，默认为 "/api"
+  plugins?: Plugin[]; // 插件数组，如 PageRenderPlugin
 }
 ```

package/dist/mod.cjs CHANGED Viewed

@@ -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,221 @@ 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 {
+  initialize = async (engine) => {
+    const app = engine.getApp();
+    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 CHANGED Viewed

@@ -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,35 @@ 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;
+declare class PageRenderPlugin extends Plugin {
+    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 +363,11 @@ declare function Action(options: ActionOptions): Function;
  */
 declare function Module(name: string, options?: ModuleOptions): Function;
+/**
+ * 用于给微服务模块方法添加的页面注解
+ */
+declare function Page(options: PageOptions): Function;
 /**
  * 用于给微服务模块方法添加的调度注解
  */
@@ -337,4 +375,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, 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 CHANGED Viewed

@@ -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,35 @@ 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;
+declare class PageRenderPlugin extends Plugin {
+    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 +363,11 @@ declare function Action(options: ActionOptions): Function;
  */
 declare function Module(name: string, options?: ModuleOptions): Function;
+/**
+ * 用于给微服务模块方法添加的页面注解
+ */
+declare function Page(options: PageOptions): Function;
 /**
  * 用于给微服务模块方法添加的调度注解
  */
@@ -337,4 +375,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, 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.js CHANGED Viewed

@@ -6,6 +6,7 @@ import { serve } from '@hono/node-server';
 import { Etcd3 } from 'etcd3';
 import fs from 'fs-extra';
 import { Hono } from 'hono';
+import { timing } from 'hono/timing';
 import { trace, SpanStatusCode } from '@opentelemetry/api';
 import winston, { format } from 'winston';
 import prettier from 'prettier';
@@ -17,6 +18,8 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { JSONRPCMessageSchema } from '@modelcontextprotocol/sdk/types.js';
 import { streamSSE } from 'hono/streaming';
 import { ulid } from 'ulid';
+import { html } from 'hono/html';
+import { jsx, jsxs } from 'hono/jsx/jsx-runtime';
 export { default as dayjs } from 'dayjs';
 // mod.ts
@@ -586,6 +589,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 = 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: SpanStatusCode.ERROR,
+            message: error.message
+          });
+          throw error;
+        } finally {
+          span.end();
+        }
+      }
+    );
+  }
+};
 var WebSocketHandler = class {
   constructor(microservice, options) {
     this.microservice = microservice;
@@ -773,6 +832,7 @@ var Microservice = class {
   statisticsTimer;
   wsHandler;
   actionHandlers = /* @__PURE__ */ new Map();
+  pageHandlers = /* @__PURE__ */ new Map();
   activeRequests = /* @__PURE__ */ new Map();
   status = "running";
   modules = /* @__PURE__ */ new Map();
@@ -782,6 +842,7 @@ var Microservice = class {
   serviceId;
   constructor(options) {
     this.app = new Hono();
+    this.app.use(timing());
     this.nodeWebSocket = createNodeWebSocket({ app: this.app });
     this.serviceId = crypto.randomUUID();
     this.options = {
@@ -820,6 +881,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) {
@@ -834,6 +900,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,
@@ -847,6 +914,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) {
@@ -876,11 +955,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",
@@ -1323,28 +1397,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;
@@ -1460,5 +1512,198 @@ var ModelContextProtocolPlugin = class extends Plugin {
     );
   };
 };
+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) => {
+  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__ */ 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__ */ 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-2 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__ */ jsx("div", { className: "mb-8", children: /* @__PURE__ */ jsx("h1", { className: "text-4xl font-bold text-gray-900 mb-2", children: "Service Status" }) }),
+    /* @__PURE__ */ jsx(ServiceInfoCards, { serviceInfo })
+  ] }) });
+};
+var ServiceStatusPage_default = ServiceStatusPage;
+// core/plugins/page/mod.ts
+var PageRenderPlugin = class extends Plugin {
+  initialize = async (engine) => {
+    const app = engine.getApp();
+    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();
+}
-export { Action, CacheAdapter, MemoryCacheAdapter, Microservice, ModelContextProtocolPlugin, Module, Plugin, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };
+export { Action, BaseLayout, CacheAdapter, HtmxLayout, MemoryCacheAdapter, Microservice, ModelContextProtocolPlugin, Module, Page, PageRenderPlugin, Plugin, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, ServiceInfoCards, ServiceStatusPage, logger_default as logger, startCheck };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "imean-service-engine",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "microservice engine",
   "keywords": [
     "microservice",