@probitas/client-graphql

GraphQL client for Probitas scenario testing framework.

This package provides a GraphQL client designed for integration testing of GraphQL APIs.

Features

• Query & Mutation: Full support for GraphQL operations
• Variables Support: Pass typed variables to queries and mutations
• Duration Tracking: Built-in timing for performance monitoring
• Error Inspection: Inspect GraphQL errors and their structure
• Resource Management: Implements AsyncDisposable for proper cleanup
• Template Literals: Re-exports outdent for clean multi-line queries

Installation

deno add jsr:@probitas/client-graphql

Quick Start

import { createGraphqlClient, outdent } from "@probitas/client-graphql";

const client = createGraphqlClient({ url: "http://localhost:4000/graphql" });

// Query with variables
const res = await client.query(outdent`
  query GetUser($id: ID!) {
    user(id: $id) { id name email }
  }
`, { id: "123" });
console.log("User:", res.data());

// Mutation
const created = await client.mutation(outdent`
  mutation CreateUser($input: CreateUserInput!) {
    createUser(input: $input) { id name }
  }
`, { input: { name: "Jane", email: "jane@example.com" } });
console.log("Created:", created.data());

await client.close();

Using with using Statement

await using client = createGraphqlClient({ url: "http://localhost:4000/graphql" });

const res = await client.query(`{ __typename }`);
console.log(res.data());
// Client automatically closed when block exits

Related Packages

Package	Description
@probitas/client	Core utilities and types
@probitas/client-http	HTTP client

Links

• GitHub Repository
• Probitas Framework

deno add jsr:@probitas/client-graphql

class GraphqlError extends ClientError

new GraphqlError(message: string, errors: readonly GraphqlErrorItem[], options?: GraphqlErrorOptions)

class GraphqlExecutionError extends GraphqlError

new GraphqlExecutionError(errors: readonly GraphqlErrorItem[], options?: GraphqlErrorOptions)

class GraphqlNetworkError extends GraphqlError

new GraphqlNetworkError(message: string, options?: ErrorOptions)

class GraphqlValidationError extends GraphqlError

new GraphqlValidationError(errors: readonly GraphqlErrorItem[], options?: GraphqlErrorOptions)

interface GraphqlClient extends AsyncDisposable

query<TData = any, TVariables = Record<string, any>>(query: string, variables?: TVariables, options?: GraphqlOptions): Promise<GraphqlResponse<TData>>

mutation<TData = any, TVariables = Record<string, any>>(mutation: string, variables?: TVariables, options?: GraphqlOptions): Promise<GraphqlResponse<TData>>

execute<TData = any, TVariables = Record<string, any>>(document: string, variables?: TVariables, options?: GraphqlOptions): Promise<GraphqlResponse<TData>>

subscribe<TData = any, TVariables = Record<string, any>>(document: string, variables?: TVariables, options?: GraphqlOptions): AsyncIterable<GraphqlResponse<TData>>

close(): Promise<void>

interface GraphqlClientConfig extends CommonOptions

interface GraphqlConnectionConfig extends CommonConnectionConfig

interface GraphqlErrorItem

interface GraphqlErrorOptions extends ErrorOptions

interface GraphqlOptions extends CommonOptions

interface GraphqlResponse<T = any>

data<U = T>(): U | null

interface GraphqlResponseOptions<T>

function createGraphqlClient(config: GraphqlClientConfig): GraphqlClient

const client = createGraphqlClient({
  url: "http://localhost:4000/graphql",
});

const response = await client.query(`
  query GetUser($id: ID!) {
    user(id: $id) { id name email }
  }
`, { id: "123" });

console.log(response.data());
await client.close();

const client = createGraphqlClient({
  url: { host: "api.example.com", port: 443, protocol: "https" },
});

const response = await client.mutation(`
  mutation CreateUser($input: CreateUserInput!) {
    createUser(input: $input) { id }
  }
`, { input: { name: "Alice", email: "alice@example.com" } });

if (response.ok) {
  console.log("Created user:", response.data().createUser.id);
}

await using client = createGraphqlClient({
  url: "http://localhost:4000/graphql",
});
const response = await client.query(`{ __typename }`);
// Client automatically closed when scope exits

function createGraphqlResponse<T>(options: GraphqlResponseOptions<T>): GraphqlResponse<T>

const outdent: Outdent