Problemas ao construir projetos Node.js usando ESM e CommonJS

Contexto

Muitos desenvolvedores enfrentam dificuldades ao configurar seus projetos Node.js para suportar módulos ES (ESM) e CommonJS simultaneamente. Um erro comum é o TS1343, que indica problemas com o uso de import.meta.

Problema na prática

Ao tentar compilar ou rodar projetos em ambos os formatos, é frequente receber mensagens de erro relacionadas às configurações do --module no TypeScript ou na configuração do package.json. O erro aponta que o import.meta só é permitido com certas opções de módulo, como es2020, esnext, etc.

Como evitar e resolver

• Configurar o tsconfig.json corretamente:

  {
    "compilerOptions": {
      "module": "esnext",
      "target": "es2020",
      "moduleResolution": "node",
      "esModuleInterop": true,
      "outDir": "dist"
    }
  }
  

• Ajustar o package.json:

  {
    "type": "module",
    "main": "dist/cjs/index.js",
    "exports": {
      ".": {
        "require": "./dist/cjs/index.js",
        "import": "./dist/esm/index.js"
      }
    }
  }
  

• Testar as configurações de build para garantir que ambos os tipos de módulo funcionem sem conflito.

Perguntas para a comunidade

• Quem já passou por esse problema e qual foi a solução mais eficiente?
• Como vocês gerenciam a manutenção de projetos que precisam suportar ambos os formatos?
• Existem boas práticas para evitar esses conflitos desde o início do projeto?

Vamos compartilhar experiências e dicas para facilitar esse processo.