imean-service-engine 2.0.1 → 2.0.3

package/dist/index.d.mts

@@ -393,6 +393,12 @@ interface RouteModuleOptions {
  * RoutePlugin 配置选项
  */
 interface RoutePluginOptions {
+    /**
+     * 全局路径前缀（应用于所有路由）
+     * 路径拼接顺序：全局前缀 + 模块前缀 + 路由路径
+     * 例如：prefix="/api", routePrefix="/v1", path="/users" => "/api/v1/users"
+     */
+    prefix?: string;
     /**
      * 全局中间件（应用于所有路由）
      * 执行顺序：全局中间件 -> 模块级中间件 -> 路由级中间件
@@ -441,13 +447,14 @@ declare function Page(options: RouteOptions): (target: Function, context: ClassM
  *
  * @example
  * ```typescript
- * // 使用全局中间件（如鉴权）
+ * // 使用全局前缀和中间件
  * const authMiddleware = async (ctx, next) => {
  *   // 验证 token
  *   await next();
  * };
  *
  * const routePlugin = new RoutePlugin({
+ *   prefix: "/api", // 全局路径前缀，所有路由都会加上这个前缀
  *   globalMiddlewares: [authMiddleware],
  * });
  * ```
@@ -456,6 +463,7 @@ declare class RoutePlugin implements Plugin<RouteModuleOptions> {
     readonly name = "route-plugin";
     readonly priority = PluginPriority.ROUTE;
     private engine;
+    private globalPrefix;
     private globalMiddlewares;
     /**
      * 构造函数

package/dist/index.d.ts

@@ -393,6 +393,12 @@ interface RouteModuleOptions {
  * RoutePlugin 配置选项
  */
 interface RoutePluginOptions {
+    /**
+     * 全局路径前缀（应用于所有路由）
+     * 路径拼接顺序：全局前缀 + 模块前缀 + 路由路径
+     * 例如：prefix="/api", routePrefix="/v1", path="/users" => "/api/v1/users"
+     */
+    prefix?: string;
     /**
      * 全局中间件（应用于所有路由）
      * 执行顺序：全局中间件 -> 模块级中间件 -> 路由级中间件
@@ -441,13 +447,14 @@ declare function Page(options: RouteOptions): (target: Function, context: ClassM
  *
  * @example
  * ```typescript
- * // 使用全局中间件（如鉴权）
+ * // 使用全局前缀和中间件
  * const authMiddleware = async (ctx, next) => {
  *   // 验证 token
  *   await next();
  * };
  *
  * const routePlugin = new RoutePlugin({
+ *   prefix: "/api", // 全局路径前缀，所有路由都会加上这个前缀
  *   globalMiddlewares: [authMiddleware],
  * });
  * ```
@@ -456,6 +463,7 @@ declare class RoutePlugin implements Plugin<RouteModuleOptions> {
     readonly name = "route-plugin";
     readonly priority = PluginPriority.ROUTE;
     private engine;
+    private globalPrefix;
     private globalMiddlewares;
     /**
      * 构造函数

package/dist/index.js

@@ -2124,12 +2124,14 @@ var RoutePlugin = class {
   name = "route-plugin";
   priority = 1e3 /* ROUTE */;
   engine;
+  globalPrefix;
   globalMiddlewares;
   /**
    * 构造函数
    * @param options 插件配置选项
    */
   constructor(options) {
+    this.globalPrefix = options?.prefix || "";
     this.globalMiddlewares = options?.globalMiddlewares || [];
   }
   /**
@@ -2182,7 +2184,7 @@ var RoutePlugin = class {
       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 fullPaths = paths.map((p) => this.globalPrefix + routePrefix + p);
       const routeHandler = async (ctx) => {
         const method = moduleInstance[methodName];
         if (typeof method !== "function") {
@@ -2190,10 +2192,19 @@ var RoutePlugin = class {
         }
         try {
           const result = await method.call(moduleInstance, ctx);
+          if (result === void 0) {
+            return new Response(null, { status: 204 });
+          }
           if (result instanceof Response) {
             return result;
           }
-          if (typeof result === "string" || typeof result === "object" && result !== null && "type" in result) {
+          if (typeof result === "string") {
+            return result;
+          }
+          if (result === null) {
+            return result;
+          }
+          if (typeof result === "object" && result !== null && "type" in result && (typeof result.type === "function" || typeof result.type === "string")) {
             return result;
           }
           return ctx.json(result);

package/dist/index.mjs

@@ -2099,12 +2099,14 @@ var RoutePlugin = class {
   name = "route-plugin";
   priority = 1e3 /* ROUTE */;
   engine;
+  globalPrefix;
   globalMiddlewares;
   /**
    * 构造函数
    * @param options 插件配置选项
    */
   constructor(options) {
+    this.globalPrefix = options?.prefix || "";
     this.globalMiddlewares = options?.globalMiddlewares || [];
   }
   /**
@@ -2157,7 +2159,7 @@ var RoutePlugin = class {
       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 fullPaths = paths.map((p) => this.globalPrefix + routePrefix + p);
       const routeHandler = async (ctx) => {
         const method = moduleInstance[methodName];
         if (typeof method !== "function") {
@@ -2165,10 +2167,19 @@ var RoutePlugin = class {
         }
         try {
           const result = await method.call(moduleInstance, ctx);
+          if (result === void 0) {
+            return new Response(null, { status: 204 });
+          }
           if (result instanceof Response) {
             return result;
           }
-          if (typeof result === "string" || typeof result === "object" && result !== null && "type" in result) {
+          if (typeof result === "string") {
+            return result;
+          }
+          if (result === null) {
+            return result;
+          }
+          if (typeof result === "object" && result !== null && "type" in result && (typeof result.type === "function" || typeof result.type === "string")) {
             return result;
           }
           return ctx.json(result);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imean-service-engine",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "基于Hono的轻量级微服务引擎框架",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",