Module Federation sin tipos era volar a ciegas. En este post resolvemos eso con tipado automático entre Host y Remote, y configuramos el bloque shared para que tu app no descargue React dos veces.
STRATEGIC_INSIGHT // ARCHITECT_VIEW
Este Blueprint analiza la implementación de Module Federation con
@module-federation/enhanced para resolver la pérdida de tipos TypeScript
entre aplicaciones distribuidas, logrando un tipado automático sin
configuración manual y eliminando la duplicación de dependencias en runtime.
TECH_LEVEL
ADVANCED
IMPACT_RATIO
EFFICIENCY_BOOST
Type Safety y Estrategias de Orquestación
Serie: Dominando Microfrontends con React, RSBuild y Module Federation — Parte 2 de 3 Resumen: Cómo lograr que el Host reconozca automáticamente los tipos del Remote, y cómo evitar duplicar librerías en el navegador.
El "Santo Grial": Tipado Automático entre Microfrontends
Uno de los mayores puntos de dolor históricos de Module Federation era la pérdida de tipos de TypeScript al cruzar los límites entre aplicaciones. Con @module-federation/enhanced, ese problema es cosa del pasado.
Al ejecutar el modo desarrollo, RSBuild genera automáticamente una carpeta .mf-types dentro del Host con las definiciones de tipo del Remote. A partir de ese momento, el autocompletado y la validación de tipos funcionan exactamente igual que si consumieras un componente local: sin casteos manuales, sin any, sin fricción.
Configuración de Dependencias Compartidas (shared)
Sin una configuración explícita, cada Microfrontend podría descargar su propia copia de React, lo que incrementa el bundle y puede causar errores en tiempo de ejecución por instancias duplicadas.
El bloque shared resuelve esto. La siguiente es la configuración recomendada para un entorno de producción:
singleton: true — Garantiza que solo exista una instancia de la librería en toda la aplicación, independientemente de cuántos MFEs la declaren como dependencia.
requiredVersion — Define el rango de versión aceptable. Si el Host y un Remote tienen versiones incompatibles, Module Federation lanzará una advertencia en consola en lugar de fallar silenciosamente.
eager: false — La librería se carga bajo demanda en lugar de incluirse en el bundle inicial, lo que reduce el tiempo de carga en el primer render.
Nota: Configura eager: true solo en el Host (nunca en los Remotes) si necesitas que React esté disponible de forma sincrónica desde el arranque, por ejemplo para inicializar un contexto global.
Exponiendo Páginas vs. Componentes: ¿Qué conviene exponer?
Un error común es limitar los exposes a componentes pequeños. En una arquitectura real, los MFEs pueden y deben exponer unidades más grandes:
Tipo
Descripción
Ejemplo
Componentes
Elementos de UI reutilizables y sin estado propio significativo
Botón, Badge, Avatar
Widgets
Piezas de UI autocontenidas con lógica propia
Carrito de compras, Panel de notificaciones
Micro-apps
Páginas completas con enrutamiento y estado interno
Módulo de checkout, Panel de administración
La regla general: expón en el nivel más alto que tenga sentido de negocio. Cuanto mayor sea la unidad expuesta, menor será el acoplamiento entre aplicaciones.
Próximo Paso
Ya tienes tipos seguros y bundles optimizados. Pero ¿qué pasa cuando el Remote no está disponible en producción?
En el artículo final de la serie exploraremos resiliencia ante fallos y despliegue dinámico: cómo configurar fallbacks, cargar Remotes desde URLs variables en tiempo de ejecución, y mantener el Host funcional aunque uno o varios MFEs no respondan.