imean-service-engine 1.5.0 → 1.7.0

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;
@@ -155,6 +165,32 @@ interface MicroserviceOptions {
     };
     cacheAdapter?: CacheAdapter;
     plugins?: Plugin[];
+    gracefulShutdown?: {
+        /** 优雅停机超时时间（毫秒），默认 30 秒 */
+        timeout?: number;
+        /** 清理hook列表 */
+        cleanupHooks?: CleanupHook[];
+    };
+}
+interface CleanupHook {
+    /** hook名称 */
+    name: string;
+    /** 清理函数 */
+    cleanup: () => Promise<void> | void;
+    /** 超时时间（毫秒），默认 5 秒 */
+    timeout?: number;
+}
+interface RequestInfo {
+    /** 请求ID */
+    id: string;
+    /** 模块名称 */
+    moduleName: string;
+    /** 动作名称 */
+    actionName: string;
+    /** 开始时间 */
+    startTime: number;
+    /** 请求参数 */
+    params?: any;
 }
 interface ModuleInfo extends ModuleOptions {
     actions: Record<string, ActionMetadata>;
@@ -197,10 +233,12 @@ declare class Microservice {
     private lease?;
     private scheduler?;
     private abortController?;
-    private isShuttingDown;
     private statisticsTimer?;
     private wsHandler?;
     private actionHandlers;
+    private pageHandlers;
+    private activeRequests;
+    private status;
     modules: Map<string, ModuleInfo>;
     readonly fetch: typeof fetch;
     options: Required<MicroserviceOptions>;
@@ -236,7 +274,7 @@ declare class Microservice {
     /**
      * 停止服务
      */
-    stop(): Promise<void>;
+    private stop;
     /**
      * 初始化停机处理
      */
@@ -244,22 +282,39 @@ declare class Microservice {
     /**
      * 优雅停机
      */
-    private gracefulShutdown;
+    shutdown(): Promise<void>;
+    /**
+     * 等待所有活跃请求完成
+     */
+    private waitForActiveRequests;
+    /**
+     * 执行清理hook
+     */
+    private executeCleanupHooks;
     private initStatsEventManager;
     private updateStats;
     getActionHandler(moduleName: string, actionName: string): ActionHandler;
+    /**
+     * 添加活跃请求跟踪
+     */
+    private addActiveRequest;
+    /**
+     * 移除活跃请求跟踪
+     */
+    private removeActiveRequest;
+    /**
+     * 获取当前活跃请求数量
+     */
+    getActiveRequestCount(): number;
+    /**
+     * 获取当前活跃请求信息
+     */
+    getActiveRequests(): RequestInfo[];
     private handleRequest;
     private initPlugins;
     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;
@@ -267,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>;
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -279,6 +363,11 @@ declare function Action(options: ActionOptions): Function;
  */
 declare function Module(name: string, options?: ModuleOptions): Function;
 
+/**
+ * 用于给微服务模块方法添加的页面注解
+ */
+declare function Page(options: PageOptions): Function;
+
 /**
  * 用于给微服务模块方法添加的调度注解
  */
@@ -286,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 EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, 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

@@ -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;
@@ -155,6 +165,32 @@ interface MicroserviceOptions {
     };
     cacheAdapter?: CacheAdapter;
     plugins?: Plugin[];
+    gracefulShutdown?: {
+        /** 优雅停机超时时间（毫秒），默认 30 秒 */
+        timeout?: number;
+        /** 清理hook列表 */
+        cleanupHooks?: CleanupHook[];
+    };
+}
+interface CleanupHook {
+    /** hook名称 */
+    name: string;
+    /** 清理函数 */
+    cleanup: () => Promise<void> | void;
+    /** 超时时间（毫秒），默认 5 秒 */
+    timeout?: number;
+}
+interface RequestInfo {
+    /** 请求ID */
+    id: string;
+    /** 模块名称 */
+    moduleName: string;
+    /** 动作名称 */
+    actionName: string;
+    /** 开始时间 */
+    startTime: number;
+    /** 请求参数 */
+    params?: any;
 }
 interface ModuleInfo extends ModuleOptions {
     actions: Record<string, ActionMetadata>;
@@ -197,10 +233,12 @@ declare class Microservice {
     private lease?;
     private scheduler?;
     private abortController?;
-    private isShuttingDown;
     private statisticsTimer?;
     private wsHandler?;
     private actionHandlers;
+    private pageHandlers;
+    private activeRequests;
+    private status;
     modules: Map<string, ModuleInfo>;
     readonly fetch: typeof fetch;
     options: Required<MicroserviceOptions>;
@@ -236,7 +274,7 @@ declare class Microservice {
     /**
      * 停止服务
      */
-    stop(): Promise<void>;
+    private stop;
     /**
      * 初始化停机处理
      */
@@ -244,22 +282,39 @@ declare class Microservice {
     /**
      * 优雅停机
      */
-    private gracefulShutdown;
+    shutdown(): Promise<void>;
+    /**
+     * 等待所有活跃请求完成
+     */
+    private waitForActiveRequests;
+    /**
+     * 执行清理hook
+     */
+    private executeCleanupHooks;
     private initStatsEventManager;
     private updateStats;
     getActionHandler(moduleName: string, actionName: string): ActionHandler;
+    /**
+     * 添加活跃请求跟踪
+     */
+    private addActiveRequest;
+    /**
+     * 移除活跃请求跟踪
+     */
+    private removeActiveRequest;
+    /**
+     * 获取当前活跃请求数量
+     */
+    getActiveRequestCount(): number;
+    /**
+     * 获取当前活跃请求信息
+     */
+    getActiveRequests(): RequestInfo[];
     private handleRequest;
     private initPlugins;
     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;
@@ -267,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>;
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -279,6 +363,11 @@ declare function Action(options: ActionOptions): Function;
  */
 declare function Module(name: string, options?: ModuleOptions): Function;
 
+/**
+ * 用于给微服务模块方法添加的页面注解
+ */
+declare function Page(options: PageOptions): Function;
+
 /**
  * 用于给微服务模块方法添加的调度注解
  */
@@ -286,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 EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, 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 };