@radzor/graphql-client

Execute GraphQL queries and mutations with automatic batching, response caching, and subscription support via WebSocket. Uses raw fetch for HTTP transport and native WebSocket for subscriptions.

Data & Databasev0.1.0typescriptpythonUniversalgraphqlclientquerymutationsubscriptioncachingbatchingapiby Radzor

Install

View source on GitHub →

$npx radzor@latest add graphql-client

⚠ Constraints: Uses native fetch for HTTP and WebSocket for subscriptions. Node.js 18+ required. Subscriptions follow the graphql-ws protocol. Caching is in-memory only.

Inputs

Name	Type	Default	Description
endpoint*	string	—	The GraphQL HTTP endpoint URL.
headers	Record<string, string>	—	Default headers to send with every request (e.g. authorization).
cacheEnabled	boolean	false	Whether to enable in-memory response caching for queries.
cacheTtlMs	number	60000	Cache TTL in milliseconds.
batchEnabled	boolean	false	Whether to enable request batching.
batchIntervalMs	number	50	Batching window in milliseconds. Requests within this window are combined.
wsEndpoint

{ "llm": { "constraints": "Uses native fetch for HTTP and WebSocket for subscriptions. Node.js 18+ required. Subscriptions follow the graphql-ws protocol. Caching is in-memory only.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/graphql-client", "tags": [ "graphql", "client", "query", "mutation", "subscription", "caching", "batching", "api" ], "events": [ { "name": "onError", "payload": { "status": "number", "message": "string", "operation": "string" }, "description": "Fired when a GraphQL request fails at the HTTP level." } ], "inputs": [ { "name": "endpoint", "type": "string", "required": true, "description": "The GraphQL HTTP endpoint URL." }, { "name": "headers", "type": "Record<string, string>", "required": false, "description": "Default headers to send with every request (e.g. authorization)." }, { "name": "cacheEnabled", "type": "boolean", "default": false, "required": false, "description": "Whether to enable in-memory response caching for queries." }, { "name": "cacheTtlMs", "type": "number", "default": 60000, "required": false, "description": "Cache TTL in milliseconds." }, { "name": "batchEnabled", "type": "boolean", "default": false, "required": false, "description": "Whether to enable request batching." }, { "name": "batchIntervalMs", "type": "number", "default": 50, "required": false, "description": "Batching window in milliseconds. Requests within this window are combined." }, { "name": "wsEndpoint", "type": "string", "required": false, "description": "WebSocket endpoint for GraphQL subscriptions. Defaults to the HTTP endpoint with ws(s):// protocol." } ], "radzor": "1.0.0", "actions": [ { "name": "query", "params": [ { "name": "query", "type": "string", "description": "The GraphQL query string." }, { "name": "variables", "type": "Record<string, unknown>", "required": false, "description": "Query variables." } ], "returns": "Promise<GraphQLResult>", "description": "Execute a GraphQL query. May return cached results if caching is enabled." }, { "name": "mutate", "params": [ { "name": "mutation", "type": "string", "description": "The GraphQL mutation string." }, { "name": "variables", "type": "Record<string, unknown>", "required": false, "description": "Mutation variables." } ], "returns": "Promise<GraphQLResult>", "description": "Execute a GraphQL mutation. Never cached." }, { "name": "subscribe", "params": [ { "name": "subscription", "type": "string", "description": "The GraphQL subscription string." }, { "name": "variables", "type": "Record<string, unknown>", "required": false, "description": "Subscription variables." }, { "name": "onData", "type": "(data: unknown) => void", "description": "Callback invoked for each subscription event." } ], "returns": "{ unsubscribe: () => void }", "description": "Start a GraphQL subscription over WebSocket." }, { "name": "setBatchInterval", "params": [ { "name": "ms", "type": "number", "description": "New batch interval in milliseconds." } ], "returns": "void", "description": "Update the batching window interval." } ], "outputs": [ { "name": "graphqlResult", "type": "GraphQLResult", "fields": [ { "name": "data", "type": "unknown", "description": "The response data." }, { "name": "errors", "type": "Array<{ message: string; path?: string[]; extensions?: Record<string, unknown> }>", "required": false, "description": "GraphQL errors, if any." }, { "name": "cached", "type": "boolean", "description": "Whether this result was served from cache." } ], "description": "The result of a GraphQL operation." } ], "runtime": "universal", "version": "0.1.0", "category": "data", "languages": [ "typescript", "python" ], "description": "Execute GraphQL queries and mutations with automatic batching, response caching, and subscription support via WebSocket. Uses raw fetch for HTTP transport and native WebSocket for subscriptions.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "output": "graphqlResult", "mapField": "data", "compatibleWith": [ "@radzor/json-transform.action.transform.data", "@radzor/data-validator.action.validate.data" ] }, { "event": "onError", "description": "Track GraphQL errors", "compatibleWith": [ "@radzor/error-tracker.action.captureMessage.message", "@radzor/log-aggregator.action.error.message" ] } ] } }

@radzor/graphql-client

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json