| name | typescript |
| description | Strict TypeScript guidance for LifeOS backend (NestJS) and frontend (React). Use when creating or refactoring DTOs, domain/application types, API client types, generics, type guards, or when resolving TypeScript errors without weakening type safety. |
TypeScript
Objetivo
Definir tipos explícitos y estables entre backend y frontend sin usar atajos inseguros.
REQUIRED
- Declarar tipos de entrada/salida en funciones públicas.
- Tipar fronteras con
unknown y refinar con type guards.
- Mantener DTOs separados de entidades de dominio.
- Centralizar tipos compartidos por feature (
frontend/src/types o frontend/src/features/*/types).
- Usar uniones literales/enums para estados de negocio (
pending, completed, etc.).
- Modelar nullabilidad real (
string | null) y evitar asumir valores.
NEVER
- No usar
any salvo bloqueo temporal explícitamente comentado.
- No usar
as para ocultar errores de diseño de tipos.
- No mezclar tipos de Prisma directamente en capas de dominio/aplicación.
- No devolver objetos parcialmente tipados en endpoints públicos.
Flujo recomendado
- Definir contrato (DTO/Response) primero.
- Definir tipo de dominio/aplicación separado.
- Crear mapper explícito entre contrato y dominio.
- Ejecutar
tsc/vitest y corregir sin relajar tipos.
