首页
/ ts-rest 3.53.0-rc.1版本发布:标准化Schema验证与多框架增强

ts-rest 3.53.0-rc.1版本发布:标准化Schema验证与多框架增强

2025-06-17 21:55:16作者:魏侃纯Zoe

ts-rest是一个强大的TypeScript优先的API契约库,它允许开发者定义一次API契约并在前后端共享类型安全。通过类型化的路由定义,ts-rest为全栈TypeScript开发提供了无缝的体验。

标准化Schema验证支持

本次3.53.0-rc.1版本最重要的更新是引入了"Standard Schema"验证接口。这一改变为ts-rest带来了更广泛的验证库兼容性,开发者现在可以自由选择Zod、Valibot、Arktype等多种验证方案,而不再局限于特定的验证库。

在核心模块@ts-rest/core中,这一标准化接口的实现意味着:

  • 验证逻辑与具体库解耦,提高了灵活性
  • 支持更多现代验证库的集成
  • 保持类型安全的同时提供更丰富的验证选项

各框架适配器更新

Express适配器增强

@ts-rest/express现在正式支持Express v5,为使用最新Express版本的开发者提供了更好的兼容性。同时,它也继承了标准Schema验证支持,使得Express路由的输入输出验证更加灵活。

Fastify适配器改进

@ts-rest/fastify新增了AppRouteImplementation的导出,这一改进使得开发者可以更方便地在不同文件中组织和复用路由实现逻辑,提高了代码的可维护性。

Next.js适配器修复

修复了Next.js适配器中查询参数污染路径参数读取的问题,确保了参数解析的准确性。这对于依赖URL参数进行路由匹配的Next.js应用尤为重要。

OpenAPI生成增强

@ts-rest/open-api模块现在支持自定义Schema转换器,与标准Schema更新保持同步。新增的operationMapper函数参数允许开发者使用appRoute的ID作为回调,为OpenAPI文档生成提供了更多定制选项。此外,还增加了对c.otherResponse()的支持,使得API文档能更全面地反映实际响应情况。

其他改进

  • 修复了baseUrl和路径中前导/和尾随/重复的问题
  • 允许在路径参数中传递数字类型
  • 修复了无响应体但带有JSON内容类型头的响应处理
  • 服务器模块(@ts-rest/serverless)暴露了更多类型,解决了"verbatimModuleSyntax"等构建配置下的构建问题

总结

ts-rest 3.53.0-rc.1版本通过引入标准化Schema验证接口,为开发者提供了更大的灵活性和选择空间。各框架适配器的增强和修复进一步提升了开发体验,使得构建类型安全的API更加便捷。这些改进使得ts-rest在全栈TypeScript开发中的优势更加明显,值得开发者关注和采用。

登录后查看全文
热门项目推荐
相关项目推荐