TypeScript de Cero a Experto / Configuración pro

Reto: auditar y corregir una configuración

Reto30 min60 XP

El trabajo real de un ingeniero al llegar a un proyecto: mirar su configuración y detectar qué la debilita. Hoy auditas un tsconfig.json con problemas típicos —los que verás en proyectos reales— y lo corriges con criterio. No hay código que ejecutar; hay decisiones de configuración que tomar, que es una habilidad tan valiosa como escribir tipos.

Reto

La auditoría de configuración

Media25 min60 XP(×2 sin mirar la solución)

Qué debes hacer

Te entregan el tsconfig.json de un proyecto que "compila pero deja pasar bugs". Identifica los CINCO problemas y escribe la versión corregida, justificando cada cambio.

tsconfig.json (con problemas)

{
"compilerOptions": {
  "target": "ES2022",
  "module": "ESNext",
  "moduleResolution": "bundler",

  "strict": false,
  "noImplicitAny": true,

  "skipLibCheck": true
},
"include": ["src"]
}

Los cinco problemas a detectar y corregir:

La red de seguridad principal está DESACTIVADA.
Hay una configuración redundante o contradictoria con el punto 1.
Falta el chequeo extra más valioso para los accesos a arrays.
Faltan los paths para imports limpios (el proyecto usa ../../../ por todas partes).
Faltan un par de chequeos de calidad recomendados (código muerto, returns, switch).

Reglas

Para cada cambio, ten clara la RAZÓN (qué bug previene o qué mejora).
No agregues configuración innecesaria (project references NO hacen falta en un proyecto único).
La versión final debe ser la base sólida que usarías en un proyecto nuevo.

25:00

Cuando estés listo, arranca el reloj.

El diagnóstico, problema por problema:

"strict": false es el fallo grave. Desactiva las siete comprobaciones que hacen a TypeScript valer la pena (strictNullChecks, noImplicitAny, etc.). El proyecto "compila" pero readmite la clase entera de bugs que TS existe para prevenir. Ponerlo en true es el cambio de mayor impacto.
"noImplicitAny": true suelto es redundante una vez que strict está en true (ya lo incluye). No hace daño, pero es ruido que sugiere que quien lo escribió no sabía que strict lo cubre. Se puede quitar.
Falta noUncheckedIndexedAccess: sin él, los accesos por índice mienten sobre su tipo, dejando pasar los undefined de arrays vacíos.
Faltan baseUrl + paths: sin ellos, el proyecto vive con imports relativos frágiles. Agregarlos permite @/....
Faltan los chequeos de calidad: código muerto, returns y switch sin blindar.

tsconfig.json (corregido)

{
"compilerOptions": {
  "target": "ES2022",
  "module": "ESNext",
  "moduleResolution": "bundler",

  "strict": true,                        // (1) la red de seguridad, ENCENDIDA
  // "noImplicitAny" eliminado: (2) ya viene dentro de strict

  "noUncheckedIndexedAccess": true,      // (3) arrays honestos: T | undefined
  "noUnusedLocals": true,                // (5) sin variables muertas
  "noUnusedParameters": true,            // (5) sin parámetros fantasma
  "noImplicitReturns": true,             // (5) todas las rutas devuelven
  "noFallthroughCasesInSwitch": true,    // (5) switch sin fugas

  "baseUrl": ".",                        // (4) raíz para los alias
  "paths": { "@/*": ["./src/*"] },       // (4) imports limpios con @/

  "skipLibCheck": true                   // (estaba bien: no revisa node_modules)
},
"include": ["src"]
}

Autoevaluación de auditor: ¿identificaste que strict: false era EL problema, y no un detalle menor? ¿viste que noImplicitAny suelto era redundante con strict? ¿supiste que noUncheckedIndexedAccess no viene en strict y hay que agregarlo aparte? Esta habilidad —mirar una configuración y saber qué la debilita y por qué— es exactamente lo que se espera de alguien senior al llegar a un proyecto. No es glamorosa, pero prevenir bugs desde la configuración es de lo más rentable que harás.

Qué sigue

Módulo 9 cerrado: configuras TypeScript como un profesional —strict a fondo, chequeos extra, paths, references y ESLint type-aware—. Solo queda un módulo, el que cierra el supercurso: el 10, con dos proyectos completos (migrar la app de "Mi Bolsillo" a TS estricto y un API client tipado end-to-end) y los diez type-challenges que consolidan todo lo que aprendiste. La recta final.