Linear SDK v44.0.0 发布：Webhook 负载类型重构与功能增强

Linear 是一个现代的项目管理和问题跟踪平台，其 SDK 为开发者提供了与 Linear API 交互的能力。最新发布的 Linear SDK v44.0.0 版本带来了一系列重要的变更，主要集中在 Webhook 负载类型的重构和新功能的引入。

重大变更解析

Webhook 负载类型重构

本次版本最显著的变化是对 Webhook 负载类型的重构：

1. 移除 BaseEntityWebhookPayload 类型：这个基础类型被移除，取而代之的是更细分的负载类型结构。

2. 时间字段类型变更：AppUserNotificationWebhookPayload.createdAt 字段从 String! 变更为 DateTime! 类型，这提供了更精确的时间处理能力。

3. 文档内容关联变更：CommentWebhookPayload.documentContent 字段类型从 BaseEntityWebhookPayload 改为 DocumentContentChildWebhookPayload，提供了更具体的文档内容信息。

新增 Webhook 负载类型

为了提供更丰富的 Webhook 功能，SDK 引入了多个新的负载类型：

• AppUserTeamAccessChangedWebhookPayload：处理团队成员访问权限变更事件
• AuditEntryWebhookPayload：审计日志条目事件
• CustomResourceWebhookPayload：自定义资源事件
• DocumentWebhookPayload：文档相关事件
• IssueSlaWebhookPayload：问题 SLA 相关事件
• OAuthAppWebhookPayload：OAuth 应用事件

这些新类型使开发者能够更精确地处理不同类型的事件通知。

功能增强

Salesforce 集成改进

新增了 SalesforceSettingsInput.reopenCaseStatus 输入字段，允许配置当案例重新打开时的状态设置，增强了与 Salesforce 的集成能力。

元数据刷新功能

新增了 Mutation.integrationSalesforceMetadataRefresh 字段，提供了手动刷新 Salesforce 元数据的能力，这对于保持集成数据的最新状态非常有用。

类型系统优化

1. 引入了 BaseWebhookPayload 作为新的基础类型，替代被移除的 BaseEntityWebhookPayload。

2. 新增了 EntityWebhookPayload 和 DataWebhookPayload 类型，提供了更灵活的负载处理能力。

3. 对现有类型的字段描述进行了优化，使其更加清晰明确。

升级建议

对于正在使用 Linear SDK 的开发者，升级到 v44.0.0 版本时需要注意：

1. 检查所有使用 BaseEntityWebhookPayload 的代码，替换为新的相应类型。

2. 处理 AppUserNotificationWebhookPayload.createdAt 字段的类型变更，确保时间处理逻辑兼容新的 DateTime! 类型。

3. 考虑利用新的 Webhook 负载类型来增强应用程序的事件处理能力。

4. 如果需要 Salesforce 集成功能，可以利用新的元数据刷新和案例状态配置选项。

这次更新显著提升了 Linear SDK 在 Webhook 处理方面的能力和灵活性，为开发者构建更强大的集成应用提供了更好的基础。