Saltar al contenido principal

Corrección de compilación en modo watch — deleteOutDir, script start-env y módulo @nestjs/schedule

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Se corrigieron dos errores que aparecían al levantar el backend con npm run start-env:

src/domains/alertas/services/alerta-vencimiento.service.ts:2:38 - error TS2307:
Cannot find module '@nestjs/schedule' or its corresponding type declarations.
Error: Cannot find module '...\ccf-almacen-api\dist\main'
code: 'MODULE_NOT_FOUND'

1. TS2307: Cannot find module '@nestjs/schedule' — ya resuelto​

Este error no requería cambios de código:

  • @nestjs/schedule está declarado en package.json (^4.1.2) y presente en node_modules.
  • ScheduleModule.forRoot() está correctamente importado en src/app.module.ts.
  • npm run build compila con 0 errores.

Era un estado obsoleto del entorno (el paquete aún no estaba instalado). Con node_modules actualizado, el error desaparece.


2. Cannot find module '...\dist\main' — causa raíz​

El fallo ocurría justo después de un Found 0 errors del watcher. La causa es la interacción de dos configuraciones:

ArchivoValorEfecto
ccf-almacen-api/nest-cli.jsondeleteOutDir: trueBorra dist/ al iniciar cada build/watch
ccf-almacen-api/tsconfig.jsonincremental: truetsc mantiene estado incremental en memoria

Secuencia que produce el fallo​

  1. npm run start-env levanta el watcher (nest start --watch); dist/main.js existe y la API responde.
  2. Se lanza una segunda instancia de npm run start-env (o un npm run build) con el watcher todavía activo.
  3. La segunda ejecución, por deleteOutDir: true, borra dist/.
  4. El watcher de la primera instancia recompila en modo incremental: reporta Found 0 errors, pero solo reemite el archivo modificado; main.js nunca se regenera porque el estado vive en memoria.
  5. El CLI de Nest intenta node dist/main → MODULE_NOT_FOUND.

Nota: deleteOutDir: true en nest-cli.json solo ejecuta el borrado al iniciar el build (build.action.js), nunca entre recompilaciones. Por eso el fallo se dispara al lanzar un segundo proceso concurrente sobre la misma carpeta.


Solución aplicada​

ccf-almacen-api/nest-cli.json​

"compilerOptions": {
"deleteOutDir": false
}

Con esto ningún build borra dist/ mientras el watcher está vivo. Se conserva incremental: true (recompilaciones de watch rápidas).

ccf-almacen-api/package.json — script start-env​

- "start-env": "npm run start:dev && node --env-file=.env",
+ "start-env": "nest start --watch",

El script anterior encadenaba npm run start:dev && node --env-file=.env, pero start:dev (nest start --watch) nunca termina, por lo que la segunda parte (node --env-file=.env) era código muerto. El nuevo comando tiene el mismo comportamiento efectivo que se venía usando, sin la parte engañosa.


Verificación​

  • npm run build → 0 errores y dist/main.js generado.
  • npm run start-env ejecutado en el puerto 4100 (override de PORT):
    • Compila Found 0 errors.
    • Nest inicializa todos los módulos, incluidos ConfigModule, ScheduleModule y TypeOrmModule/TypeOrmCoreModule (conexión a PostgreSQL correcta).
    • http://localhost:4100/api → HTTP 200.

.env se carga automáticamente mediante ConfigModule.forRoot({ envFilePath: '.env' }) en src/app.module.ts, por lo que no se requiere --env-file.


Tabla de cambios​

ÁreaCambioArchivo / ruta
BackenddeleteOutDir de true a falseccf-almacen-api/nest-cli.json
BackendScript start-env simplificadoccf-almacen-api/package.json
WikiEsta nota de cambioblog/2026-09-29-fix-watch-deleteoutdir/index.md

Recomendaciones​

  • No ejecutar dos instancias de npm run start-env / npm run start:dev sobre la misma carpeta. Si se requiere reiniciar, detener la instancia anterior primero.
  • Build de producción: nest build ya no limpia dist/. Conviene eliminar dist/ antes de generar el paquete de despliegue (el checkout/CI limpio lo cubre).