🚀 Implementando TypeScript no Node.js: do JavaScript solto ao código profissional

Quem começa com Node.js geralmente inicia em JavaScript puro. Funciona? Funciona.

Escala bem? Nem sempre.

É aí que entra o TypeScript — não como modinha, mas como ferramenta de maturidade técnica.

Neste guia, vamos entender o que é TypeScript, por que usar, como configurar e como aplicar tipos corretamente, seguindo boas práticas de mercado.

Sem gambiarra. Sem “any pra tudo”.

🧠 O que é TypeScript?

TypeScript é um superset do JavaScript, mantido pela Microsoft, que adiciona:

• Tipagem estática
• Interfaces
• Enums
• Melhor autocompletar
• Detecção de erros em tempo de desenvolvimento

No fim do dia, o TypeScript vira JavaScript, mas um JavaScript muito mais seguro.

🎯 Por que TypeScript é importante no Node.js?

Em projetos reais:

• APIs crescem
• Times aumentam
• Código passa de mão em mão

TypeScript ajuda a:

• Evitar erros silenciosos
• Facilitar refatorações
• Documentar o código com tipos
• Melhorar testes e automação

Por isso virou padrão em APIs modernas, microserviços e projetos corporativos.

📦 Passo 1: Instalando o TypeScript no projeto

Dentro do projeto Node:

npm install --save-dev typescript

Se estiver usando Express:

npm install --save-dev @types/express

Os pacotes @types fornecem as tipagens das bibliotecas JavaScript.

⚙️ Passo 2: Criando o arquivo tsconfig.json

Esse arquivo define as regras do jogo.

npx tsc --init

Exemplo de configuração inicial recomendada:

{
"compilerOptions": {
  "target": "ES2020",
  "module": "commonjs",
  "rootDir": "./src",
  "outDir": "./dist",
  "strict": true,
  "esModuleInterop": true
}
}

Aqui estamos dizendo:

• Use JavaScript moderno
• Compile para a pasta dist
• Ative tipagem rigorosa (sem corpo mole)

🗂️ Passo 3: Ajustando a estrutura do projeto

Estrutura recomendada:

src/
 ├── controllers/
 ├── routes/
 ├── app.ts
 └── server.ts
dist/

Agora nossos arquivos passam a usar .ts.

🧠 Passo 4: Tipando o servidor

Arquivo server.ts:

import app from './app';

const PORT: number = 3000;

app.listen(PORT, () => {
console.log(`Servidor rodando na porta ${PORT}`);
});

Nada de deixar variável “solta”. Cada coisa tem seu tipo.

🧭 Passo 5: Tipando rotas e controllers

Arquivo app.ts:

import express, { Application } from 'express';
import routes from './routes';

const app: Application = express();

app.use(express.json());
app.use(routes);

export default app;

Controller tipado:

import { Request, Response } from 'express';

export const status = (req: Request, res: Response): Response => {
return res.status(200).json({
  message: 'API rodando com TypeScript 🚀'
});
};

Isso melhora:

• Autocompletar
• Leitura
• Segurança
• Testabilidade

✅ Aplicando Type na prática (sem exagero)

Exemplo de tipagem de dados:

interface Beer {
id: number;
name: string;
quantity: number;
}

const beer: Beer = {
id: 1,
name: 'IPA',
quantity: 50
};

Tipos funcionam como contratos. Se quebrar o contrato, o erro aparece antes da produção.

📌 Boas práticas com TypeScript

Algumas regras que salvam projetos:

• Evite any (é o botão de autodestruição)
• Use interface para objetos
• Use type para composições
• Tipos simples > tipos mirabolantes
• Ative strict: true
• Tipagem não substitui testes

TypeScript ajuda, mas não faz milagre sozinho.

🧱 Organização e padronização

Padrões ajudam times a respirar:

• Nomes claros de arquivos
• Uma responsabilidade por arquivo
• Controllers finos
• Serviços bem definidos
• Tipos reutilizáveis em pastas específicas (types/)

Código limpo escala. Código bagunçado cobra juros.

🛣️ Mini roadmap: evoluindo com TypeScript

Depois da base, o próximo nível:

1. Tipar DTOs
2. Criar camada de services
3. Tipar erros e exceções
4. Usar Zod ou Joi para validação
5. Integrar testes automatizados
6. Aplicar TypeScript em testes de API

Esse combo é ouro para quem trabalha com APIs e QA.

🎯 Mercado de trabalho

Hoje, TypeScript não é diferencial — é expectativa.

• Back-end
• Fullstack
• QA técnico
• Automação de testes
• APIs corporativas

Quem domina JavaScript + TypeScript sai na frente.

🧠 Conclusão

TypeScript é como um cinto de segurança:

Você pode até andar sem…

Mas quando o projeto cresce, ele salva vidas.

📌 Estou aplicando TypeScript em projetos focados em APIs, boas práticas e automação, buscando código mais confiável, legível e profissional.

Se você está começando, comece certo.