vafast 0.4.6 → 0.4.8

package/README.md

@@ -115,7 +115,7 @@ export default app;
 
 **Vafast 完整示例：**
 ```typescript
-import { Server, VafastError, createHandler } from 'vafast';
+import { Server, createHandler, err } from 'vafast';
 import type { Route } from 'vafast';
 
 const routes: Route[] = [
@@ -125,11 +125,7 @@ const routes: Route[] = [
     handler: createHandler((ctx) => {
       const name = ctx.query.name;
       if (!name) {
-        throw new VafastError('Missing name', {
-          status: 400,
-          type: 'bad_request',
-          expose: true,  // 控制是否暴露给客户端
-        });
+        throw err.badRequest('Missing name');  // ✨ 简洁！
       }
       return `Hello, ${name}`;
     }),
@@ -138,10 +134,10 @@ const routes: Route[] = [
 
 const server = new Server(routes);
 export default { fetch: server.fetch };
-// 错误响应: { type: 'bad_request', message: 'Missing name' }
+// 错误响应: { error: 'BAD_REQUEST', message: 'Missing name' }
 ```
 
-**对比：VafastError 有统一的 `type` + `status` + `expose` 契约。**
+**对比：Vafast 的 `err()` 函数提供语义化的错误 API，统一的响应格式。**
 
 ### 组合优于约定 — 显式优于隐式
 
@@ -339,6 +335,45 @@ export default { fetch: server.fetch };" > index.ts && bun index.ts
 - 🧩 **灵活中间件系统** - 可组合的中间件架构
 - 📦 **零配置** - 开箱即用，无需复杂配置
 
+### 返回值与错误处理
+
+Vafast 提供简洁、对称的响应 API：
+
+```typescript
+import { createHandler, json, err } from 'vafast';
+
+// ==================== 成功响应 ====================
+return user                    // 200 + JSON（自动转换）
+return json(user, 201)         // 201 Created
+return json(user, 200, {       // 自定义头部
+  'X-Request-Id': 'abc123'
+})
+return 'Hello'                 // 200 + text/plain
+return new Response(...)       // 完全控制
+
+// ==================== 错误响应 ====================
+throw err.badRequest('参数错误')     // 400
+throw err.unauthorized('请先登录')   // 401
+throw err.forbidden('无权限')        // 403
+throw err.notFound('用户不存在')     // 404
+throw err.conflict('用户名已存在')   // 409
+throw err.internal('服务器错误')     // 500
+throw err('自定义错误', 422, 'CUSTOM_TYPE')  // 自定义
+```
+
+**API 速查表：**
+
+| 场景 | 写法 | 结果 |
+|------|------|------|
+| 查询成功 | `return data` | 200 + JSON |
+| 创建成功 | `return json(data, 201)` | 201 + JSON |
+| 参数错误 | `throw err.badRequest()` | 400 |
+| 未授权 | `throw err.unauthorized()` | 401 |
+| 禁止访问 | `throw err.forbidden()` | 403 |
+| 未找到 | `throw err.notFound()` | 404 |
+| 资源冲突 | `throw err.conflict()` | 409 |
+| 服务器错误 | `throw err.internal()` | 500 |
+
 ### 类型安全的路由
 
 ```typescript

package/dist/base-server-B7MYJNsl.mjs

@@ -0,0 +1,112 @@
+//#region src/server/base-server.ts
+/**
+* 服务器基类
+* 包含所有服务器类型的公共逻辑
+*/
+var BaseServer = class {
+	globalMiddleware = [];
+	use(mw) {
+		this.globalMiddleware.push(mw);
+	}
+	/**
+	* 打印扁平化后的路由信息，用于调试
+	*/
+	logFlattenedRoutes(routes, type = "路由") {
+		console.log(`🚀 扁平化后的${type}:`);
+		for (const route of routes) {
+			const method = route.method || "GET";
+			const path = route.fullPath || route.path;
+			console.log(`  ${method} ${path}`);
+			if (route.middlewareChain && route.middlewareChain.length > 0) console.log(`    中间件链: ${route.middlewareChain.length} 个`);
+		}
+		console.log("");
+	}
+	/**
+	* 检测路由冲突
+	* 检查是否有路径相同但方法不同的路由，以及潜在的路径冲突
+	*/
+	detectRouteConflicts(routes) {
+		const pathGroups = /* @__PURE__ */ new Map();
+		for (const route of routes) {
+			const path = route.fullPath || route.path;
+			const method = route.method || "GET";
+			if (!pathGroups.has(path)) pathGroups.set(path, []);
+			pathGroups.get(path).push({
+				...route,
+				method
+			});
+		}
+		for (const [path, routeList] of pathGroups) if (routeList.length > 1) {
+			const methods = routeList.map((r) => r.method);
+			const uniqueMethods = [...new Set(methods)];
+			if (uniqueMethods.length === 1) {
+				console.warn(`⚠️  路由冲突: ${uniqueMethods[0]} ${path} 定义了 ${routeList.length} 次`);
+				routeList.forEach((route, index) => {
+					console.warn(`   ${index + 1}. ${route.method} ${path}`);
+				});
+			} else console.log(`ℹ️  路径 ${path} 支持方法: ${uniqueMethods.join(", ")}`);
+		}
+		this.detectDynamicRouteConflicts(routes);
+	}
+	/**
+	* 检测动态路由的潜在冲突
+	*/
+	detectDynamicRouteConflicts(routes) {
+		const dynamicRoutes = routes.filter((r) => {
+			const path = r.fullPath || r.path;
+			return path.includes(":") || path.includes("*");
+		});
+		for (let i = 0; i < dynamicRoutes.length; i++) for (let j = i + 1; j < dynamicRoutes.length; j++) {
+			const route1 = dynamicRoutes[i];
+			const route2 = dynamicRoutes[j];
+			const method1 = route1.method || "GET";
+			if (method1 === (route2.method || "GET")) {
+				const path1 = route1.fullPath || route1.path;
+				const path2 = route2.fullPath || route2.path;
+				if (this.pathsMayConflict(path1, path2)) console.warn(`⚠️  潜在路由冲突: ${method1} ${path1} 可能与 ${path2} 冲突`);
+			}
+		}
+	}
+	/**
+	* 判断两个路径是否可能冲突
+	*/
+	pathsMayConflict(path1, path2) {
+		const parts1 = path1.split("/").filter(Boolean);
+		const parts2 = path2.split("/").filter(Boolean);
+		if (parts1.length !== parts2.length) return false;
+		for (let i = 0; i < parts1.length; i++) {
+			const p1 = parts1[i];
+			const p2 = parts2[i];
+			if (!p1.startsWith(":") && !p1.startsWith("*") && !p2.startsWith(":") && !p2.startsWith("*") && p1 !== p2) return false;
+			if (p1 === "*" && p2.startsWith(":") || p2 === "*" && p1.startsWith(":")) return true;
+		}
+		return false;
+	}
+	/**
+	* 路径匹配
+	*/
+	matchPath(pattern, path) {
+		const patternParts = pattern.split("/").filter(Boolean);
+		const pathParts = path.split("/").filter(Boolean);
+		if (patternParts.length !== pathParts.length) return false;
+		for (let i = 0; i < patternParts.length; i++) if (patternParts[i] !== pathParts[i] && !patternParts[i].startsWith(":")) return false;
+		return true;
+	}
+	/**
+	* 提取路径参数
+	*/
+	extractParams(pattern, path) {
+		const params = {};
+		const patternParts = pattern.split("/").filter(Boolean);
+		const pathParts = path.split("/").filter(Boolean);
+		for (let i = 0; i < patternParts.length; i++) if (patternParts[i].startsWith(":")) {
+			const paramName = patternParts[i].slice(1);
+			params[paramName] = pathParts[i];
+		}
+		return params;
+	}
+};
+
+//#endregion
+export { BaseServer as t };
+//# sourceMappingURL=base-server-B7MYJNsl.mjs.map

package/dist/{base-server-DMhpmq5v.mjs.map → base-server-B7MYJNsl.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"base-server-DMhpmq5v.mjs","names":[],"sources":["../src/server/base-server.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\n\n/**\n * 服务器基类\n * 包含所有服务器类型的公共逻辑\n */\nexport abstract class BaseServer {\n  protected globalMiddleware: Middleware[] = [];\n\n  use(mw: Middleware) {\n    this.globalMiddleware.push(mw);\n  }\n\n  /**\n   * 打印扁平化后的路由信息，用于调试\n   */\n  protected logFlattenedRoutes(routes: any[], type: string = \"路由\"): void {\n    console.log(`🚀 扁平化后的${type}:`);\n    for (const route of routes) {\n      const method = route.method || \"GET\";\n      const path = route.fullPath || route.path;\n      console.log(`  ${method} ${path}`);\n      if (route.middlewareChain && route.middlewareChain.length > 0) {\n        console.log(`    中间件链: ${route.middlewareChain.length} 个`);\n      }\n    }\n    console.log(\"\");\n  }\n\n  /**\n   * 检测路由冲突\n   * 检查是否有路径相同但方法不同的路由，以及潜在的路径冲突\n   */\n  protected detectRouteConflicts(routes: any[]): void {\n    const pathGroups = new Map<string, any[]>();\n\n    // 按路径分组\n    for (const route of routes) {\n      const path = route.fullPath || route.path;\n      const method = route.method || \"GET\";\n      if (!pathGroups.has(path)) {\n        pathGroups.set(path, []);\n      }\n      pathGroups.get(path)!.push({ ...route, method });\n    }\n\n    // 检查冲突\n    for (const [path, routeList] of pathGroups) {\n      if (routeList.length > 1) {\n        const methods = routeList.map((r) => r.method);\n        const uniqueMethods = [...new Set(methods)];\n\n        if (uniqueMethods.length === 1) {\n          // 相同路径、相同方法 - 这是冲突！\n          console.warn(\n            `⚠️  路由冲突: ${uniqueMethods[0]} ${path} 定义了 ${routeList.length} 次`,\n          );\n          routeList.forEach((route, index) => {\n            console.warn(`   ${index + 1}. ${route.method} ${path}`);\n          });\n        } else {\n          // 相同路径、不同方法 - 这是正常的\n          console.log(`ℹ️  路径 ${path} 支持方法: ${uniqueMethods.join(\", \")}`);\n        }\n      }\n    }\n\n    // 检查潜在的路径冲突（动态路由可能冲突）\n    this.detectDynamicRouteConflicts(routes);\n  }\n\n  /**\n   * 检测动态路由的潜在冲突\n   */\n  private detectDynamicRouteConflicts(routes: any[]): void {\n    const dynamicRoutes = routes.filter((r) => {\n      const path = r.fullPath || r.path;\n      return path.includes(\":\") || path.includes(\"*\");\n    });\n\n    for (let i = 0; i < dynamicRoutes.length; i++) {\n      for (let j = i + 1; j < dynamicRoutes.length; j++) {\n        const route1 = dynamicRoutes[i];\n        const route2 = dynamicRoutes[j];\n        const method1 = route1.method || \"GET\";\n        const method2 = route2.method || \"GET\";\n\n        if (method1 === method2) {\n          const path1 = route1.fullPath || route1.path;\n          const path2 = route2.fullPath || route2.path;\n          // 检查路径是否可能冲突\n          if (this.pathsMayConflict(path1, path2)) {\n            console.warn(\n              `⚠️  潜在路由冲突: ${method1} ${path1} 可能与 ${path2} 冲突`,\n            );\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * 判断两个路径是否可能冲突\n   */\n  private pathsMayConflict(path1: string, path2: string): boolean {\n    const parts1 = path1.split(\"/\").filter(Boolean);\n    const parts2 = path2.split(\"/\").filter(Boolean);\n\n    if (parts1.length !== parts2.length) return false;\n\n    for (let i = 0; i < parts1.length; i++) {\n      const p1 = parts1[i];\n      const p2 = parts2[i];\n\n      // 如果两个部分都是静态的且不同，则不会冲突\n      if (\n        !p1.startsWith(\":\") &&\n        !p1.startsWith(\"*\") &&\n        !p2.startsWith(\":\") &&\n        !p2.startsWith(\"*\") &&\n        p1 !== p2\n      ) {\n        return false;\n      }\n\n      // 如果一个是通配符，另一个是动态参数，可能冲突\n      if (\n        (p1 === \"*\" && p2.startsWith(\":\")) ||\n        (p2 === \"*\" && p1.startsWith(\":\"))\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * 路径匹配\n   */\n  protected matchPath(pattern: string, path: string): boolean {\n    const patternParts = pattern.split(\"/\").filter(Boolean);\n    const pathParts = path.split(\"/\").filter(Boolean);\n\n    if (patternParts.length !== pathParts.length) {\n      return false;\n    }\n\n    for (let i = 0; i < patternParts.length; i++) {\n      if (\n        patternParts[i] !== pathParts[i] &&\n        !patternParts[i].startsWith(\":\")\n      ) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * 提取路径参数\n   */\n  protected extractParams(\n    pattern: string,\n    path: string,\n  ): Record<string, string> {\n    const params: Record<string, string> = {};\n    const patternParts = pattern.split(\"/\").filter(Boolean);\n    const pathParts = path.split(\"/\").filter(Boolean);\n\n    for (let i = 0; i < patternParts.length; i++) {\n      if (patternParts[i].startsWith(\":\")) {\n        const paramName = patternParts[i].slice(1);\n        params[paramName] = pathParts[i];\n      }\n    }\n\n    return params;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"base-server-B7MYJNsl.mjs","names":[],"sources":["../src/server/base-server.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\n\n/**\n * 服务器基类\n * 包含所有服务器类型的公共逻辑\n */\nexport abstract class BaseServer {\n  protected globalMiddleware: Middleware[] = [];\n\n  use(mw: Middleware) {\n    this.globalMiddleware.push(mw);\n  }\n\n  /**\n   * 打印扁平化后的路由信息，用于调试\n   */\n  protected logFlattenedRoutes(routes: any[], type: string = \"路由\"): void {\n    console.log(`🚀 扁平化后的${type}:`);\n    for (const route of routes) {\n      const method = route.method || \"GET\";\n      const path = route.fullPath || route.path;\n      console.log(`  ${method} ${path}`);\n      if (route.middlewareChain && route.middlewareChain.length > 0) {\n        console.log(`    中间件链: ${route.middlewareChain.length} 个`);\n      }\n    }\n    console.log(\"\");\n  }\n\n  /**\n   * 检测路由冲突\n   * 检查是否有路径相同但方法不同的路由，以及潜在的路径冲突\n   */\n  protected detectRouteConflicts(routes: any[]): void {\n    const pathGroups = new Map<string, any[]>();\n\n    // 按路径分组\n    for (const route of routes) {\n      const path = route.fullPath || route.path;\n      const method = route.method || \"GET\";\n      if (!pathGroups.has(path)) {\n        pathGroups.set(path, []);\n      }\n      pathGroups.get(path)!.push({ ...route, method });\n    }\n\n    // 检查冲突\n    for (const [path, routeList] of pathGroups) {\n      if (routeList.length > 1) {\n        const methods = routeList.map((r) => r.method);\n        const uniqueMethods = [...new Set(methods)];\n\n        if (uniqueMethods.length === 1) {\n          // 相同路径、相同方法 - 这是冲突！\n          console.warn(\n            `⚠️  路由冲突: ${uniqueMethods[0]} ${path} 定义了 ${routeList.length} 次`,\n          );\n          routeList.forEach((route, index) => {\n            console.warn(`   ${index + 1}. ${route.method} ${path}`);\n          });\n        } else {\n          // 相同路径、不同方法 - 这是正常的\n          console.log(`ℹ️  路径 ${path} 支持方法: ${uniqueMethods.join(\", \")}`);\n        }\n      }\n    }\n\n    // 检查潜在的路径冲突（动态路由可能冲突）\n    this.detectDynamicRouteConflicts(routes);\n  }\n\n  /**\n   * 检测动态路由的潜在冲突\n   */\n  private detectDynamicRouteConflicts(routes: any[]): void {\n    const dynamicRoutes = routes.filter((r) => {\n      const path = r.fullPath || r.path;\n      return path.includes(\":\") || path.includes(\"*\");\n    });\n\n    for (let i = 0; i < dynamicRoutes.length; i++) {\n      for (let j = i + 1; j < dynamicRoutes.length; j++) {\n        const route1 = dynamicRoutes[i];\n        const route2 = dynamicRoutes[j];\n        const method1 = route1.method || \"GET\";\n        const method2 = route2.method || \"GET\";\n\n        if (method1 === method2) {\n          const path1 = route1.fullPath || route1.path;\n          const path2 = route2.fullPath || route2.path;\n          // 检查路径是否可能冲突\n          if (this.pathsMayConflict(path1, path2)) {\n            console.warn(\n              `⚠️  潜在路由冲突: ${method1} ${path1} 可能与 ${path2} 冲突`,\n            );\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * 判断两个路径是否可能冲突\n   */\n  private pathsMayConflict(path1: string, path2: string): boolean {\n    const parts1 = path1.split(\"/\").filter(Boolean);\n    const parts2 = path2.split(\"/\").filter(Boolean);\n\n    if (parts1.length !== parts2.length) return false;\n\n    for (let i = 0; i < parts1.length; i++) {\n      const p1 = parts1[i];\n      const p2 = parts2[i];\n\n      // 如果两个部分都是静态的且不同，则不会冲突\n      if (\n        !p1.startsWith(\":\") &&\n        !p1.startsWith(\"*\") &&\n        !p2.startsWith(\":\") &&\n        !p2.startsWith(\"*\") &&\n        p1 !== p2\n      ) {\n        return false;\n      }\n\n      // 如果一个是通配符，另一个是动态参数，可能冲突\n      if (\n        (p1 === \"*\" && p2.startsWith(\":\")) ||\n        (p2 === \"*\" && p1.startsWith(\":\"))\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * 路径匹配\n   */\n  protected matchPath(pattern: string, path: string): boolean {\n    const patternParts = pattern.split(\"/\").filter(Boolean);\n    const pathParts = path.split(\"/\").filter(Boolean);\n\n    if (patternParts.length !== pathParts.length) {\n      return false;\n    }\n\n    for (let i = 0; i < patternParts.length; i++) {\n      if (\n        patternParts[i] !== pathParts[i] &&\n        !patternParts[i].startsWith(\":\")\n      ) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * 提取路径参数\n   */\n  protected extractParams(\n    pattern: string,\n    path: string,\n  ): Record<string, string> {\n    const params: Record<string, string> = {};\n    const patternParts = pattern.split(\"/\").filter(Boolean);\n    const pathParts = path.split(\"/\").filter(Boolean);\n\n    for (let i = 0; i < patternParts.length; i++) {\n      if (patternParts[i].startsWith(\":\")) {\n        const paramName = patternParts[i].slice(1);\n        params[paramName] = pathParts[i];\n      }\n    }\n\n    return params;\n  }\n}\n"],"mappings":"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"}

package/dist/{base-server-CtA1bZSg.d.mts → base-server-DLxtulAO.d.mts}

@@ -1,4 +1,4 @@
-import { o as Middleware } from "./types-mpeSaHdI.mjs";
+import { o as Middleware } from "./types-D1PUFkda.mjs";
 
 //#region src/server/base-server.d.ts
 
@@ -37,4 +37,4 @@ declare abstract class BaseServer {
 }
 //#endregion
 export { BaseServer as t };
-//# sourceMappingURL=base-server-CtA1bZSg.d.mts.map
+//# sourceMappingURL=base-server-DLxtulAO.d.mts.map

package/dist/{base64url-DUtluDF0.mjs → base64url-C2zopQdH.mjs}

@@ -10,4 +10,4 @@ function base64urlDecode(str) {
 
 //#endregion
 export { base64urlEncode as n, base64urlDecode as t };
-//# sourceMappingURL=base64url-DUtluDF0.mjs.map
+//# sourceMappingURL=base64url-C2zopQdH.mjs.map

package/dist/{base64url-DUtluDF0.mjs.map → base64url-C2zopQdH.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"base64url-DUtluDF0.mjs","names":[],"sources":["../src/utils/base64url.ts"],"sourcesContent":["export function base64urlEncode(str: string): string {\n  return btoa(str)\n    .replace(/=/g, \"\") // ✅ 删除填充\n    .replace(/\\+/g, \"-\")\n    .replace(/\\//g, \"_\");\n}\n\nexport function base64urlDecode(str: string): string {\n  const pad = str.length % 4 === 0 ? \"\" : \"=\".repeat(4 - (str.length % 4));\n  const base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\") + pad;\n  return atob(base64);\n}\n"],"mappings":";AAAA,SAAgB,gBAAgB,KAAqB;AACnD,QAAO,KAAK,IAAI,CACb,QAAQ,MAAM,GAAG,CACjB,QAAQ,OAAO,IAAI,CACnB,QAAQ,OAAO,IAAI;;AAGxB,SAAgB,gBAAgB,KAAqB;CACnD,MAAM,MAAM,IAAI,SAAS,MAAM,IAAI,KAAK,IAAI,OAAO,IAAK,IAAI,SAAS,EAAG;CACxE,MAAM,SAAS,IAAI,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,IAAI,GAAG;AAC3D,QAAO,KAAK,OAAO"}
+{"version":3,"file":"base64url-C2zopQdH.mjs","names":[],"sources":["../src/utils/base64url.ts"],"sourcesContent":["export function base64urlEncode(str: string): string {\n  return btoa(str)\n    .replace(/=/g, \"\") // ✅ 删除填充\n    .replace(/\\+/g, \"-\")\n    .replace(/\\//g, \"_\");\n}\n\nexport function base64urlDecode(str: string): string {\n  const pad = str.length % 4 === 0 ? \"\" : \"=\".repeat(4 - (str.length % 4));\n  const base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\") + pad;\n  return atob(base64);\n}\n"],"mappings":";AAAA,SAAgB,gBAAgB,KAAqB;AACnD,QAAO,KAAK,IAAI,CACb,QAAQ,MAAM,GAAG,CACjB,QAAQ,OAAO,IAAI,CACnB,QAAQ,OAAO,IAAI;;AAGxB,SAAgB,gBAAgB,KAAqB;CACnD,MAAM,MAAM,IAAI,SAAS,MAAM,IAAI,KAAK,IAAI,OAAO,IAAK,IAAI,SAAS,EAAG;CACxE,MAAM,SAAS,IAAI,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,IAAI,GAAG;AAC3D,QAAO,KAAK,OAAO"}

package/dist/{base64url-0N9uQPjZ.d.mts → base64url-Dwi2Afhc.d.mts}

@@ -3,4 +3,4 @@ declare function base64urlEncode(str: string): string;
 declare function base64urlDecode(str: string): string;
 //#endregion
 export { base64urlEncode as n, base64urlDecode as t };
-//# sourceMappingURL=base64url-0N9uQPjZ.d.mts.map
+//# sourceMappingURL=base64url-Dwi2Afhc.d.mts.map

package/dist/{component-route-DF5feXJI.d.mts → component-route-nrrO0iSI.d.mts}

@@ -1,4 +1,4 @@
-import { a as Middleware } from "./route-CUbNpSwz.mjs";
+import { a as Middleware } from "./route-6A7umH7b.mjs";
 
 //#region src/types/component-route.d.ts
 
@@ -28,4 +28,4 @@ interface FlattenedComponentRoute extends ComponentRoute {
 }
 //#endregion
 export { FlattenedComponentRoute as n, NestedComponentRoute as r, ComponentRoute as t };
-//# sourceMappingURL=component-route-DF5feXJI.d.mts.map
+//# sourceMappingURL=component-route-nrrO0iSI.d.mts.map

package/dist/{component-router-uSylkByf.mjs → component-router-RwPL20vN.mjs}

@@ -1,5 +1,3 @@
-import { t as __esmMin } from "./chunk-DW4-Jl94.mjs";
-
 //#region src/middleware/component-router.ts
 /**
 * 扁平化嵌套组件路由
@@ -19,15 +17,16 @@ function flattenComponentRoutes(routes) {
 	for (const route of routes) processRoute(route);
 	return flattened;
 }
-var componentRouter;
-var init_component_router = __esmMin((() => {
-	componentRouter = () => {
-		return async (req, next) => {
-			return next();
-		};
+/**
+* 组件路由处理器中间件
+* 自动检测组件类型并应用相应的渲染器
+*/
+const componentRouter = () => {
+	return async (req, next) => {
+		return next();
 	};
-}));
+};
 
 //#endregion
-export { flattenComponentRoutes as n, init_component_router as r, componentRouter as t };
-//# sourceMappingURL=component-router-uSylkByf.mjs.map
+export { flattenComponentRoutes as n, componentRouter as t };
+//# sourceMappingURL=component-router-RwPL20vN.mjs.map

package/dist/{component-router-uSylkByf.mjs.map → component-router-RwPL20vN.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"component-router-uSylkByf.mjs","names":[],"sources":["../src/middleware/component-router.ts"],"sourcesContent":["import type {\n  ComponentRoute,\n  NestedComponentRoute,\n  FlattenedComponentRoute,\n} from \"../types/component-route\";\nimport { vueRenderer, reactRenderer } from \"./component-renderer\";\n\n/**\n * 扁平化嵌套组件路由\n */\nexport function flattenComponentRoutes(\n  routes: (ComponentRoute | NestedComponentRoute)[],\n): FlattenedComponentRoute[] {\n  const flattened: FlattenedComponentRoute[] = [];\n\n  function processRoute(\n    route: ComponentRoute | NestedComponentRoute,\n    parentPath: string = \"\",\n    parentMiddleware: any[] = [],\n  ) {\n    const currentPath = parentPath + route.path;\n    const currentMiddleware = [\n      ...parentMiddleware,\n      ...(route.middleware || []),\n    ];\n\n    if (\"component\" in route) {\n      // 这是一个组件路由\n      flattened.push({\n        ...route,\n        fullPath: currentPath,\n        middlewareChain: currentMiddleware,\n      });\n    } else if (\"children\" in route && route.children) {\n      // 这是一个嵌套路由\n      for (const child of route.children) {\n        processRoute(child, currentPath, currentMiddleware);\n      }\n    }\n  }\n\n  for (const route of routes) {\n    processRoute(route);\n  }\n\n  return flattened;\n}\n\n/**\n * 组件路由处理器中间件\n * 自动检测组件类型并应用相应的渲染器\n */\nexport const componentRouter = () => {\n  return async (req: Request, next: () => Promise<Response>) => {\n    // 这里可以添加组件路由的自动处理逻辑\n    // 比如自动检测组件类型，应用相应的渲染器\n    return next();\n  };\n};\n"],"mappings":";;;;;;AAUA,SAAgB,uBACd,QAC2B;CAC3B,MAAM,YAAuC,EAAE;CAE/C,SAAS,aACP,OACA,aAAqB,IACrB,mBAA0B,EAAE,EAC5B;EACA,MAAM,cAAc,aAAa,MAAM;EACvC,MAAM,oBAAoB,CACxB,GAAG,kBACH,GAAI,MAAM,cAAc,EAAE,CAC3B;AAED,MAAI,eAAe,MAEjB,WAAU,KAAK;GACb,GAAG;GACH,UAAU;GACV,iBAAiB;GAClB,CAAC;WACO,cAAc,SAAS,MAAM,SAEtC,MAAK,MAAM,SAAS,MAAM,SACxB,cAAa,OAAO,aAAa,kBAAkB;;AAKzD,MAAK,MAAM,SAAS,OAClB,cAAa,MAAM;AAGrB,QAAO;;;;CAOI,wBAAwB;AACnC,SAAO,OAAO,KAAc,SAAkC;AAG5D,UAAO,MAAM"}
+{"version":3,"file":"component-router-RwPL20vN.mjs","names":[],"sources":["../src/middleware/component-router.ts"],"sourcesContent":["import type {\n  ComponentRoute,\n  NestedComponentRoute,\n  FlattenedComponentRoute,\n} from \"../types/component-route\";\nimport { vueRenderer, reactRenderer } from \"./component-renderer\";\n\n/**\n * 扁平化嵌套组件路由\n */\nexport function flattenComponentRoutes(\n  routes: (ComponentRoute | NestedComponentRoute)[],\n): FlattenedComponentRoute[] {\n  const flattened: FlattenedComponentRoute[] = [];\n\n  function processRoute(\n    route: ComponentRoute | NestedComponentRoute,\n    parentPath: string = \"\",\n    parentMiddleware: any[] = [],\n  ) {\n    const currentPath = parentPath + route.path;\n    const currentMiddleware = [\n      ...parentMiddleware,\n      ...(route.middleware || []),\n    ];\n\n    if (\"component\" in route) {\n      // 这是一个组件路由\n      flattened.push({\n        ...route,\n        fullPath: currentPath,\n        middlewareChain: currentMiddleware,\n      });\n    } else if (\"children\" in route && route.children) {\n      // 这是一个嵌套路由\n      for (const child of route.children) {\n        processRoute(child, currentPath, currentMiddleware);\n      }\n    }\n  }\n\n  for (const route of routes) {\n    processRoute(route);\n  }\n\n  return flattened;\n}\n\n/**\n * 组件路由处理器中间件\n * 自动检测组件类型并应用相应的渲染器\n */\nexport const componentRouter = () => {\n  return async (req: Request, next: () => Promise<Response>) => {\n    // 这里可以添加组件路由的自动处理逻辑\n    // 比如自动检测组件类型，应用相应的渲染器\n    return next();\n  };\n};\n"],"mappings":";;;;AAUA,SAAgB,uBACd,QAC2B;CAC3B,MAAM,YAAuC,EAAE;CAE/C,SAAS,aACP,OACA,aAAqB,IACrB,mBAA0B,EAAE,EAC5B;EACA,MAAM,cAAc,aAAa,MAAM;EACvC,MAAM,oBAAoB,CACxB,GAAG,kBACH,GAAI,MAAM,cAAc,EAAE,CAC3B;AAED,MAAI,eAAe,MAEjB,WAAU,KAAK;GACb,GAAG;GACH,UAAU;GACV,iBAAiB;GAClB,CAAC;WACO,cAAc,SAAS,MAAM,SAEtC,MAAK,MAAM,SAAS,MAAM,SACxB,cAAa,OAAO,aAAa,kBAAkB;;AAKzD,MAAK,MAAM,SAAS,OAClB,cAAa,MAAM;AAGrB,QAAO;;;;;;AAOT,MAAa,wBAAwB;AACnC,QAAO,OAAO,KAAc,SAAkC;AAG5D,SAAO,MAAM"}

package/dist/component-server-DomPJ_7S.mjs

@@ -0,0 +1,119 @@
+import { t as BaseServer } from "./base-server-B7MYJNsl.mjs";
+import { n as flattenComponentRoutes } from "./component-router-RwPL20vN.mjs";
+import { t as PathMatcher } from "./path-matcher-CGczAIl_.mjs";
+import { t as HtmlRenderer } from "./html-renderer-DTtJ_Yic.mjs";
+import { t as DependencyManager } from "./dependency-manager-DCmh7xFc.mjs";
+
+//#region src/server/component-server.ts
+/**
+* 组件路由服务器
+* 专门处理声明式组件路由
+*/
+var ComponentServer = class extends BaseServer {
+	routes;
+	dependencyManager;
+	constructor(routes) {
+		super();
+		this.routes = flattenComponentRoutes(routes);
+		this.dependencyManager = new DependencyManager();
+		this.detectRouteConflicts(this.routes);
+		this.logFlattenedRoutes(this.routes, "组件路由");
+		console.log("🚀 依赖按需加载，服务器启动完成");
+	}
+	/**
+	* 处理请求
+	*/
+	async fetch(req) {
+		const url = new URL(req.url);
+		const pathname = url.pathname;
+		if (req.method !== "GET") return new Response("Method Not Allowed", { status: 405 });
+		let matchedRoute = null;
+		for (const route of this.routes) if (PathMatcher.matchPath(route.fullPath, pathname)) {
+			matchedRoute = route;
+			break;
+		}
+		if (!matchedRoute) return new Response("Not Found", { status: 404 });
+		try {
+			const context = {
+				req,
+				params: PathMatcher.extractParams(matchedRoute.fullPath, pathname),
+				query: Object.fromEntries(url.searchParams),
+				pathname
+			};
+			return await this.executeMiddlewareChain(matchedRoute.middlewareChain, context, matchedRoute.component);
+		} catch (error) {
+			console.error("组件渲染失败:", error);
+			return new Response("Internal Server Error", { status: 500 });
+		}
+	}
+	/**
+	* 执行中间件链
+	*/
+	async executeMiddlewareChain(middlewareChain, context, componentImport) {
+		const renderComponent = async () => {
+			const componentModule = await componentImport();
+			const component = componentModule.default || componentModule;
+			const componentType = this.dependencyManager.detectComponentType(component);
+			const deps = await this.dependencyManager.getFrameworkDeps(componentType);
+			if (componentType === "vue") return await this.renderVueComponent(component, context, deps);
+			else if (componentType === "react") return await this.renderReactComponent(component, context, deps);
+			else throw new Error(`不支持的组件类型: ${componentType}`);
+		};
+		let index = 0;
+		const next = async () => {
+			if (index >= middlewareChain.length) return await renderComponent();
+			const middleware = middlewareChain[index++];
+			return await middleware(context.req, next);
+		};
+		return await next();
+	}
+	/**
+	* 渲染 Vue 组件
+	*/
+	async renderVueComponent(component, context, deps) {
+		try {
+			const [vue, renderer] = deps;
+			const app = vue.createSSRApp(component);
+			app.provide("routeInfo", {
+				params: context.params || {},
+				query: context.query || {},
+				pathname: context.pathname
+			});
+			const html = await renderer.renderToString(app);
+			const fullHtml = HtmlRenderer.generateVueHtml(html, context);
+			return new Response(fullHtml, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+		} catch (error) {
+			console.error("Vue 组件渲染失败:", error);
+			return new Response("Vue Component Render Error", { status: 500 });
+		}
+	}
+	/**
+	* 渲染 React 组件
+	*/
+	async renderReactComponent(component, context, deps) {
+		try {
+			const [react, renderer] = deps;
+			const content = react.createElement(component, {
+				req: context.req,
+				params: context.params || {},
+				query: context.query || {}
+			});
+			const html = renderer.renderToString(content);
+			const fullHtml = HtmlRenderer.generateReactHtml(html, context);
+			return new Response(fullHtml, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+		} catch (error) {
+			console.error("React 组件渲染失败:", error);
+			return new Response("React Component Render Error", { status: 500 });
+		}
+	}
+	/**
+	* 获取依赖管理器（用于外部访问）
+	*/
+	getDependencyManager() {
+		return this.dependencyManager;
+	}
+};
+
+//#endregion
+export { ComponentServer as t };
+//# sourceMappingURL=component-server-DomPJ_7S.mjs.map

package/dist/{component-server-DIgykV0F.mjs.map → component-server-DomPJ_7S.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"component-server-DIgykV0F.mjs","names":[],"sources":["../src/server/component-server.ts"],"sourcesContent":["import type {\n  ComponentRoute,\n  NestedComponentRoute,\n  FlattenedComponentRoute,\n} from \"../types/component-route\";\nimport { flattenComponentRoutes } from \"../middleware/component-router\";\nimport { BaseServer } from \"./base-server\";\nimport { PathMatcher } from \"../utils/path-matcher\";\nimport { HtmlRenderer } from \"../utils/html-renderer\";\nimport { DependencyManager } from \"../utils/dependency-manager\";\n\n/**\n * 组件路由服务器\n * 专门处理声明式组件路由\n */\nexport class ComponentServer extends BaseServer {\n  private routes: FlattenedComponentRoute[];\n  private dependencyManager: DependencyManager;\n\n  constructor(routes: (ComponentRoute | NestedComponentRoute)[]) {\n    super();\n    this.routes = flattenComponentRoutes(routes);\n    this.dependencyManager = new DependencyManager();\n\n    // 检测路由冲突\n    this.detectRouteConflicts(this.routes);\n    this.logFlattenedRoutes(this.routes, \"组件路由\");\n    console.log(\"🚀 依赖按需加载，服务器启动完成\");\n  }\n\n  /**\n   * 处理请求\n   */\n  async fetch(req: Request): Promise<Response> {\n    const url = new URL(req.url);\n    const pathname = url.pathname;\n    const method = req.method;\n\n    // 只支持 GET 请求\n    if (method !== \"GET\") {\n      return new Response(\"Method Not Allowed\", { status: 405 });\n    }\n\n    // 查找匹配的路由\n    let matchedRoute: FlattenedComponentRoute | null = null;\n    for (const route of this.routes) {\n      if (PathMatcher.matchPath(route.fullPath, pathname)) {\n        matchedRoute = route;\n        break;\n      }\n    }\n\n    if (!matchedRoute) {\n      return new Response(\"Not Found\", { status: 404 });\n    }\n\n    try {\n      // 创建中间件上下文\n      const context = {\n        req,\n        params: PathMatcher.extractParams(matchedRoute.fullPath, pathname),\n        query: Object.fromEntries(url.searchParams),\n        pathname,\n      };\n\n      // 执行中间件链，中间件会处理组件渲染\n      return await this.executeMiddlewareChain(\n        matchedRoute.middlewareChain,\n        context,\n        matchedRoute.component,\n      );\n    } catch (error) {\n      console.error(\"组件渲染失败:\", error);\n      return new Response(\"Internal Server Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 执行中间件链\n   */\n  private async executeMiddlewareChain(\n    middlewareChain: any[],\n    context: any,\n    componentImport: () => Promise<any>,\n  ): Promise<Response> {\n    // 创建最终的渲染函数\n    const renderComponent = async () => {\n      const componentModule = await componentImport();\n      const component = componentModule.default || componentModule;\n\n      // 自动检测组件类型\n      const componentType =\n        this.dependencyManager.detectComponentType(component);\n\n      // 按需加载依赖\n      const deps = await this.dependencyManager.getFrameworkDeps(componentType);\n\n      // 根据组件类型渲染\n      if (componentType === \"vue\") {\n        return await this.renderVueComponent(component, context, deps);\n      } else if (componentType === \"react\") {\n        return await this.renderReactComponent(component, context, deps);\n      } else {\n        throw new Error(`不支持的组件类型: ${componentType}`);\n      }\n    };\n\n    // 执行中间件链\n    let index = 0;\n    const next = async (): Promise<Response> => {\n      if (index >= middlewareChain.length) {\n        return await renderComponent();\n      }\n\n      const middleware = middlewareChain[index++];\n      return await middleware(context.req, next);\n    };\n\n    return await next();\n  }\n\n  /**\n   * 渲染 Vue 组件\n   */\n  private async renderVueComponent(\n    component: any,\n    context: any,\n    deps: any,\n  ): Promise<Response> {\n    try {\n      const [vue, renderer] = deps;\n      const app = vue.createSSRApp(component);\n\n      // 提供路由信息\n      app.provide(\"routeInfo\", {\n        params: context.params || {},\n        query: context.query || {},\n        pathname: context.pathname,\n      });\n\n      const html = await renderer.renderToString(app);\n      const fullHtml = HtmlRenderer.generateVueHtml(html, context);\n\n      return new Response(fullHtml, {\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (error) {\n      console.error(\"Vue 组件渲染失败:\", error);\n      return new Response(\"Vue Component Render Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 渲染 React 组件\n   */\n  private async renderReactComponent(\n    component: any,\n    context: any,\n    deps: any,\n  ): Promise<Response> {\n    try {\n      const [react, renderer] = deps;\n      const content = react.createElement(component, {\n        req: context.req,\n        params: context.params || {},\n        query: context.query || {},\n      });\n\n      const html = renderer.renderToString(content);\n      const fullHtml = HtmlRenderer.generateReactHtml(html, context);\n\n      return new Response(fullHtml, {\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (error) {\n      console.error(\"React 组件渲染失败:\", error);\n      return new Response(\"React Component Render Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 获取依赖管理器（用于外部访问）\n   */\n  getDependencyManager(): DependencyManager {\n    return this.dependencyManager;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"component-server-DomPJ_7S.mjs","names":[],"sources":["../src/server/component-server.ts"],"sourcesContent":["import type {\n  ComponentRoute,\n  NestedComponentRoute,\n  FlattenedComponentRoute,\n} from \"../types/component-route\";\nimport { flattenComponentRoutes } from \"../middleware/component-router\";\nimport { BaseServer } from \"./base-server\";\nimport { PathMatcher } from \"../utils/path-matcher\";\nimport { HtmlRenderer } from \"../utils/html-renderer\";\nimport { DependencyManager } from \"../utils/dependency-manager\";\n\n/**\n * 组件路由服务器\n * 专门处理声明式组件路由\n */\nexport class ComponentServer extends BaseServer {\n  private routes: FlattenedComponentRoute[];\n  private dependencyManager: DependencyManager;\n\n  constructor(routes: (ComponentRoute | NestedComponentRoute)[]) {\n    super();\n    this.routes = flattenComponentRoutes(routes);\n    this.dependencyManager = new DependencyManager();\n\n    // 检测路由冲突\n    this.detectRouteConflicts(this.routes);\n    this.logFlattenedRoutes(this.routes, \"组件路由\");\n    console.log(\"🚀 依赖按需加载，服务器启动完成\");\n  }\n\n  /**\n   * 处理请求\n   */\n  async fetch(req: Request): Promise<Response> {\n    const url = new URL(req.url);\n    const pathname = url.pathname;\n    const method = req.method;\n\n    // 只支持 GET 请求\n    if (method !== \"GET\") {\n      return new Response(\"Method Not Allowed\", { status: 405 });\n    }\n\n    // 查找匹配的路由\n    let matchedRoute: FlattenedComponentRoute | null = null;\n    for (const route of this.routes) {\n      if (PathMatcher.matchPath(route.fullPath, pathname)) {\n        matchedRoute = route;\n        break;\n      }\n    }\n\n    if (!matchedRoute) {\n      return new Response(\"Not Found\", { status: 404 });\n    }\n\n    try {\n      // 创建中间件上下文\n      const context = {\n        req,\n        params: PathMatcher.extractParams(matchedRoute.fullPath, pathname),\n        query: Object.fromEntries(url.searchParams),\n        pathname,\n      };\n\n      // 执行中间件链，中间件会处理组件渲染\n      return await this.executeMiddlewareChain(\n        matchedRoute.middlewareChain,\n        context,\n        matchedRoute.component,\n      );\n    } catch (error) {\n      console.error(\"组件渲染失败:\", error);\n      return new Response(\"Internal Server Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 执行中间件链\n   */\n  private async executeMiddlewareChain(\n    middlewareChain: any[],\n    context: any,\n    componentImport: () => Promise<any>,\n  ): Promise<Response> {\n    // 创建最终的渲染函数\n    const renderComponent = async () => {\n      const componentModule = await componentImport();\n      const component = componentModule.default || componentModule;\n\n      // 自动检测组件类型\n      const componentType =\n        this.dependencyManager.detectComponentType(component);\n\n      // 按需加载依赖\n      const deps = await this.dependencyManager.getFrameworkDeps(componentType);\n\n      // 根据组件类型渲染\n      if (componentType === \"vue\") {\n        return await this.renderVueComponent(component, context, deps);\n      } else if (componentType === \"react\") {\n        return await this.renderReactComponent(component, context, deps);\n      } else {\n        throw new Error(`不支持的组件类型: ${componentType}`);\n      }\n    };\n\n    // 执行中间件链\n    let index = 0;\n    const next = async (): Promise<Response> => {\n      if (index >= middlewareChain.length) {\n        return await renderComponent();\n      }\n\n      const middleware = middlewareChain[index++];\n      return await middleware(context.req, next);\n    };\n\n    return await next();\n  }\n\n  /**\n   * 渲染 Vue 组件\n   */\n  private async renderVueComponent(\n    component: any,\n    context: any,\n    deps: any,\n  ): Promise<Response> {\n    try {\n      const [vue, renderer] = deps;\n      const app = vue.createSSRApp(component);\n\n      // 提供路由信息\n      app.provide(\"routeInfo\", {\n        params: context.params || {},\n        query: context.query || {},\n        pathname: context.pathname,\n      });\n\n      const html = await renderer.renderToString(app);\n      const fullHtml = HtmlRenderer.generateVueHtml(html, context);\n\n      return new Response(fullHtml, {\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (error) {\n      console.error(\"Vue 组件渲染失败:\", error);\n      return new Response(\"Vue Component Render Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 渲染 React 组件\n   */\n  private async renderReactComponent(\n    component: any,\n    context: any,\n    deps: any,\n  ): Promise<Response> {\n    try {\n      const [react, renderer] = deps;\n      const content = react.createElement(component, {\n        req: context.req,\n        params: context.params || {},\n        query: context.query || {},\n      });\n\n      const html = renderer.renderToString(content);\n      const fullHtml = HtmlRenderer.generateReactHtml(html, context);\n\n      return new Response(fullHtml, {\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (error) {\n      console.error(\"React 组件渲染失败:\", error);\n      return new Response(\"React Component Render Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 获取依赖管理器（用于外部访问）\n   */\n  getDependencyManager(): DependencyManager {\n    return this.dependencyManager;\n  }\n}\n"],"mappings":"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"}

package/dist/{component-server-DvcPVnL4.d.mts → component-server-JqpDC7wy.d.mts}

@@ -1,6 +1,6 @@
-import { r as NestedComponentRoute, t as ComponentRoute } from "./component-route-DF5feXJI.mjs";
-import { t as BaseServer } from "./base-server-CtA1bZSg.mjs";
-import { t as DependencyManager } from "./dependency-manager-C_qZvkaw.mjs";
+import { r as NestedComponentRoute, t as ComponentRoute } from "./component-route-nrrO0iSI.mjs";
+import { t as BaseServer } from "./base-server-DLxtulAO.mjs";
+import { t as DependencyManager } from "./dependency-manager-C3_7ic4h.mjs";
 
 //#region src/server/component-server.d.ts
 
@@ -35,4 +35,4 @@ declare class ComponentServer extends BaseServer {
 }
 //#endregion
 export { ComponentServer as t };
-//# sourceMappingURL=component-server-DvcPVnL4.d.mts.map
+//# sourceMappingURL=component-server-JqpDC7wy.d.mts.map

package/dist/{create-handler-DRcJRkx9.d.mts → create-handler-DKw-sQOV.d.mts}

@@ -1,4 +1,4 @@
-import { i as RouteSchema, n as HandlerContextWithExtra, t as HandlerContext } from "./schema-DOKg31ZX.mjs";
+import { i as RouteSchema, n as HandlerContextWithExtra, t as HandlerContext } from "./schema-B6DFN5c2.mjs";
 
 //#region src/utils/create-handler.d.ts
 /**
@@ -84,4 +84,4 @@ declare function simpleHandler<R>(handler: (ctx: {
 }) => R | Promise<R>): (req: Request) => Promise<Response>;
 //#endregion
 export { simpleHandler as i, createHandler as n, createHandlerWithExtra as r, InferableHandler as t };
-//# sourceMappingURL=create-handler-DRcJRkx9.d.mts.map
+//# sourceMappingURL=create-handler-DKw-sQOV.d.mts.map

package/dist/{create-handler-IzOE24L5.mjs → create-handler-RconAcAB.mjs}

@@ -1,10 +1,9 @@
-import { c as json, s as init_response } from "./middleware-CV5o-4wk.mjs";
-import { a as parseCookies, l as parseHeaders, r as parseBody, u as parseQuery } from "./parsers-BQ63b0YE.mjs";
-import { t as goAwait } from "./go-await-2Pzj4snS.mjs";
-import { a as validateAllSchemas, i as precompileSchemas } from "./validators-WXQ49LcR.mjs";
+import { o as json } from "./middleware-CewKbtb4.mjs";
+import { a as parseCookies, l as parseHeaders, r as parseBody, u as parseQuery } from "./parsers-DpH_mD0H.mjs";
+import { t as goAwait } from "./go-await-C4ZdEUwY.mjs";
+import { a as validateAllSchemas, i as precompileSchemas } from "./validators-DBkyw6BG.mjs";
 
 //#region src/utils/create-handler.ts
-init_response();
 /**
 * 自动响应转换
 * 将各种返回值类型转换为 Response 对象
@@ -163,4 +162,4 @@ function simpleHandler(handler) {
 
 //#endregion
 export { createHandlerWithExtra as n, simpleHandler as r, createHandler as t };
-//# sourceMappingURL=create-handler-IzOE24L5.mjs.map
+//# sourceMappingURL=create-handler-RconAcAB.mjs.map

package/dist/{create-handler-IzOE24L5.mjs.map → create-handler-RconAcAB.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"create-handler-IzOE24L5.mjs","names":[],"sources":["../src/utils/create-handler.ts"],"sourcesContent":["/**\n * 类型安全的路由处理器工厂\n *\n * 非柯里化设计，API 更简洁\n *\n * @author Framework Team\n * @version 3.0.0\n * @license MIT\n */\n\nimport type {\n  RouteSchema,\n  HandlerContext,\n  HandlerContextWithExtra,\n} from \"../types/schema\";\nimport { parseBody, parseQuery, parseHeaders, parseCookies } from \"./parsers\";\nimport { goAwait } from \"./go-await\";\nimport { json } from \"./response\";\nimport {\n  validateAllSchemas,\n  precompileSchemas,\n} from \"./validators/validators\";\n\n/**\n * 自动响应转换\n * 将各种返回值类型转换为 Response 对象\n */\nfunction autoResponse(result: unknown): Response {\n  // 已经是 Response\n  if (result instanceof Response) {\n    return result;\n  }\n\n  // null/undefined -> 204\n  if (result === null || result === undefined) {\n    return new Response(null, { status: 204 });\n  }\n\n  // 字符串 -> text/plain\n  if (typeof result === \"string\") {\n    return new Response(result, {\n      headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n    });\n  }\n\n  // 数字/布尔 -> text/plain\n  if (typeof result === \"number\" || typeof result === \"boolean\") {\n    return new Response(String(result), {\n      headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n    });\n  }\n\n  // 对象 -> 检查是否是 { data, status, headers } 格式\n  if (typeof result === \"object\") {\n    const obj = result as Record<string, unknown>;\n    if (\"data\" in obj && (\"status\" in obj || \"headers\" in obj)) {\n      const { data, status = 200, headers = {} } = obj;\n\n      if (data === null || data === undefined) {\n        return new Response(null, {\n          status: status === 200 ? 204 : (status as number),\n          headers: headers as HeadersInit,\n        });\n      }\n\n      if (\n        typeof data === \"string\" ||\n        typeof data === \"number\" ||\n        typeof data === \"boolean\"\n      ) {\n        return new Response(String(data), {\n          status: status as number,\n          headers: {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n            ...(headers as Record<string, string>),\n          },\n        });\n      }\n\n      return json(data, status as number, headers as Record<string, string>);\n    }\n\n    // 普通对象 -> JSON\n    return json(result);\n  }\n\n  // 其他类型 -> 204\n  return new Response(null, { status: 204 });\n}\n\n/**\n * 处理验证错误\n */\nfunction handleValidationError(error: Error): Response {\n  return json(\n    {\n      success: false,\n      error: \"Validation Error\",\n      message: error.message,\n      timestamp: new Date().toISOString(),\n    },\n    400,\n  );\n}\n\n/**\n * 处理内部错误\n */\nfunction handleInternalError(error: unknown): Response {\n  return json(\n    {\n      success: false,\n      error: \"Internal Error\",\n      message: error instanceof Error ? error.message : \"未知错误\",\n    },\n    500,\n  );\n}\n\n/** 空 schema 的上下文类型 */\ntype EmptySchemaContext = {\n  req: Request;\n  body: unknown;\n  query: Record<string, string>;\n  params: Record<string, string>;\n  headers: Record<string, string>;\n  cookies: Record<string, string>;\n};\n\n/**\n * 判断是否为 handler 函数\n */\nfunction isHandler(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === \"function\";\n}\n\n/**\n * 创建类型安全的路由处理器\n *\n * @example\n * ```typescript\n * // 无 schema - 直接传入 handler\n * createHandler(({ params }) => `User: ${params.id}`)\n *\n * // 有 schema - 传入 schema 和 handler\n * createHandler(\n *   { body: Type.Object({ name: Type.String() }) },\n *   ({ body }) => ({ hello: body.name })\n * )\n * ```\n */\n/**\n * 带类型推断的 Handler - 保留返回类型信息用于客户端类型推断\n */\nexport type InferableHandler<TReturn, TSchema extends RouteSchema = RouteSchema> = ((req: Request) => Promise<Response>) & {\n  /** 返回类型标记（仅用于类型推断，运行时不存在） */\n  __returnType: TReturn;\n  /** Schema 类型标记 */\n  __schema: TSchema;\n};\n\n\n// 重载 1: 无 schema\nexport function createHandler<R>(\n  handler: (ctx: EmptySchemaContext) => R | Promise<R>,\n): InferableHandler<R>;\n\n// 重载 2: 有 schema\nexport function createHandler<const T extends RouteSchema, R>(\n  schema: T,\n  handler: (ctx: HandlerContext<T>) => R | Promise<R>,\n): InferableHandler<R, T>;\n\n// 实现\nexport function createHandler<const T extends RouteSchema, R>(\n  schemaOrHandler: T | ((ctx: EmptySchemaContext) => R | Promise<R>),\n  maybeHandler?: (ctx: HandlerContext<T>) => R | Promise<R>,\n): InferableHandler<R, T> {\n  // 判断调用方式\n  const hasSchema = !isHandler(schemaOrHandler);\n  const schema = hasSchema ? (schemaOrHandler as T) : ({} as T);\n  const handler = hasSchema\n    ? maybeHandler!\n    : (schemaOrHandler as (ctx: HandlerContext<T>) => R | Promise<R>);\n\n  // 预编译 schema\n  if (\n    schema.body ||\n    schema.query ||\n    schema.params ||\n    schema.headers ||\n    schema.cookies\n  ) {\n    precompileSchemas(schema);\n  }\n\n  const handlerFn = async (req: Request): Promise<Response> => {\n    try {\n      // 解析请求数据\n      const query = parseQuery(req);\n      const headers = parseHeaders(req);\n      const cookies = parseCookies(req);\n      const params =\n        ((req as unknown as Record<string, unknown>).params as Record<\n          string,\n          string\n        >) || {};\n\n      // 解析请求体\n      let body: unknown = undefined;\n      if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n        const [, parsedBody] = await goAwait(parseBody(req));\n        body = parsedBody;\n      }\n\n      // 验证 schema\n      const data = { body, query, params, headers, cookies };\n      if (\n        schema.body ||\n        schema.query ||\n        schema.params ||\n        schema.headers ||\n        schema.cookies\n      ) {\n        validateAllSchemas(schema, data);\n      }\n\n      // 调用 handler\n      const result = await handler({\n        req,\n        body: body as HandlerContext<T>[\"body\"],\n        query: query as HandlerContext<T>[\"query\"],\n        params: params as HandlerContext<T>[\"params\"],\n        headers: headers as HandlerContext<T>[\"headers\"],\n        cookies: cookies as HandlerContext<T>[\"cookies\"],\n      });\n\n      return autoResponse(result);\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"验证失败\")) {\n        return handleValidationError(error);\n      }\n      return handleInternalError(error);\n    }\n  };\n\n  // 类型断言：这些属性只在编译时用于类型推断，运行时不存在\n  return handlerFn as InferableHandler<R, T>;\n}\n\n/**\n * 创建带额外上下文的路由处理器\n *\n * 用于中间件注入额外数据的场景\n *\n * @example\n * ```typescript\n * // 定义中间件注入的类型\n * type AuthContext = { user: { id: string; role: string } };\n *\n * // 无 schema\n * createHandlerWithExtra<AuthContext>(({ user }) => {\n *   return { userId: user.id };\n * })\n *\n * // 有 schema\n * createHandlerWithExtra<AuthContext>(\n *   { body: Type.Object({ action: Type.String() }) },\n *   ({ body, user }) => ({ success: true, userId: user.id })\n * )\n * ```\n */\n// 重载 1: 无 schema\nexport function createHandlerWithExtra<\n  TExtra extends Record<string, unknown> = Record<string, never>,\n  R = unknown,\n>(\n  handler: (ctx: EmptySchemaContext & TExtra) => R | Promise<R>,\n): (req: Request) => Promise<Response>;\n\n// 重载 2: 有 schema\nexport function createHandlerWithExtra<\n  TExtra extends Record<string, unknown> = Record<string, never>,\n  const T extends RouteSchema = RouteSchema,\n  R = unknown,\n>(\n  schema: T,\n  handler: (ctx: HandlerContextWithExtra<T, TExtra>) => R | Promise<R>,\n): (req: Request) => Promise<Response>;\n\n// 实现\nexport function createHandlerWithExtra<\n  TExtra extends Record<string, unknown> = Record<string, never>,\n  const T extends RouteSchema = RouteSchema,\n  R = unknown,\n>(\n  schemaOrHandler: T | ((ctx: EmptySchemaContext & TExtra) => R | Promise<R>),\n  maybeHandler?: (ctx: HandlerContextWithExtra<T, TExtra>) => R | Promise<R>,\n): (req: Request) => Promise<Response> {\n  // 判断调用方式\n  const hasSchema = !isHandler(schemaOrHandler);\n  const schema = hasSchema ? (schemaOrHandler as T) : ({} as T);\n  const handler = hasSchema\n    ? maybeHandler!\n    : (schemaOrHandler as (\n        ctx: HandlerContextWithExtra<T, TExtra>,\n      ) => R | Promise<R>);\n\n  // 预编译 schema\n  if (\n    schema.body ||\n    schema.query ||\n    schema.params ||\n    schema.headers ||\n    schema.cookies\n  ) {\n    precompileSchemas(schema);\n  }\n\n  return async (req: Request): Promise<Response> => {\n    try {\n      // 解析请求数据\n      const query = parseQuery(req);\n      const headers = parseHeaders(req);\n      const cookies = parseCookies(req);\n      const params =\n        ((req as unknown as Record<string, unknown>).params as Record<\n          string,\n          string\n        >) || {};\n\n      // 解析请求体\n      let body: unknown = undefined;\n      if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n        const [, parsedBody] = await goAwait(parseBody(req));\n        body = parsedBody;\n      }\n\n      // 验证 schema\n      const data = { body, query, params, headers, cookies };\n      if (\n        schema.body ||\n        schema.query ||\n        schema.params ||\n        schema.headers ||\n        schema.cookies\n      ) {\n        validateAllSchemas(schema, data);\n      }\n\n      // 获取中间件注入的额外数据\n      const extras = ((req as unknown as Record<string, unknown>).__locals ??\n        {}) as TExtra;\n\n      // 调用 handler\n      const result = await handler({\n        req,\n        body: body as HandlerContext<T>[\"body\"],\n        query: query as HandlerContext<T>[\"query\"],\n        params: params as HandlerContext<T>[\"params\"],\n        headers: headers as HandlerContext<T>[\"headers\"],\n        cookies: cookies as HandlerContext<T>[\"cookies\"],\n        ...extras,\n      } as HandlerContextWithExtra<T, TExtra>);\n\n      return autoResponse(result);\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"验证失败\")) {\n        return handleValidationError(error);\n      }\n      return handleInternalError(error);\n    }\n  };\n}\n\n/**\n * 简单的路由处理器 (无 schema 验证，只有 req)\n *\n * @example\n * ```typescript\n * simpleHandler(({ req }) => {\n *   return { message: \"Hello World\" };\n * })\n * ```\n */\nexport function simpleHandler<R>(\n  handler: (ctx: { req: Request }) => R | Promise<R>,\n): (req: Request) => Promise<Response> {\n  return async (req: Request): Promise<Response> => {\n    try {\n      const result = await handler({ req });\n      return autoResponse(result);\n    } catch (error) {\n      return handleInternalError(error);\n    }\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-handler-RconAcAB.mjs","names":[],"sources":["../src/utils/create-handler.ts"],"sourcesContent":["/**\n * 类型安全的路由处理器工厂\n *\n * 非柯里化设计，API 更简洁\n *\n * @author Framework Team\n * @version 3.0.0\n * @license MIT\n */\n\nimport type {\n  RouteSchema,\n  HandlerContext,\n  HandlerContextWithExtra,\n} from \"../types/schema\";\nimport { parseBody, parseQuery, parseHeaders, parseCookies } from \"./parsers\";\nimport { goAwait } from \"./go-await\";\nimport { json } from \"./response\";\nimport {\n  validateAllSchemas,\n  precompileSchemas,\n} from \"./validators/validators\";\n\n/**\n * 自动响应转换\n * 将各种返回值类型转换为 Response 对象\n */\nfunction autoResponse(result: unknown): Response {\n  // 已经是 Response\n  if (result instanceof Response) {\n    return result;\n  }\n\n  // null/undefined -> 204\n  if (result === null || result === undefined) {\n    return new Response(null, { status: 204 });\n  }\n\n  // 字符串 -> text/plain\n  if (typeof result === \"string\") {\n    return new Response(result, {\n      headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n    });\n  }\n\n  // 数字/布尔 -> text/plain\n  if (typeof result === \"number\" || typeof result === \"boolean\") {\n    return new Response(String(result), {\n      headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n    });\n  }\n\n  // 对象 -> 检查是否是 { data, status, headers } 格式\n  if (typeof result === \"object\") {\n    const obj = result as Record<string, unknown>;\n    if (\"data\" in obj && (\"status\" in obj || \"headers\" in obj)) {\n      const { data, status = 200, headers = {} } = obj;\n\n      if (data === null || data === undefined) {\n        return new Response(null, {\n          status: status === 200 ? 204 : (status as number),\n          headers: headers as HeadersInit,\n        });\n      }\n\n      if (\n        typeof data === \"string\" ||\n        typeof data === \"number\" ||\n        typeof data === \"boolean\"\n      ) {\n        return new Response(String(data), {\n          status: status as number,\n          headers: {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n            ...(headers as Record<string, string>),\n          },\n        });\n      }\n\n      return json(data, status as number, headers as Record<string, string>);\n    }\n\n    // 普通对象 -> JSON\n    return json(result);\n  }\n\n  // 其他类型 -> 204\n  return new Response(null, { status: 204 });\n}\n\n/**\n * 处理验证错误\n */\nfunction handleValidationError(error: Error): Response {\n  return json(\n    {\n      success: false,\n      error: \"Validation Error\",\n      message: error.message,\n      timestamp: new Date().toISOString(),\n    },\n    400,\n  );\n}\n\n/**\n * 处理内部错误\n */\nfunction handleInternalError(error: unknown): Response {\n  return json(\n    {\n      success: false,\n      error: \"Internal Error\",\n      message: error instanceof Error ? error.message : \"未知错误\",\n    },\n    500,\n  );\n}\n\n/** 空 schema 的上下文类型 */\ntype EmptySchemaContext = {\n  req: Request;\n  body: unknown;\n  query: Record<string, string>;\n  params: Record<string, string>;\n  headers: Record<string, string>;\n  cookies: Record<string, string>;\n};\n\n/**\n * 判断是否为 handler 函数\n */\nfunction isHandler(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === \"function\";\n}\n\n/**\n * 创建类型安全的路由处理器\n *\n * @example\n * ```typescript\n * // 无 schema - 直接传入 handler\n * createHandler(({ params }) => `User: ${params.id}`)\n *\n * // 有 schema - 传入 schema 和 handler\n * createHandler(\n *   { body: Type.Object({ name: Type.String() }) },\n *   ({ body }) => ({ hello: body.name })\n * )\n * ```\n */\n/**\n * 带类型推断的 Handler - 保留返回类型信息用于客户端类型推断\n */\nexport type InferableHandler<TReturn, TSchema extends RouteSchema = RouteSchema> = ((req: Request) => Promise<Response>) & {\n  /** 返回类型标记（仅用于类型推断，运行时不存在） */\n  __returnType: TReturn;\n  /** Schema 类型标记 */\n  __schema: TSchema;\n};\n\n\n// 重载 1: 无 schema\nexport function createHandler<R>(\n  handler: (ctx: EmptySchemaContext) => R | Promise<R>,\n): InferableHandler<R>;\n\n// 重载 2: 有 schema\nexport function createHandler<const T extends RouteSchema, R>(\n  schema: T,\n  handler: (ctx: HandlerContext<T>) => R | Promise<R>,\n): InferableHandler<R, T>;\n\n// 实现\nexport function createHandler<const T extends RouteSchema, R>(\n  schemaOrHandler: T | ((ctx: EmptySchemaContext) => R | Promise<R>),\n  maybeHandler?: (ctx: HandlerContext<T>) => R | Promise<R>,\n): InferableHandler<R, T> {\n  // 判断调用方式\n  const hasSchema = !isHandler(schemaOrHandler);\n  const schema = hasSchema ? (schemaOrHandler as T) : ({} as T);\n  const handler = hasSchema\n    ? maybeHandler!\n    : (schemaOrHandler as (ctx: HandlerContext<T>) => R | Promise<R>);\n\n  // 预编译 schema\n  if (\n    schema.body ||\n    schema.query ||\n    schema.params ||\n    schema.headers ||\n    schema.cookies\n  ) {\n    precompileSchemas(schema);\n  }\n\n  const handlerFn = async (req: Request): Promise<Response> => {\n    try {\n      // 解析请求数据\n      const query = parseQuery(req);\n      const headers = parseHeaders(req);\n      const cookies = parseCookies(req);\n      const params =\n        ((req as unknown as Record<string, unknown>).params as Record<\n          string,\n          string\n        >) || {};\n\n      // 解析请求体\n      let body: unknown = undefined;\n      if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n        const [, parsedBody] = await goAwait(parseBody(req));\n        body = parsedBody;\n      }\n\n      // 验证 schema\n      const data = { body, query, params, headers, cookies };\n      if (\n        schema.body ||\n        schema.query ||\n        schema.params ||\n        schema.headers ||\n        schema.cookies\n      ) {\n        validateAllSchemas(schema, data);\n      }\n\n      // 调用 handler\n      const result = await handler({\n        req,\n        body: body as HandlerContext<T>[\"body\"],\n        query: query as HandlerContext<T>[\"query\"],\n        params: params as HandlerContext<T>[\"params\"],\n        headers: headers as HandlerContext<T>[\"headers\"],\n        cookies: cookies as HandlerContext<T>[\"cookies\"],\n      });\n\n      return autoResponse(result);\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"验证失败\")) {\n        return handleValidationError(error);\n      }\n      return handleInternalError(error);\n    }\n  };\n\n  // 类型断言：这些属性只在编译时用于类型推断，运行时不存在\n  return handlerFn as InferableHandler<R, T>;\n}\n\n/**\n * 创建带额外上下文的路由处理器\n *\n * 用于中间件注入额外数据的场景\n *\n * @example\n * ```typescript\n * // 定义中间件注入的类型\n * type AuthContext = { user: { id: string; role: string } };\n *\n * // 无 schema\n * createHandlerWithExtra<AuthContext>(({ user }) => {\n *   return { userId: user.id };\n * })\n *\n * // 有 schema\n * createHandlerWithExtra<AuthContext>(\n *   { body: Type.Object({ action: Type.String() }) },\n *   ({ body, user }) => ({ success: true, userId: user.id })\n * )\n * ```\n */\n// 重载 1: 无 schema\nexport function createHandlerWithExtra<\n  TExtra extends Record<string, unknown> = Record<string, never>,\n  R = unknown,\n>(\n  handler: (ctx: EmptySchemaContext & TExtra) => R | Promise<R>,\n): (req: Request) => Promise<Response>;\n\n// 重载 2: 有 schema\nexport function createHandlerWithExtra<\n  TExtra extends Record<string, unknown> = Record<string, never>,\n  const T extends RouteSchema = RouteSchema,\n  R = unknown,\n>(\n  schema: T,\n  handler: (ctx: HandlerContextWithExtra<T, TExtra>) => R | Promise<R>,\n): (req: Request) => Promise<Response>;\n\n// 实现\nexport function createHandlerWithExtra<\n  TExtra extends Record<string, unknown> = Record<string, never>,\n  const T extends RouteSchema = RouteSchema,\n  R = unknown,\n>(\n  schemaOrHandler: T | ((ctx: EmptySchemaContext & TExtra) => R | Promise<R>),\n  maybeHandler?: (ctx: HandlerContextWithExtra<T, TExtra>) => R | Promise<R>,\n): (req: Request) => Promise<Response> {\n  // 判断调用方式\n  const hasSchema = !isHandler(schemaOrHandler);\n  const schema = hasSchema ? (schemaOrHandler as T) : ({} as T);\n  const handler = hasSchema\n    ? maybeHandler!\n    : (schemaOrHandler as (\n        ctx: HandlerContextWithExtra<T, TExtra>,\n      ) => R | Promise<R>);\n\n  // 预编译 schema\n  if (\n    schema.body ||\n    schema.query ||\n    schema.params ||\n    schema.headers ||\n    schema.cookies\n  ) {\n    precompileSchemas(schema);\n  }\n\n  return async (req: Request): Promise<Response> => {\n    try {\n      // 解析请求数据\n      const query = parseQuery(req);\n      const headers = parseHeaders(req);\n      const cookies = parseCookies(req);\n      const params =\n        ((req as unknown as Record<string, unknown>).params as Record<\n          string,\n          string\n        >) || {};\n\n      // 解析请求体\n      let body: unknown = undefined;\n      if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n        const [, parsedBody] = await goAwait(parseBody(req));\n        body = parsedBody;\n      }\n\n      // 验证 schema\n      const data = { body, query, params, headers, cookies };\n      if (\n        schema.body ||\n        schema.query ||\n        schema.params ||\n        schema.headers ||\n        schema.cookies\n      ) {\n        validateAllSchemas(schema, data);\n      }\n\n      // 获取中间件注入的额外数据\n      const extras = ((req as unknown as Record<string, unknown>).__locals ??\n        {}) as TExtra;\n\n      // 调用 handler\n      const result = await handler({\n        req,\n        body: body as HandlerContext<T>[\"body\"],\n        query: query as HandlerContext<T>[\"query\"],\n        params: params as HandlerContext<T>[\"params\"],\n        headers: headers as HandlerContext<T>[\"headers\"],\n        cookies: cookies as HandlerContext<T>[\"cookies\"],\n        ...extras,\n      } as HandlerContextWithExtra<T, TExtra>);\n\n      return autoResponse(result);\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"验证失败\")) {\n        return handleValidationError(error);\n      }\n      return handleInternalError(error);\n    }\n  };\n}\n\n/**\n * 简单的路由处理器 (无 schema 验证，只有 req)\n *\n * @example\n * ```typescript\n * simpleHandler(({ req }) => {\n *   return { message: \"Hello World\" };\n * })\n * ```\n */\nexport function simpleHandler<R>(\n  handler: (ctx: { req: Request }) => R | Promise<R>,\n): (req: Request) => Promise<Response> {\n  return async (req: Request): Promise<Response> => {\n    try {\n      const result = await handler({ req });\n      return autoResponse(result);\n    } catch (error) {\n      return handleInternalError(error);\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/defineRoute.d.mts

@@ -1,6 +1,6 @@
-import { i as RouteSchema } from "./schema-DOKg31ZX.mjs";
-import "./index-CTHojwxd.mjs";
-import { t as InferableHandler } from "./create-handler-DRcJRkx9.mjs";
+import { i as RouteSchema } from "./schema-B6DFN5c2.mjs";
+import "./index-CREkvfw9.mjs";
+import { t as InferableHandler } from "./create-handler-DKw-sQOV.mjs";
 
 //#region src/defineRoute.d.ts