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 整合邏輯的完整性與精確度至關重要，特別是在處理貨幣轉換或複雜的供應商函式庫相依性時。