Clerk JavaScript 库发布 4.57.0 版本：商业 API 稳定化与计费功能增强

Clerk 是一个为现代 Web 应用提供身份验证和用户管理解决方案的 JavaScript 库。它简化了开发者实现用户注册、登录、权限管理等常见功能的过程，让开发者能够更专注于核心业务逻辑的开发。

本次发布的 4.57.0 版本主要聚焦于商业 API 的稳定化和计费功能的增强，为开发者提供了更完善的商业能力支持。下面我们来详细解析这次更新的主要内容。

商业 API 正式稳定

在此次更新中，Clerk 将之前处于实验阶段的商业 API 标记为稳定版本。这意味着这些 API 已经经过了充分的测试和验证，开发者可以放心地在生产环境中使用它们。

稳定后的商业 API 包括定价表组件和相关支付方法管理功能：

• mountPricingTable 和 unmountPricingTable 方法用于在页面上渲染和卸载定价表组件
• 用户和组织级别的支付源管理方法：initializePaymentSource、addPaymentSource 和 getPaymentSources

这些 API 的稳定化标志着 Clerk 的商业功能已经成熟，能够支持各种电子商务场景的需求。

计费功能全面升级

4.57.0 版本引入了全新的计费命名空间 Clerk.billing，提供了一系列强大的计费管理功能：

• getPlans：获取可用计划列表
• getSubscriptions：获取当前订阅信息
• getInvoices：获取历史发票记录
• startCheckout：启动结账流程

这些功能为开发者提供了完整的计费管理能力，可以轻松实现订阅服务的全生命周期管理。

支付流程优化

本次更新对支付流程进行了多项优化：

1. 新增了 checkoutContinueUrl 选项，允许开发者指定用户在完成结账后跳转的页面
2. 在开发环境中添加了"使用测试卡支付"按钮，方便开发者测试支付流程
3. 改进了定价表组件的布局设计，提升了用户体验
4. 支持从月订阅切换到年订阅的功能，为用户提供更多选择
5. 增加了切换到免费计划的支持，满足不同用户需求

权限管理增强

为了确保计费操作的安全性，新版本对权限管理进行了强化：

• 只有具有 org:sys_billing:manage 权限的组织成员才能管理组织的计费设置
• 重新设计了订阅列表的 UI，将其整合到用户档案和组织档案的 ProfileSections 中

内部重构与命名规范化

为了提高代码的可维护性和一致性，本次更新进行了多项内部重构：

• 将 __experimental_nextTask 重命名为 __experimental_navigateToTask
• 将 __experimental_checkoutContinueUrl 简化为 checkoutContinueUrl
• 将 __experimental_PricingTable 重命名为 PricingTable
• 将 CheckoutProps 和 PlanDetailsProps 重命名为 __internal_CheckoutProps 和 __internal_PlanDetailsProps

这些命名上的调整使得 API 更加清晰和一致，有助于开发者更好地理解和使用。

新增工具提示组件

4.57.0 版本还引入了一个新的 <Tooltip /> 基础组件，为开发者提供了更丰富的 UI 交互能力。这个组件可以用于在各种场景下提供额外的信息提示，提升用户体验。

总结

Clerk JavaScript 库的 4.57.0 版本通过商业 API 的稳定化和计费功能的全面升级，为开发者提供了更强大的商业能力支持。无论是电子商务网站还是订阅制服务，现在都可以更轻松地集成 Clerk 提供的身份验证和计费解决方案。

这次更新不仅增加了新功能，还对现有功能进行了优化和重构，提高了整体的稳定性和易用性。对于正在使用或考虑使用 Clerk 的开发者来说，4.57.0 版本无疑是一个值得升级的重要版本。