Custos de manter configurações em projetos Next.js com TypeScript

Manter arquivos de configuração do Next.js em TypeScript, como o 'next.config.ts', traz um dilema de compatibilidade e custo operacional.

Quando usamos 'next.config.js', recebemos um aviso no tsconfig.json indicando que o arquivo 'next.config.ts' não foi encontrado, o que causa preocupação na equipe sobre a consistência do projeto. Por outro lado, alterar para '.ts' gera o erro explícito de que essa configuração não é suportada pelo Next.js.

Essa situação aumenta o esforço de manutenção, pois temos que decidir entre ignorar warnings ou lidar com erros que interrompem o build. Além do impacto na produtividade, isso pode gerar dúvidas na equipe e aumentar o risco de configurações quebradas ao longo do tempo.

Na minha opinião, essa incompatibilidade reflete uma limitação de suporte oficial, obrigando a equipe a trabalhar com hacks ou configurações alternativas, o que dá trabalho depois e dificulta a escalabilidade do projeto. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta.

O que vocês fazem nos seus times para lidar com esse tipo de problema de compatibilidade entre ferramentas e configuração de build? Será que vale a pena investir em uma camada de abstração que minimize esses custos? Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte.