tsconfig.json

{
  "extends": [
    "@tsconfig/recommended/tsconfig.json",
    "@tsconfig/node-lts/tsconfig.json",
    "@tsconfig/node-ts/tsconfig.json"
  ],
  "compilerOptions": {
    // Directorios de código fuente y salida de compilación
    "rootDir": "./src",
    "outDir": "./dist",

    // Sobrescribe node-lts (es2024) para compilar siempre hacia las últimas características de JS
    "target": "esnext",
    "lib": ["esnext"],

    // Limita la búsqueda de tipos de ambiente solo a Node.js
    "types": ["node"],

    // node-lts establece moduleResolution en "node16", lo cual entra en conflicto con module: "nodenext".
    // Se sobrescribe para mantener consistencia: "nodenext" es la variante más estricta y orientada al futuro.
    "moduleResolution": "nodenext",

    // Seguridad de tipos adicional no cubierta por las configuraciones base:
    "noUncheckedIndexedAccess": true, // Evita `undefined` silencioso al acceder a arrays/objetos por índice
    "exactOptionalPropertyTypes": true, // Impide asignar `undefined` a propiedades opcionales salvo que el tipo lo incluya explícitamente

    // Reglas de calidad de código no cubiertas por las configuraciones base:
    "noImplicitReturns": true, // Obliga a que todos los caminos de ejecución de una función retornen un valor
    "noImplicitOverride": true, // Requiere la palabra clave `override` al sobrescribir un miembro de la clase base
    "noUnusedLocals": true, // Marca variables locales declaradas pero no utilizadas
    "noUnusedParameters": true, // Marca parámetros declarados pero no utilizados
    "noFallthroughCasesInSwitch": true, // Previene el fall-through accidental entre casos de un switch
    "noPropertyAccessFromIndexSignature": true, // Requiere notación de corchetes para acceder a firmas de índice (hace explícito el acceso dinámico)
    "noUncheckedSideEffectImports": true, // Marca imports de efecto secundario cuya resolución es ambigua o no verificada
    "moduleDetection": "force" // Trata cada archivo como módulo aunque no tenga imports/exports (evita fugas al ámbito global)
  },
  "include": ["src/**/*"]
}