vafast 0.4.2 → 0.4.4

package/dist/create-handler-B_pfxh3m.mjs

@@ -0,0 +1,166 @@
+import { i as json, r as init_response } from "./response-DXg4i_yh.mjs";
+import { a as parseCookies, l as parseHeaders, r as parseBody, u as parseQuery } from "./parsers-CI_TZ7pO.mjs";
+import { t as goAwait } from "./go-await-BGAGJfrB.mjs";
+import { a as validateAllSchemas, i as precompileSchemas } from "./validators-BBrGePBr.mjs";
+
+//#region src/utils/create-handler.ts
+init_response();
+/**
+* 自动响应转换
+* 将各种返回值类型转换为 Response 对象
+*/
+function autoResponse(result) {
+	if (result instanceof Response) return result;
+	if (result === null || result === void 0) return new Response(null, { status: 204 });
+	if (typeof result === "string") return new Response(result, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+	if (typeof result === "number" || typeof result === "boolean") return new Response(String(result), { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+	if (typeof result === "object") {
+		const obj = result;
+		if ("data" in obj && ("status" in obj || "headers" in obj)) {
+			const { data, status = 200, headers = {} } = obj;
+			if (data === null || data === void 0) return new Response(null, {
+				status: status === 200 ? 204 : status,
+				headers
+			});
+			if (typeof data === "string" || typeof data === "number" || typeof data === "boolean") return new Response(String(data), {
+				status,
+				headers: {
+					"Content-Type": "text/plain; charset=utf-8",
+					...headers
+				}
+			});
+			return json(data, status, headers);
+		}
+		return json(result);
+	}
+	return new Response(null, { status: 204 });
+}
+/**
+* 处理验证错误
+*/
+function handleValidationError(error) {
+	return json({
+		success: false,
+		error: "Validation Error",
+		message: error.message,
+		timestamp: (/* @__PURE__ */ new Date()).toISOString()
+	}, 400);
+}
+/**
+* 处理内部错误
+*/
+function handleInternalError(error) {
+	return json({
+		success: false,
+		error: "Internal Error",
+		message: error instanceof Error ? error.message : "未知错误"
+	}, 500);
+}
+/**
+* 判断是否为 handler 函数
+*/
+function isHandler(value) {
+	return typeof value === "function";
+}
+function createHandler(schemaOrHandler, maybeHandler) {
+	const hasSchema = !isHandler(schemaOrHandler);
+	const schema = hasSchema ? schemaOrHandler : {};
+	const handler = hasSchema ? maybeHandler : schemaOrHandler;
+	if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) precompileSchemas(schema);
+	const handlerFn = async (req) => {
+		try {
+			const query = parseQuery(req);
+			const headers = parseHeaders(req);
+			const cookies = parseCookies(req);
+			const params = req.params || {};
+			let body = void 0;
+			if (req.method !== "GET" && req.method !== "HEAD") {
+				const [, parsedBody] = await goAwait(parseBody(req));
+				body = parsedBody;
+			}
+			const data = {
+				body,
+				query,
+				params,
+				headers,
+				cookies
+			};
+			if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) validateAllSchemas(schema, data);
+			return autoResponse(await handler({
+				req,
+				body,
+				query,
+				params,
+				headers,
+				cookies
+			}));
+		} catch (error) {
+			if (error instanceof Error && error.message.includes("验证失败")) return handleValidationError(error);
+			return handleInternalError(error);
+		}
+	};
+	return handlerFn;
+}
+function createHandlerWithExtra(schemaOrHandler, maybeHandler) {
+	const hasSchema = !isHandler(schemaOrHandler);
+	const schema = hasSchema ? schemaOrHandler : {};
+	const handler = hasSchema ? maybeHandler : schemaOrHandler;
+	if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) precompileSchemas(schema);
+	return async (req) => {
+		try {
+			const query = parseQuery(req);
+			const headers = parseHeaders(req);
+			const cookies = parseCookies(req);
+			const params = req.params || {};
+			let body = void 0;
+			if (req.method !== "GET" && req.method !== "HEAD") {
+				const [, parsedBody] = await goAwait(parseBody(req));
+				body = parsedBody;
+			}
+			const data = {
+				body,
+				query,
+				params,
+				headers,
+				cookies
+			};
+			if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) validateAllSchemas(schema, data);
+			const extras = req.__locals ?? {};
+			return autoResponse(await handler({
+				req,
+				body,
+				query,
+				params,
+				headers,
+				cookies,
+				...extras
+			}));
+		} catch (error) {
+			if (error instanceof Error && error.message.includes("验证失败")) return handleValidationError(error);
+			return handleInternalError(error);
+		}
+	};
+}
+/**
+* 简单的路由处理器 (无 schema 验证，只有 req)
+*
+* @example
+* ```typescript
+* simpleHandler(({ req }) => {
+*   return { message: "Hello World" };
+* })
+* ```
+*/
+function simpleHandler(handler) {
+	return async (req) => {
+		try {
+			return autoResponse(await handler({ req }));
+		} catch (error) {
+			return handleInternalError(error);
+		}
+	};
+}
+
+//#endregion
+export { createHandlerWithExtra as n, simpleHandler as r, createHandler as t };
+//# sourceMappingURL=create-handler-B_pfxh3m.mjs.map

package/dist/create-handler-B_pfxh3m.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-handler-B_pfxh3m.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/{utils/create-handler.d.ts → create-handler-Bo-hvWp-.d.mts}

@@ -1,24 +1,23 @@
-import { RouteSchema, HandlerContext, HandlerContextWithExtra } from '../types/schema.js';
-import '@sinclair/typebox';
+import { i as RouteSchema, n as HandlerContextWithExtra, t as HandlerContext } from "./schema-CPQudJpE.mjs";
 
+//#region src/utils/create-handler.d.ts
 /**
- * 类型安全的路由处理器工厂
- *
- * 非柯里化设计，API 更简洁
- *
- * @author Framework Team
- * @version 3.0.0
- * @license MIT
- */
-
+* 类型安全的路由处理器工厂
+*
+* 非柯里化设计，API 更简洁
+*
+* @author Framework Team
+* @version 3.0.0
+* @license MIT
+*/
 /** 空 schema 的上下文类型 */
 type EmptySchemaContext = {
-    req: Request;
-    body: unknown;
-    query: Record<string, string>;
-    params: Record<string, string>;
-    headers: Record<string, string>;
-    cookies: Record<string, string>;
+  req: Request;
+  body: unknown;
+  query: Record<string, string>;
+  params: Record<string, string>;
+  headers: Record<string, string>;
+  cookies: Record<string, string>;
 };
 /**
  * 创建类型安全的路由处理器
@@ -39,10 +38,10 @@ type EmptySchemaContext = {
  * 带类型推断的 Handler - 保留返回类型信息用于客户端类型推断
  */
 type InferableHandler<TReturn, TSchema extends RouteSchema = RouteSchema> = ((req: Request) => Promise<Response>) & {
-    /** 返回类型标记（仅用于类型推断，运行时不存在） */
-    __returnType: TReturn;
-    /** Schema 类型标记 */
-    __schema: TSchema;
+  /** 返回类型标记（仅用于类型推断，运行时不存在） */
+  __returnType: TReturn;
+  /** Schema 类型标记 */
+  __schema: TSchema;
 };
 declare function createHandler<R>(handler: (ctx: EmptySchemaContext) => R | Promise<R>): InferableHandler<R>;
 declare function createHandler<const T extends RouteSchema, R>(schema: T, handler: (ctx: HandlerContext<T>) => R | Promise<R>): InferableHandler<R, T>;
@@ -81,7 +80,8 @@ declare function createHandlerWithExtra<TExtra extends Record<string, unknown> =
  * ```
  */
 declare function simpleHandler<R>(handler: (ctx: {
-    req: Request;
+  req: Request;
 }) => R | Promise<R>): (req: Request) => Promise<Response>;
-
-export { type InferableHandler, createHandler, createHandlerWithExtra, simpleHandler };
+//#endregion
+export { simpleHandler as i, createHandler as n, createHandlerWithExtra as r, InferableHandler as t };
+//# sourceMappingURL=create-handler-Bo-hvWp-.d.mts.map

package/dist/{defineRoute.d.ts → defineRoute.d.mts}

@@ -1,16 +1,18 @@
-import { RouteSchema } from './types/schema.js';
-import { InferableHandler } from './utils/create-handler.js';
-import '@sinclair/typebox';
+import { i as RouteSchema } from "./schema-CPQudJpE.mjs";
+import "./index-CzItj62a.mjs";
+import { t as InferableHandler } from "./create-handler-Bo-hvWp-.mjs";
+
+//#region src/defineRoute.d.ts
 
 /**
  * 可推断的路由类型（用于类型推断）
  * 供 vafast-api-client 使用，保留完整的类型信息
  */
 type InferableRoute<TMethod extends string = string, TPath extends string = string, TReturn = unknown, TSchema extends RouteSchema = RouteSchema> = {
-    readonly method: TMethod;
-    readonly path: TPath;
-    readonly handler: InferableHandler<TReturn, TSchema>;
-    readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;
+  readonly method: TMethod;
+  readonly path: TPath;
+  readonly handler: InferableHandler<TReturn, TSchema>;
+  readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;
 };
 /**
  * 中间件类型
@@ -20,10 +22,10 @@ type Middleware = (req: Request, next: () => Promise<Response>) => Promise<Respo
  * 路由定义类型（保留完整 handler 类型）
  */
 type RouteDefinition<TMethod extends string = string, TPath extends string = string, THandler = unknown> = {
-    readonly method: TMethod;
-    readonly path: TPath;
-    readonly handler: THandler;
-    readonly middleware?: ReadonlyArray<Middleware>;
+  readonly method: TMethod;
+  readonly path: TPath;
+  readonly handler: THandler;
+  readonly middleware?: ReadonlyArray<Middleware>;
 };
 /**
  * 创建单个路由定义（自动保留字面量类型，无需 as const）
@@ -94,10 +96,11 @@ declare function patch<TPath extends string, THandler>(path: TPath, handler: THa
  * ```
  */
 declare function defineRoutes<const T extends readonly {
-    readonly method: string;
-    readonly path: string;
-    readonly handler: unknown;
-    readonly middleware?: ReadonlyArray<Middleware>;
+  readonly method: string;
+  readonly path: string;
+  readonly handler: unknown;
+  readonly middleware?: ReadonlyArray<Middleware>;
 }[]>(routes: T): T;
-
-export { type InferableRoute, type RouteDefinition, defineRoutes, del, get, patch, post, put, route };
+//#endregion
+export { InferableRoute, RouteDefinition, defineRoutes, del, get, patch, post, put, route };
+//# sourceMappingURL=defineRoute.d.mts.map

package/dist/defineRoute.mjs

@@ -0,0 +1,93 @@
+//#region src/defineRoute.ts
+/**
+* 创建单个路由定义（自动保留字面量类型，无需 as const）
+* 
+* @example
+* ```typescript
+* import { route, defineRoutes, createHandler, Type } from 'vafast'
+* 
+* const routes = defineRoutes([
+*   route('GET', '/users', createHandler(
+*     { query: Type.Object({ page: Type.Number() }) },
+*     async ({ query }) => ({ users: [], total: 0 })
+*   )),
+*   route('POST', '/users', createHandler(
+*     { body: Type.Object({ name: Type.String() }) },
+*     async ({ body }) => ({ id: '1', name: body.name })
+*   )),
+*   route('GET', '/users/:id', createHandler(
+*     { params: Type.Object({ id: Type.String() }) },
+*     async ({ params }) => ({ id: params.id, name: 'User' })
+*   ))
+* ])
+* 
+* // 无需 as const！类型自动推断
+* type Api = InferEden<typeof routes>
+* ```
+*/
+function route(method, path, handler, middleware) {
+	return {
+		method,
+		path,
+		handler,
+		middleware
+	};
+}
+/**
+* GET 路由快捷方法
+*/
+function get(path, handler, middleware) {
+	return route("GET", path, handler, middleware);
+}
+/**
+* POST 路由快捷方法
+*/
+function post(path, handler, middleware) {
+	return route("POST", path, handler, middleware);
+}
+/**
+* PUT 路由快捷方法
+*/
+function put(path, handler, middleware) {
+	return route("PUT", path, handler, middleware);
+}
+/**
+* DELETE 路由快捷方法
+*/
+function del(path, handler, middleware) {
+	return route("DELETE", path, handler, middleware);
+}
+/**
+* PATCH 路由快捷方法
+*/
+function patch(path, handler, middleware) {
+	return route("PATCH", path, handler, middleware);
+}
+/**
+* 定义路由数组（保留完整类型信息）
+* 
+* 推荐配合 route() 函数使用，无需 as const
+* 
+* @example
+* ```typescript
+* import { defineRoutes, route, createHandler, Type } from 'vafast'
+* 
+* // ✨ 新方式：使用 route() 函数，无需 as const
+* const routes = defineRoutes([
+*   route('GET', '/users', createHandler(...)),
+*   route('POST', '/users', createHandler(...))
+* ])
+* 
+* // 🔙 旧方式：需要 as const（仍然支持）
+* const routes = defineRoutes([
+*   { method: 'GET', path: '/users', handler: createHandler(...) }
+* ] as const)
+* ```
+*/
+function defineRoutes(routes) {
+	return routes;
+}
+
+//#endregion
+export { defineRoutes, del, get, patch, post, put, route };
+//# sourceMappingURL=defineRoute.mjs.map

package/dist/defineRoute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineRoute.mjs","names":[],"sources":["../src/defineRoute.ts"],"sourcesContent":["import type { RouteSchema } from \"./types\";\nimport type { InferableHandler } from \"./utils/create-handler\";\n\n/**\n * 可推断的路由类型（用于类型推断）\n * 供 vafast-api-client 使用，保留完整的类型信息\n */\nexport type InferableRoute<\n  TMethod extends string = string,\n  TPath extends string = string,\n  TReturn = unknown,\n  TSchema extends RouteSchema = RouteSchema\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: InferableHandler<TReturn, TSchema>;\n  readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;\n}\n\n/**\n * 中间件类型\n */\ntype Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;\n\n/**\n * 路由定义类型（保留完整 handler 类型）\n */\nexport type RouteDefinition<\n  TMethod extends string = string,\n  TPath extends string = string,\n  THandler = unknown\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: THandler;\n  readonly middleware?: ReadonlyArray<Middleware>;\n}\n\n/**\n * 创建单个路由定义（自动保留字面量类型，无需 as const）\n * \n * @example\n * ```typescript\n * import { route, defineRoutes, createHandler, Type } from 'vafast'\n * \n * const routes = defineRoutes([\n *   route('GET', '/users', createHandler(\n *     { query: Type.Object({ page: Type.Number() }) },\n *     async ({ query }) => ({ users: [], total: 0 })\n *   )),\n *   route('POST', '/users', createHandler(\n *     { body: Type.Object({ name: Type.String() }) },\n *     async ({ body }) => ({ id: '1', name: body.name })\n *   )),\n *   route('GET', '/users/:id', createHandler(\n *     { params: Type.Object({ id: Type.String() }) },\n *     async ({ params }) => ({ id: params.id, name: 'User' })\n *   ))\n * ])\n * \n * // 无需 as const！类型自动推断\n * type Api = InferEden<typeof routes>\n * ```\n */\nexport function route<\n  TMethod extends string,\n  TPath extends string,\n  THandler\n>(\n  method: TMethod,\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<TMethod, TPath, THandler> {\n  return {\n    method,\n    path,\n    handler,\n    middleware\n  };\n}\n\n/**\n * GET 路由快捷方法\n */\nexport function get<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'GET', TPath, THandler> {\n  return route('GET', path, handler, middleware);\n}\n\n/**\n * POST 路由快捷方法\n */\nexport function post<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'POST', TPath, THandler> {\n  return route('POST', path, handler, middleware);\n}\n\n/**\n * PUT 路由快捷方法\n */\nexport function put<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'PUT', TPath, THandler> {\n  return route('PUT', path, handler, middleware);\n}\n\n/**\n * DELETE 路由快捷方法\n */\nexport function del<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'DELETE', TPath, THandler> {\n  return route('DELETE', path, handler, middleware);\n}\n\n/**\n * PATCH 路由快捷方法\n */\nexport function patch<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'PATCH', TPath, THandler> {\n  return route('PATCH', path, handler, middleware);\n}\n\n/**\n * 定义路由数组（保留完整类型信息）\n * \n * 推荐配合 route() 函数使用，无需 as const\n * \n * @example\n * ```typescript\n * import { defineRoutes, route, createHandler, Type } from 'vafast'\n * \n * // ✨ 新方式：使用 route() 函数，无需 as const\n * const routes = defineRoutes([\n *   route('GET', '/users', createHandler(...)),\n *   route('POST', '/users', createHandler(...))\n * ])\n * \n * // 🔙 旧方式：需要 as const（仍然支持）\n * const routes = defineRoutes([\n *   { method: 'GET', path: '/users', handler: createHandler(...) }\n * ] as const)\n * ```\n */\nexport function defineRoutes<\n  const T extends readonly {\n    readonly method: string\n    readonly path: string\n    readonly handler: unknown\n    readonly middleware?: ReadonlyArray<Middleware>\n  }[]\n>(routes: T): T {\n  return routes;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,SAAgB,MAKd,QACA,MACA,SACA,YAC2C;AAC3C,QAAO;EACL;EACA;EACA;EACA;EACD;;;;;AAMH,SAAgB,IACd,MACA,SACA,YACyC;AACzC,QAAO,MAAM,OAAO,MAAM,SAAS,WAAW;;;;;AAMhD,SAAgB,KACd,MACA,SACA,YAC0C;AAC1C,QAAO,MAAM,QAAQ,MAAM,SAAS,WAAW;;;;;AAMjD,SAAgB,IACd,MACA,SACA,YACyC;AACzC,QAAO,MAAM,OAAO,MAAM,SAAS,WAAW;;;;;AAMhD,SAAgB,IACd,MACA,SACA,YAC4C;AAC5C,QAAO,MAAM,UAAU,MAAM,SAAS,WAAW;;;;;AAMnD,SAAgB,MACd,MACA,SACA,YAC2C;AAC3C,QAAO,MAAM,SAAS,MAAM,SAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;AAwBlD,SAAgB,aAOd,QAAc;AACd,QAAO"}

package/dist/dependency-manager-C6vFWP2L.d.mts

@@ -0,0 +1,27 @@
+//#region src/utils/dependency-manager.d.ts
+/**
+ * 依赖管理器
+ * 负责按需加载和管理框架依赖
+ */
+declare class DependencyManager {
+  private dependencyCache;
+  /**
+   * 按需获取框架依赖
+   */
+  getFrameworkDeps(framework: "vue" | "react"): Promise<any>;
+  /**
+   * 检测组件类型
+   */
+  detectComponentType(component: any): "vue" | "react";
+  /**
+   * 清除缓存
+   */
+  clearCache(): void;
+  /**
+   * 获取缓存状态
+   */
+  getCacheStatus(): Record<string, boolean>;
+}
+//#endregion
+export { DependencyManager as t };
+//# sourceMappingURL=dependency-manager-C6vFWP2L.d.mts.map

package/dist/dependency-manager-Czg7Po2j.mjs

@@ -0,0 +1,61 @@
+import { t as __esmMin } from "./chunk-DW4-Jl94.mjs";
+
+//#region src/utils/dependency-manager.ts
+var DependencyManager;
+var init_dependency_manager = __esmMin((() => {
+	DependencyManager = class {
+		dependencyCache = /* @__PURE__ */ new Map();
+		/**
+		* 按需获取框架依赖
+		*/
+		async getFrameworkDeps(framework) {
+			if (this.dependencyCache.has(framework)) return this.dependencyCache.get(framework);
+			console.log(`📦 按需加载 ${framework} 依赖...`);
+			try {
+				let deps;
+				switch (framework) {
+					case "vue":
+						deps = await Promise.all([import("vue"), import("@vue/server-renderer")]);
+						break;
+					case "react":
+						deps = await Promise.all([import("react"), import("react-dom/server")]);
+						break;
+					default: throw new Error(`不支持的框架: ${framework}`);
+				}
+				this.dependencyCache.set(framework, deps);
+				console.log(`✅ ${framework} 依赖加载完成`);
+				return deps;
+			} catch (error) {
+				console.error(`❌ ${framework} 依赖加载失败:`, error);
+				throw error;
+			}
+		}
+		/**
+		* 检测组件类型
+		*/
+		detectComponentType(component) {
+			if (component.render && typeof component.render === "function") return "vue";
+			if (component.$$typeof) return "react";
+			return "vue";
+		}
+		/**
+		* 清除缓存
+		*/
+		clearCache() {
+			this.dependencyCache.clear();
+			console.log("🧹 依赖缓存已清除");
+		}
+		/**
+		* 获取缓存状态
+		*/
+		getCacheStatus() {
+			const status = {};
+			for (const [framework] of this.dependencyCache) status[framework] = true;
+			return status;
+		}
+	};
+}));
+
+//#endregion
+export { init_dependency_manager as n, DependencyManager as t };
+//# sourceMappingURL=dependency-manager-Czg7Po2j.mjs.map

package/dist/dependency-manager-Czg7Po2j.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-manager-Czg7Po2j.mjs","names":[],"sources":["../src/utils/dependency-manager.ts"],"sourcesContent":["/**\n * 依赖管理器\n * 负责按需加载和管理框架依赖\n */\nexport class DependencyManager {\n  private dependencyCache = new Map<string, any>();\n\n  /**\n   * 按需获取框架依赖\n   */\n  async getFrameworkDeps(framework: \"vue\" | \"react\") {\n    if (this.dependencyCache.has(framework)) {\n      return this.dependencyCache.get(framework);\n    }\n\n    console.log(`📦 按需加载 ${framework} 依赖...`);\n\n    try {\n      let deps;\n      switch (framework) {\n        case \"vue\":\n          deps = await Promise.all([\n            import(\"vue\"),\n            import(\"@vue/server-renderer\"),\n          ]);\n          break;\n        case \"react\":\n          deps = await Promise.all([\n            import(\"react\"),\n            import(\"react-dom/server\"),\n          ]);\n          break;\n        default:\n          throw new Error(`不支持的框架: ${framework}`);\n      }\n\n      this.dependencyCache.set(framework, deps);\n      console.log(`✅ ${framework} 依赖加载完成`);\n      return deps;\n    } catch (error) {\n      console.error(`❌ ${framework} 依赖加载失败:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * 检测组件类型\n   */\n  detectComponentType(component: any): \"vue\" | \"react\" {\n    // 简单的组件类型检测\n    if (component.render && typeof component.render === \"function\") {\n      return \"vue\";\n    }\n    if (component.$$typeof) {\n      return \"react\";\n    }\n    // 默认使用 Vue\n    return \"vue\";\n  }\n\n  /**\n   * 清除缓存\n   */\n  clearCache(): void {\n    this.dependencyCache.clear();\n    console.log(\"🧹 依赖缓存已清除\");\n  }\n\n  /**\n   * 获取缓存状态\n   */\n  getCacheStatus(): Record<string, boolean> {\n    const status: Record<string, boolean> = {};\n    for (const [framework] of this.dependencyCache) {\n      status[framework] = true;\n    }\n    return status;\n  }\n}\n"],"mappings":";;;;;CAIa,oBAAb,MAA+B;EAC7B,AAAQ,kCAAkB,IAAI,KAAkB;;;;EAKhD,MAAM,iBAAiB,WAA4B;AACjD,OAAI,KAAK,gBAAgB,IAAI,UAAU,CACrC,QAAO,KAAK,gBAAgB,IAAI,UAAU;AAG5C,WAAQ,IAAI,WAAW,UAAU,QAAQ;AAEzC,OAAI;IACF,IAAI;AACJ,YAAQ,WAAR;KACE,KAAK;AACH,aAAO,MAAM,QAAQ,IAAI,CACvB,OAAO,QACP,OAAO,wBACR,CAAC;AACF;KACF,KAAK;AACH,aAAO,MAAM,QAAQ,IAAI,CACvB,OAAO,UACP,OAAO,oBACR,CAAC;AACF;KACF,QACE,OAAM,IAAI,MAAM,WAAW,YAAY;;AAG3C,SAAK,gBAAgB,IAAI,WAAW,KAAK;AACzC,YAAQ,IAAI,KAAK,UAAU,SAAS;AACpC,WAAO;YACA,OAAO;AACd,YAAQ,MAAM,KAAK,UAAU,WAAW,MAAM;AAC9C,UAAM;;;;;;EAOV,oBAAoB,WAAiC;AAEnD,OAAI,UAAU,UAAU,OAAO,UAAU,WAAW,WAClD,QAAO;AAET,OAAI,UAAU,SACZ,QAAO;AAGT,UAAO;;;;;EAMT,aAAmB;AACjB,QAAK,gBAAgB,OAAO;AAC5B,WAAQ,IAAI,aAAa;;;;;EAM3B,iBAA0C;GACxC,MAAM,SAAkC,EAAE;AAC1C,QAAK,MAAM,CAAC,cAAc,KAAK,gBAC7B,QAAO,aAAa;AAEtB,UAAO"}

package/dist/formats-CYLwo9GJ.d.mts

@@ -0,0 +1,42 @@
+//#region src/utils/formats.d.ts
+/**
+ * TypeBox Format 验证器
+ *
+ * 内置常用的 format 验证，对标 Zod 的内置验证
+ * 框架启动时自动注册
+ *
+ * @version 1.0.0
+ */
+/**
+ * 注册所有内置 format 验证器
+ * 框架自动调用，也可手动调用
+ */
+declare function registerFormats(): void;
+/**
+ * 自定义注册 format
+ */
+declare function registerFormat(name: string, validator: (value: string) => boolean): void;
+/**
+ * 检查 format 是否已注册
+ */
+declare function hasFormat(name: string): boolean;
+declare const Patterns: {
+  readonly EMAIL: RegExp;
+  readonly UUID: RegExp;
+  readonly URL: RegExp;
+  readonly IPV4: RegExp;
+  readonly IPV6: RegExp;
+  readonly DATE: RegExp;
+  readonly TIME: RegExp;
+  readonly DATE_TIME: RegExp;
+  readonly PHONE_CN: RegExp;
+  readonly PHONE_E164: RegExp;
+  readonly OBJECTID: RegExp;
+  readonly HEX_COLOR: RegExp;
+  readonly SLUG: RegExp;
+  readonly SEMVER: RegExp;
+  readonly JWT: RegExp;
+};
+//#endregion
+export { registerFormats as i, hasFormat as n, registerFormat as r, Patterns as t };
+//# sourceMappingURL=formats-CYLwo9GJ.d.mts.map

package/dist/go-await-BGAGJfrB.mjs

@@ -0,0 +1,33 @@
+//#region src/utils/go-await.ts
+/**
+* Go 风格的错误处理工具
+* 将 Promise 转换为 [Error | null, T | undefined] 格式
+*
+* @author Framework Team
+* @version 1.0.0
+* @license MIT
+*/
+/**
+* Go 风格的错误处理工具
+* 将 Promise 转换为 [Error | null, T | undefined] 格式
+*
+* @param promise 要处理的 Promise
+* @returns [Error | null, T | undefined] 元组，第一个元素是错误，第二个是结果
+*
+* @example
+* ```typescript
+* const [error, result] = await goAwait(someAsyncFunction());
+* if (error) {
+*   console.error("操作失败:", error);
+* } else {
+*   console.log("操作成功:", result);
+* }
+* ```
+*/
+function goAwait(promise) {
+	return promise.then((data) => [null, data]).catch((err) => [err instanceof Error ? err : new Error(String(err)), void 0]);
+}
+
+//#endregion
+export { goAwait as t };
+//# sourceMappingURL=go-await-BGAGJfrB.mjs.map

package/dist/go-await-BGAGJfrB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-await-BGAGJfrB.mjs","names":[],"sources":["../src/utils/go-await.ts"],"sourcesContent":["/**\n * Go 风格的错误处理工具\n * 将 Promise 转换为 [Error | null, T | undefined] 格式\n *\n * @author Framework Team\n * @version 1.0.0\n * @license MIT\n */\n\n/**\n * Go 风格的错误处理工具\n * 将 Promise 转换为 [Error | null, T | undefined] 格式\n *\n * @param promise 要处理的 Promise\n * @returns [Error | null, T | undefined] 元组，第一个元素是错误，第二个是结果\n *\n * @example\n * ```typescript\n * const [error, result] = await goAwait(someAsyncFunction());\n * if (error) {\n *   console.error(\"操作失败:\", error);\n * } else {\n *   console.log(\"操作成功:\", result);\n * }\n * ```\n */\nexport function goAwait<T>(\n  promise: Promise<T>,\n): Promise<[Error | null, T | undefined]> {\n  return promise\n    .then<[null, T]>((data) => [null, data])\n    .catch<\n      [Error, undefined]\n    >((err) => [err instanceof Error ? err : new Error(String(err)), undefined]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,QACd,SACwC;AACxC,QAAO,QACJ,MAAiB,SAAS,CAAC,MAAM,KAAK,CAAC,CACvC,OAEE,QAAQ,CAAC,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,EAAE,OAAU,CAAC"}

package/dist/{utils/go-await.d.ts → go-await-DRItVwwh.d.mts}

@@ -1,3 +1,4 @@
+//#region src/utils/go-await.d.ts
 /**
  * Go 风格的错误处理工具
  * 将 Promise 转换为 [Error | null, T | undefined] 格式
@@ -24,5 +25,6 @@
  * ```
  */
 declare function goAwait<T>(promise: Promise<T>): Promise<[Error | null, T | undefined]>;
-
-export { goAwait };
+//#endregion
+export { goAwait as t };
+//# sourceMappingURL=go-await-DRItVwwh.d.mts.map

package/dist/handle-Csjtywdc.mjs

@@ -0,0 +1,30 @@
+import { a as parseCookies } from "./parsers-CI_TZ7pO.mjs";
+
+//#region src/utils/handle.ts
+/** 获取单个 Cookie 值 */
+function getCookie(req, key) {
+	return parseCookies(req)[key] || null;
+}
+/** 生成 Set-Cookie 头 */
+function setCookie(key, value, options = {}) {
+	let cookie = `${key}=${encodeURIComponent(value)}`;
+	if (options.path) cookie += `; Path=${options.path}`;
+	if (options.httpOnly) cookie += `; HttpOnly`;
+	if (options.secure) cookie += `; Secure`;
+	if (options.maxAge) cookie += `; Max-Age=${options.maxAge}`;
+	return cookie;
+}
+function setLocals(req, extras) {
+	const target = req;
+	target.__locals = {
+		...target.__locals ?? {},
+		...extras
+	};
+}
+function getLocals(req) {
+	return req.__locals ?? {};
+}
+
+//#endregion
+export { setLocals as i, getLocals as n, setCookie as r, getCookie as t };
+//# sourceMappingURL=handle-Csjtywdc.mjs.map

package/dist/handle-Csjtywdc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-Csjtywdc.mjs","names":[],"sources":["../src/utils/handle.ts"],"sourcesContent":["import { parseCookies } from \"./parsers\";\n\n/** 获取单个 Cookie 值 */\nexport function getCookie(req: Request, key: string): string | null {\n  const cookies = parseCookies(req);\n  return cookies[key] || null;\n}\n\n/** 生成 Set-Cookie 头 */\nexport function setCookie(\n  key: string,\n  value: string,\n  options: {\n    path?: string;\n    httpOnly?: boolean;\n    maxAge?: number;\n    secure?: boolean;\n  } = {},\n): string {\n  let cookie = `${key}=${encodeURIComponent(value)}`;\n\n  if (options.path) cookie += `; Path=${options.path}`;\n  if (options.httpOnly) cookie += `; HttpOnly`;\n  if (options.secure) cookie += `; Secure`;\n  if (options.maxAge) cookie += `; Max-Age=${options.maxAge}`;\n\n  return cookie;\n}\n\n// 提供给中间件写入\"局部上下文\"的工具函数\nexport function setLocals<T extends object>(req: Request, extras: T) {\n  const target = req as unknown as Record<string, unknown>;\n  target.__locals = { ...((target.__locals as object) ?? {}), ...extras };\n}\n\n// 获取中间件注入的局部上下文\nexport function getLocals<T extends object>(req: Request): T {\n  const target = req as unknown as Record<string, unknown>;\n  return (target.__locals ?? {}) as T;\n}\n"],"mappings":";;;;AAGA,SAAgB,UAAU,KAAc,KAA4B;AAElE,QADgB,aAAa,IAAI,CAClB,QAAQ;;;AAIzB,SAAgB,UACd,KACA,OACA,UAKI,EAAE,EACE;CACR,IAAI,SAAS,GAAG,IAAI,GAAG,mBAAmB,MAAM;AAEhD,KAAI,QAAQ,KAAM,WAAU,UAAU,QAAQ;AAC9C,KAAI,QAAQ,SAAU,WAAU;AAChC,KAAI,QAAQ,OAAQ,WAAU;AAC9B,KAAI,QAAQ,OAAQ,WAAU,aAAa,QAAQ;AAEnD,QAAO;;AAIT,SAAgB,UAA4B,KAAc,QAAW;CACnE,MAAM,SAAS;AACf,QAAO,WAAW;EAAE,GAAK,OAAO,YAAuB,EAAE;EAAG,GAAG;EAAQ;;AAIzE,SAAgB,UAA4B,KAAiB;AAE3D,QADe,IACA,YAAY,EAAE"}