Corrección de compilación en modo watch — deleteOutDir, script start-env y módulo @nestjs/schedule
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/scheduleestá declarado enpackage.json(^4.1.2) y presente ennode_modules.ScheduleModule.forRoot()está correctamente importado ensrc/app.module.ts.npm run buildcompila 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:
| Archivo | Valor | Efecto |
|---|---|---|
ccf-almacen-api/nest-cli.json | deleteOutDir: true | Borra dist/ al iniciar cada build/watch |
ccf-almacen-api/tsconfig.json | incremental: true | tsc mantiene estado incremental en memoria |
Secuencia que produce el fallo
npm run start-envlevanta el watcher (nest start --watch);dist/main.jsexiste y la API responde.- Se lanza una segunda instancia de
npm run start-env(o unnpm run build) con el watcher todavía activo. - La segunda ejecución, por
deleteOutDir: true, borradist/. - El watcher de la primera instancia recompila en modo incremental: reporta
Found 0 errors, pero solo reemite el archivo modificado;main.jsnunca se regenera porque el estado vive en memoria. - El CLI de Nest intenta
node dist/main→MODULE_NOT_FOUND.
Nota:
deleteOutDir: trueennest-cli.jsonsolo 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 ydist/main.jsgenerado.npm run start-envejecutado en el puerto4100(override dePORT):- Compila
Found 0 errors. - Nest inicializa todos los módulos, incluidos
ConfigModule,ScheduleModuleyTypeOrmModule/TypeOrmCoreModule(conexión a PostgreSQL correcta). http://localhost:4100/api→ HTTP 200.
- Compila
.envse carga automáticamente medianteConfigModule.forRoot({ envFilePath: '.env' })ensrc/app.module.ts, por lo que no se requiere--env-file.
Tabla de cambios
| Área | Cambio | Archivo / ruta |
|---|---|---|
| Backend | deleteOutDir de true a false | ccf-almacen-api/nest-cli.json |
| Backend | Script start-env simplificado | ccf-almacen-api/package.json |
| Wiki | Esta nota de cambio | blog/2026-09-29-fix-watch-deleteoutdir/index.md |
Recomendaciones
- No ejecutar dos instancias de
npm run start-env/npm run start:devsobre la misma carpeta. Si se requiere reiniciar, detener la instancia anterior primero. - Build de producción:
nest buildya no limpiadist/. Conviene eliminardist/antes de generar el paquete de despliegue (el checkout/CI limpio lo cubre).
