Como Turborepo crea su grafo de dependencias
Turborepo construye su grafo leyendo los archivos package.json de tu monorepo y detectando dos puntos clave: dependencies y devDependencies. Estas claves definen tanto paquetes externos de npm como, de forma crucial, otros workspaces locales de los que depende cada paquete.
Al ejecutar turbo run build --graph, Turborepo descubre todos los workspaces, lee su package.json, traza aristas de dependencia desde un paquete hacia cualquier workspace listado en dependencies o devDependencies y utiliza ese grafo para calcular el orden correcto de ejecución y lo que puede almacenarse en caché.
Por qué se ignoran las importaciones perezosas o dinámicas
La carga perezosa con import dinámico o require asíncrono es un comportamiento de tiempo de ejecución. Turborepo opera a nivel de paquete y tarea, ejecutando build, test o lint sobre paquetes completos, sin inspeccionar el código fuente interno para analizar cómo se resuelven los módulos en ejecución. Las importaciones dinámicas las resuelve el bundler de tu aplicación, como Webpack, Vite, Rollup o Next.js, durante el proceso de build de la app, no el orquestador de tareas. Por tanto, el grafo de Turborepo es un grafo de tareas y no un grafo de código fuente.
Ejemplo práctico
Imagina un monorepo con una app llamada next-app y dos paquetes compartidos ui y utils. En la app se importa de forma estática un componente Button desde ui y además se carga de forma dinámica un componente pesado interno. Lo que ve Turborepo es que next-app depende de ui y utils, por lo que ejecuta los builds de ui y utils antes de construir next-app. Lo que Turborepo no ve son las importaciones dinámicas internas como un componente HeavyComponent dentro de la propia app.
Implicaciones y buenas prácticas
1 Cacheo correcto. Si cambias un módulo cargado de forma dinámica dentro de la app, no debería invalidarse la caché de ui ni de utils. Solo se reconstruye la app afectada y esa granularidad la gestiona el bundler. 2 Declaración de dependencias. Declara siempre todas las dependencias a nivel de paquete en los package.json. Si la app usa cualquier pieza del paquete ui, incluso si se importa de forma dinámica, ui debe aparecer como dependencia. Turborepo confía exclusivamente en esa declaración.
Resumen
El grafo de Turborepo se construye a partir de las declaraciones en package.json, no a partir del escaneo del código en busca de import. La carga perezosa es una preocupación de tiempo de ejecución resuelta por el bundler y es invisible para la planificación de tareas y el sistema de caché de Turborepo.
Cómo te ayuda Q2BSTUDIO
En Q2BSTUDIO diseñamos y evolucionamos monorepos profesionales para acelerar entregas y garantizar calidad en proyectos de aplicaciones a medida y software a medida, aplicando prácticas como grafos de dependencias eficientes, orquestación de tareas, cache distribuido y CI automatizada. Si buscas acelerar tu roadmap con una base sólida, descubre nuestros servicios de desarrollo de aplicaciones a medida y software a medida. También integramos inteligencia artificial de forma pragmática en tus productos, desde copilotos y agentes IA hasta pipelines de datos y MLOps, para crear verdadera ia para empresas. Conoce cómo lo hacemos en nuestra solución de inteligencia artificial.
Nuestro enfoque integral combina ciberseguridad y pentesting, servicios cloud aws y azure, automatización de procesos, servicios inteligencia de negocio y analítica avanzada con power bi para que tu plataforma escale con seguridad, observabilidad y control de costes. Q2BSTUDIO es tu socio tecnológico para construir, asegurar y hacer crecer productos digitales de alto impacto.