nango-esm-migration

此技能提供了一套系统化的方法，用于解决将 Nango 集成迁移至基于 ESM 的零 YAML 架构时所发生的构建与运行时模块错误。它专为在迁移后遇到集成失败的开发者所设计，特别针对旧版 CommonJS (CJS) 供应商模块与现代 ESM 需求冲突的问题。

• 解决与 vendor 目录路径相关的 'Could not resolve' 和 'Cannot find module' 构建错误。
• 提供创建 ESM 包装器的说明，将仅支持 CJS 的供应商模块暴露给现代 ESM 使用。
• 引导开发者识别并清理迁移期间为了暂时解决问题而引入的代码，例如写死的货币计算或被注释掉的导入语句。
• 包含使用 git 历史记录与本地文件系统检查的专业调查清单，以追踪并还原原始的功能性实现。
• 提供位于 nango-integrations 目录内 vendor 文件的标准路径解析模式，确保模块解析的一致性。

使用此技能时，请先执行 'npx nango compile' 和 'npx tsc --noEmit' 来验证模块解析情况。重点在于识别下划线开头的参数或写死的变通方法，这些通常暗示着旧版的补丁。确保所有的 vendor 导入都包含 .js 后缀名，以符合 ESM 兼容性要求。此流程对于维护 Nango 集成逻辑的完整性与精确度至关重要，特别是在处理货币转换或复杂的供应商函数库依赖时。