Category: GraphQL

Por qué usar GraphQL con Angular 21

GraphQL flexibiliza la capa de datos: una sola endpoint, consultas declarativas y capacidad para definir con precisión los campos necesarios. Angular 21 aporta Signals y providers standalone que simplifican la inyección del cliente GraphQL y minimizan la verbosidad.

Beneficios concretos

• Menos overfetching → mejores Core Web Vitals.
• Tipado end-to-end con GraphQL Code Generator → errores detectados en compilación.
• Caché de cliente (Apollo) que normaliza y reduce refetches.

Lecturas recomendadas: Apollo Angular, Angular, GraphQL Code Generator.

Configuración inicial (standalone)

Instala dependencias

npm install apollo-angular @apollo/client graphql
npm install -D @graphql-codegen/cli @graphql-codegen/typescript @graphql-codegen/typescript-operations @graphql-codegen/typescript-apollo-angular

Proveedores en app.config.ts (o main.ts)

Ejemplo de configuración de Apollo usando providers standalone:

import { ApplicationConfig, inject } from '@angular/core';
import { provideHttpClient } from '@angular/common/http';
import { provideApollo } from 'apollo-angular';
import { HttpLink } from 'apollo-angular/http';
import { InMemoryCache } from '@apollo/client/core';

export const appConfig: ApplicationConfig = {
  providers: [
    provideHttpClient(),
    provideApollo(() => {
      const httpLink = inject(HttpLink);
      return {
        link: httpLink.create({ uri: 'https://tu-api.com/graphql' }),
        cache: new InMemoryCache({
          typePolicies: {
            Query: { fields: {} }
          }
        })
      };
    })
  ]
};

Esta aproximación evita NgModule y funciona bien con SSR/PRERENDER.

Queries con Signals: patrón recomendado

Apollo devuelve Observables. En Angular 21, convierte esos streams a Signals para consumirlos en plantilla sin | async.

Consulta GraphQL ejemplo

query GetUser($id: ID!) {
  user(id: $id) {
    id
    name
    email
    projects { id name }
  }
}

Componente standalone

import { Component, inject, input } from '@angular/core';
import { toSignal } from '@angular/core/rxjs-interop';
import { Apollo } from 'apollo-angular';
import { map } from 'rxjs';
import { GET_USER } from '../graphql/queries';

@Component({ selector: 'app-user', standalone: true, template: `...` })
export class UserComponent {
  private apollo = inject(Apollo);
  userId = input.required();

  profile = toSignal(
    this.apollo.watchQuery({ query: GET_USER, variables: { id: this.userId() } })
      .valueChanges.pipe(map(r => r.data)),
    { initialValue: null }
  );
}

Consejo práctico: envuelve la creación de la query en un computed si userId puede cambiar y quieres que la query se reactive sin re-suscripciones manuales.

Mutations, optimismo y caché

Para mutaciones usa firstValueFrom o async/await y actualiza el caché para reflejar cambios sin refetch.

import { firstValueFrom } from 'rxjs';

async updateName(id: string, name: string) {
  await firstValueFrom(this.apollo.mutate({
    mutation: UPDATE_USER_NAME,
    variables: { id, name },
    optimisticResponse: { updateUser: { id, name, __typename: 'User' } },
    update: (cache, { data }) => {
      cache.modify({ id: cache.identify({ __typename: 'User', id }), fields: { name: () => name }});
    }
  }));
}

Optimistic UI + update evita parpadeos y mejora la percepción de velocidad.

Generación de tipos y servicios (GraphQL Code Generator)

No escribas interfaces a mano. Configura Codegen:

Configuración de Codegen

// codegen.ts
import type { CodegenConfig } from '@graphql-codegen/cli';
const config: CodegenConfig = {
  schema: "https://tu-api.com/graphql",
  documents: "src/**/*.graphql",
  generates: {
    "src/gql/": {
      plugins: ["typescript", "typescript-operations", "typescript-apollo-angular"]
    }
  }
};
export default config;

Resultado: tipos y servicios Angular fuertemente tipados, menos boilerplate y refactors seguros.

Buenas prácticas y observabilidad

• Normaliza InMemoryCache con typePolicies y keyFields para evitar duplicados.
• Añade errorLink y retryLink para manejo global de errores.
• Etiqueta mutaciones/queries (o usa headers) para correlación en logs.
• En CI, ejecuta Codegen y fallar la build si los tipos cambian.
• En desarrollo, usa whitelisting de clientes o modos sandbox para no spamear usuarios reales.

¿Cuándo elegir GraphQL con Angular 21?

Usa GraphQL si tus vistas requieren datos compuestos de múltiples fuentes, necesitas minimizar tráfico en móviles o buscas tipado estricto entre cliente y servidor. No lo añadas por moda: para CRUDs simples o equipos sin experiencia, HttpClient sigue siendo más directo.

GraphQL con Angular 21 no es mágico; es una herramienta que reduce deuda cuando se aplica con criterio. En Dominicode seguiremos profundizando en patterns avanzados: cache eviction, pagination cursor-based y estrategias para SSR con hydration. Esto no acaba aquí.

FAQ