René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Bug] ESM builds missing .js extensions in @bitgo/abstract-utxo (\u003e=10.7.0) and @bitgo/utxo-core (\u003e=1.24.0)","articleBody":"## Environment Details\n\n- **OS:** macOS / Linux (Docker)\n- **Node Version:** 22.14+\n- **Package Manager:** pnpm 10.17.1\n- **BitGoJS Version:** `@bitgo/abstract-utxo@10.8.0`, `@bitgo/utxo-core@1.25.0`\n- **BitGo Environment:** Both testnet and mainnet\n\n## Expected Behavior\n\nESM builds in `dist/esm/` should use proper Node.js ESM-compatible imports with explicit `.js` file extensions for relative imports, allowing the packages to be consumed in ESM projects.\n\n## Current Behavior\n\nESM builds use relative imports without `.js` extensions, causing `ERR_MODULE_NOT_FOUND` errors when importing the packages in Node.js ESM environments.\n\n**Error 1 (`@bitgo/abstract-utxo`):**\n```\nError [ERR_MODULE_NOT_FOUND]: Cannot find module\n'/app/node_modules/@bitgo/abstract-utxo/dist/esm/abstractUtxoCoin'\nimported from '/app/node_modules/@bitgo/abstract-utxo/dist/esm/index.js'\n```\n\n**Error 2 (`@bitgo/utxo-core`):**\n```\nError [ERR_MODULE_NOT_FOUND]: Cannot find module 'bip174/src/lib/utils'\nimported from '/app/node_modules/@bitgo/utxo-core/dist/esm/paygo/psbt/payGoAddressProof.js'\n```\n\n## Possible Solution\n\nThe TypeScript compilation for ESM output needs to add `.js` extensions to all relative imports. This can be achieved by:\n\n1. Using `tsc-alias` or `tsconfig-paths` post-processing\n2. Setting `moduleResolution: \"NodeNext\"` with proper TypeScript configuration\n3. Using a bundler plugin like `rollup-plugin-add-import-extension`\n\n**Example of broken vs fixed imports:**\n\n```javascript\n// Current (broken)\nexport * from './abstractUtxoCoin';\nimport { foo } from './address';\nimport { checkForOutput } from 'bip174/src/lib/utils';\n\n// Expected (fixed)\nexport * from './abstractUtxoCoin.js';\nimport { foo } from './address/index.js';\nimport { checkForOutput } from 'bip174/src/lib/utils.js';\n```\n\n## Steps to Reproduce\n\n1. Create an ESM Node.js project (`\"type\": \"module\"` in package.json)\n2. Install `@bitgo/sdk-coin-zec@2.6.0` (which depends on `@bitgo/abstract-utxo@10.8.0`)\n3. Import the package:\n   ```javascript\n   import { Zec } from '@bitgo/sdk-coin-zec';\n   ```\n4. Run with Node.js 22+:\n   ```bash\n   node index.js\n   ```\n5. Observe `ERR_MODULE_NOT_FOUND` error\n\n## Affected Versions\n\n| Package | Last Working | Broken |\n|---------|--------------|--------|\n| `@bitgo/abstract-utxo` | 10.6.0 (CJS only) | \u003e=10.7.0 (ESM introduced) |\n| `@bitgo/utxo-core` | 1.23.0 (CJS only) | \u003e=1.24.0 (ESM introduced) |\n\n## Workaround\n\nWe are currently using pnpm patches to add `.js` extensions to all ESM imports:\n\n```json\n{\n  \"pnpm\": {\n    \"patchedDependencies\": {\n      \"@bitgo/abstract-utxo@10.8.0\": \"patches/@bitgo__abstract-utxo@10.8.0.patch\",\n      \"@bitgo/utxo-core@1.25.0\": \"patches/@bitgo__utxo-core@1.25.0.patch\"\n    }\n  }\n}\n```\n\nThis is not sustainable as patches need to be regenerated for each version upgrade.","author":{"url":"https://github.com/jakubswierczek","@type":"Person","name":"jakubswierczek"},"datePublished":"2025-12-01T22:27:10.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/7660/BitGoJS/issues/7660"}