validated-handler

用途：为 Next.js App Router 的 API 路由提供可复用的类型安全处理函数，将输入校验与业务逻辑分离。主要能力：根据 query 或 body 来源自动解析请求，使用 Zod 安全解析并返回统一的 400 校验错误（含字段路径与信息），捕获异常返回 500，成功后把类型推断后的 input 传入业务回调；可扩展自定义错误转换。使用方式：在 src/lib/api/handler.ts 定义 validatedHandler，配置 input.schema 与 source，再以 export const GET = validatedHandler(...) 形式导出路由；可分页 schema 复用，支持查询参数、请求体、路径参数与鉴权检查等常见模式。适用场景：构建需要一致校验与错误处理的 Next.js 类型安全 API，减少每路由重复的解析与校验代码。限制：资料仅针对 Next.js App Router 与 Zod，未提供安装命令、版本要求或独立性能数据；路径参数需手动从 URL 提取，多来源校验需自行组合，框架无关变体仅供参考。