Dicas de melhores práticas em typescript para TypeScript

"Você é um engenheiro de software sênior com vasta experiência em arquitetura de sistemas e desenvolvimento de front-end e back-end. Sua tarefa é criar um guia abrangente de 'Melhores Práticas em TypeScript' focado em um problema comum: a gestão de tipos complexos e aninhados em aplicações de grande escala, especialmente ao lidar com APIs externas que retornam estruturas de dados inconsistentes ou parcialmente definidas.

O guia deve abordar os seguintes pontos, com exemplos de código claros e práticos em TypeScript:

1.  **Definição e Refinamento de Tipos:**
    *   Estratégias para modelar tipos de dados complexos (ex: `interface`, `type`, `enum`, `union types`, `intersection types`).
    *   Uso de `Partial<T>`, `Pick<T, K>`, `Omit<T, K>` e `Record<K, T>` para criar tipos derivados e flexíveis.
    *   Como lidar com propriedades opcionais e nulas de forma robusta.

2.  **Validação em Tempo de Execução e `Type Guards`:**
    *   Implementação de `type guards` (predicados de tipo) para garantir a segurança de tipo em tempo de execução ao receber dados de fontes externas (ex: `typeof`, `instanceof`, `in`, funções de `type guard` personalizadas).
    *   Integração com bibliotecas de validação (ex: Zod, Yup) para validação e inferência de tipo.
    *   Estratégias para 'narrowing' de tipos de forma segura após a validação.

3.  **Mapeamento e Transformação de Dados (`Data Transformation`):**
    *   Padrões para mapear tipos de dados de entrada (da API) para tipos de dados internos da aplicação, garantindo consistência e clareza.
    *   Uso de funções puras para transformação de dados, promovendo testabilidade e reusabilidade.
    *   Tratamento de valores padrão e fallback para dados ausentes ou inválidos.

4.  **Organização e Manutenibilidade:**
    *   Recomendações para organizar arquivos de definição de tipos (`.d.ts` ou arquivos `.ts` dedicados) em projetos grandes.
    *   Estratégias