TypeScript Avançado: Padrões de Tipagem Estrita e Arquitetura Limpa que Evitam Bugs em Produção

O TypeScript que Vai Além das Interfaces Básicas

Quase todo desenvolvedor frontend ou backend em Node.js já utiliza TypeScript para definir interfaces de objetos e tipos de parâmetros. No entanto, usar TypeScript apenas como documentação estática é subutilizar a ferramenta mais poderosa que você tem em mãos para garantir a confiabilidade de sistemas em produção.

Desenvolvedores seniores utilizam o sistema de tipos para tornar estados ilegais impossíveis de serem compilados.

1. O Poder das Discriminated Unions (Uniões Discriminadas)

Em vez de criar tipos monolíticos com dezenas de propriedades opcionais cheias de undefined, use uniões discriminadas por uma propriedade identificadora única:

type PaymentState =
  | { status: "idle" }
  | { status: "pending"; pixQrCode: string; expiresAt: Date }
  | { status: "success"; transactionId: string; paidAt: Date }
  | { status: "error"; errorMessage: string; errorCode: number };

function handlePayment(state: PaymentState) {
  switch (state.status) {
    case "pending":
      // TypeScript sabe que pixQrCode existe obrigatoriamente aqui!
      renderQrCode(state.pixQrCode);
      break;
    case "success":
      showReceipt(state.transactionId);
      break;
  }
}

Dessa forma, é matematicamente impossível tentar acessar uma chave de transação se o pagamento ainda estiver pendente.

2. Validação Estrita na Borda com Zod ou Valibot

O compilador do TypeScript só atua em tempo de desenvolvimento; quando o código vira JavaScript no navegador ou no servidor, os tipos deixam de existir. Para validar payloads de APIs externas ou formulários de usuários, use bibliotecas como Zod. Você define o esquema uma única vez e gera o tipo TypeScript automaticamente (type Input = z.infer<typeof schema>;).