@dumbql/core

Central GraphQL client for Angular — query, mutate, middleware, pipes, directives, and more.

Features

• GraphqlService — query, mutate, refetch, poll, setEndpoint
• Middleware pipeline — auth, logging, devtools, cache, custom
• Standalone functions — query(), mutate(), refetch(), poll() (injection‑free)
• Result helpers — isSuccess, isError, unwrap, unwrapOrThrow, mapResult
• gql tag — parse()-based DocumentNode creation
• TypedDocumentNode<TResult, TVars> — phantom‑typed documents
• Angular pipes — GqlPipe, GraphqlDataPipe, GraphqlErrorPipe, and more
• Reactive variables — makeVar<T>(), ReactiveVar<T>
• Client directive — @client field resolution
• Router integration — guardedRoute(), provideDumbqlRouter()
• Auto‑refetch — mutationCachePolicy(), provideAutoRefetch()
• DevTools — DevtoolsService, devtoolsMiddleware
• Schema service — SchemaService, provideSchemaFetch()
• Request batching, deduplication, retry
• Plugin system — DumbqlPlugin with onInit + getMiddleware
• ng add schematics — interactive setup

Install

ng add @dumbql/core
# or
npm install @dumbql/core

Quick Start

import { provideDumbql } from '@dumbql/core';

bootstrapApplication(App, {
  providers: [provideDumbql({ endpoint: '/graphql' })],
});

import { Component, inject } from '@angular/core';
import { GraphqlService, gql, isSuccess, unwrap } from '@dumbql/core';

@Component({ template: '...' })
class TodosComponent {
  private graphql = inject(GraphqlService);
  todos$ = this.graphql.query<{ todos: Todo[] }>(
    gql`query Todos { todos { id title } }`,
  ).pipe(
    isSuccess(),
    unwrap(),
  );
}

API Overview

Sub‑packages

Dependencies

@angular/common, @angular/core, @dumbql/cache, graphql, rxjs