Mejores prácticas de TypeScript para código limpio y mantenible

TypeScript brilla cuando te ayuda a modelar la realidad, no cuando te obliga a pelear con los tipos todo el día. Unos pocos valores predeterminados pueden hacer que un código se sienta más calmado, más seguro y más fácil de refactorizar.

Reglas prácticas

• Activa el modo estricto y corrige los bordes afilados pronto.
• Prefiere tipos legibles sobre tipos ingeniosos.
• Usa uniones para “uno de estos” e interfaces para “la forma de esto”.
• Evita any como atajo; se convierte rápido en deuda futura.

Un patrón que vale la pena memorizar

type Result<T> =
  | { ok: true; value: T }
  | { ok: false; error: string };

export function parseNumber(input: string): Result<number> {
  const n = Number(input);
  return Number.isFinite(n) ? { ok: true, value: n } : { ok: false, error: "Not a number" };
}

Cierre

El mejor código TypeScript se lee como buena documentación: nombres claros, formas predecibles y errores que te señalan la solución.