用途：用于升级 klaviyo-api SDK 版本，以及从旧版 v1/v2 API 迁移到较新 API 版本，处理不同 API 修订版之间的破坏性变更。工作流会先评估当前版本，再用 TypeScript 编译器暴露破坏性变更，套用对应的迁移模式，并通过 staging 部署上线，同时保留回滚路径。
主要能力：提供三类迁移模式，包括旧版 v1/v2 到当前 API（将原始 HTTP 调用替换为 EventsApi / ProfilesApi 等类型化资源类）、SDK 主版本升级（将全局 ConfigWrapper 替换为按实例创建的 ApiKeySession）、属性命名从 snake_case 改为 camelCase。另包含升级与回滚步骤：锁定版本的安装、tsc/测试关卡、staging 部署、回滚与迁移清单。
使用方式：先确认已安装与已发布的版本，如 npm list klaviyo-api 与 npm view klaviyo-api version；再通过 grep 查找受影响的调用点；随后按报错套用迁移模式；最后在独立分支上锁定安装目标版本，运行 npx tsc --noEmit 与 npm test，先部署到 staging。资料给出的升级命令包括 git checkout -b upgrade/klaviyo-api-v21、npm install klaviyo-api@21.0.0 --save-exact、npx tsc --noEmit 2>&1 | grep -i "klaviyo|error TS"、npm test。若升级后错误率上升，可重新安装先前的确切版本以回滚。
前置条件：已安装 klaviyo-api；有 Git 且工作区干净；有可运行的测试套件，最好有 staging 集成测试目标；环境中提供 Klaviyo 私有 API key 用于集成验证。
限制：资料给出了各 API 修订版的发布时间与弃用时间以及关键变更，但未提供具体价格、收费方式、完整平台支持范围或保证效果。使用前需自行核对目标版本的具体变更，缺失信息暂未提供。