¿Cómo puede integrarse GraphQL en una arquitectura hexagonal?

En la arquitectura hexagonal, GraphQL puede actuar como una puerta, que facilita la interacción entre el entorno externo y el núcleo de la aplicación. Puede ser implementado como:

1. Adaptador Entrante: La API de GraphQL recibe solicitudes de los clientes (frontend, otros servicios), las transforma y llama a los servicios de dominio correspondientes ("puertos" internos del núcleo) para ejecutar la lógica de negocio. Los resultados de los servicios de dominio se agregan y devuelven en formato GraphQL.

2. Adaptador Saliente (menos típico): En algunos casos, GraphQL puede usarse para integrar con servicios externos que también ofrecen una API GraphQL. En este caso, el cliente de GraphQL desde el núcleo de la aplicación ("puerto") llamará al servicio externo a través del adaptador.

La integración se logra mediante la implementación de la capa de resolutores GraphQL. Estos resolutores sirven como "puente" entre el esquema GraphQL y los objetos/servicios de dominio del núcleo.

// Ejemplo de resolutor GraphQL en Node.js
const resolvers = {
  Query: {
    getUser: async (parent, { id }, { domainServices }) => {
      // Llamada al servicio de dominio a través del "puerto"
      const user = await domainServices.userService.findUserById(id);
      return user;
    },
  },
  Mutation: {
    createUser: async (parent, { input }, { domainServices }) => {
      // Llamada al servicio de dominio para ejecutar la lógica de negocio
      const newUser = await domainServices.userService.createUser(input);
      return newUser;
    },
  },
};

Ventajas de este enfoque:

• Aislamiento: La API de GraphQL puede cambiar sin afectar la lógica de negocio en el núcleo.
• Testabilidad: Los servicios de dominio pueden ser probados independientemente de la capa GraphQL.
• Flexibilidad: Es más fácil cambiar tecnologías a nivel de "puertos" sin afectar el núcleo.

De esta manera, GraphQL se convierte en uno de los "fachadas" a través de las cuales los consumidores externos interactúan con un núcleo de la aplicación aislado y bien estructurado.