Apollo Client 3.12.6版本修复Tagged类型与Unmasked的兼容性问题

在Apollo Client从3.11.8升级到3.12.4版本后，开发团队发现了一个与TypeScript类型系统相关的重要兼容性问题。这个问题主要影响了使用type-fest库中的Tagged类型与Apollo Client的Unmasked类型结合时的场景。

问题背景

当开发者尝试在update函数中使用从data返回的ID时，TypeScript编译器会抛出类型不匹配的错误。错误信息表明系统无法将包含多种字符串方法的复杂类型分配给简单的UUID类型。深入分析后发现，这个问题源于Unmasked类型（特别是其内部的UnwrapFragmentRefs类型）与Tagged类型的交互方式。

技术细节分析

问题的核心在于UnwrapFragmentRefs类型的实现逻辑。当处理Tagged类型时，类型系统总是进入TData extends object分支，导致对Tagged类型的错误解包。具体来说：

1. UnwrapFragmentRefs会对输入类型进行递归解包
2. 当遇到Tagged类型时，它错误地将其识别为普通对象类型
3. 系统尝试解包Tagged类型的属性，但实际上这些属性并不存在
4. 最终导致类型推断失败

解决方案

Apollo Client团队通过两个PR解决了这个问题：

1. 首先调整了ContainsFragmentRefs检查的位置，将其从MaybeMasked移到Unmasked类型中
2. 然后专门处理了Tagged类型与数据掩码(data masking)结合使用的情况

这种解决方案既修复了当前的问题，又考虑了未来使用数据掩码时的兼容性。

影响范围

该问题主要影响：

• 使用type-fest库中Tagged类型的项目
• 在Apollo Client操作中依赖自动类型推断的场景
• 特别是update函数中处理ID字段的情况

升级建议

对于遇到此问题的开发者，建议：

1. 升级到Apollo Client 3.12.6或更高版本
2. 检查项目中是否使用了类似的Tagged类型包装
3. 如果使用了数据掩码功能，确保全面测试类型推断的正确性

这个修复体现了Apollo Client团队对TypeScript类型系统深刻的理解和对开发者体验的重视，确保了类型安全的同时也维护了API的灵活性。