{"id":47962,"library":"graphql-ts-client","title":"GraphQL TS Client","description":"Generate fully typed TypeScript clients for any GraphQL API. Version 10.4.0 targets Node >=12, ships TypeScript types, and is actively maintained. Key differentiators: client generation with runtime URL/header/retry configuration, response listeners, and alias support. Unlike alternatives like graphql-request or Apollo Client, it separates code generation from runtime usage, producing a standalone client file that can be imported without additional dependencies.","status":"active","version":"10.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/wellguimaraes/graphql-ts-client","tags":["javascript","typescript"],"install":[{"cmd":"npm install graphql-ts-client","lang":"bash","label":"npm"},{"cmd":"yarn add graphql-ts-client","lang":"bash","label":"yarn"},{"cmd":"pnpm add graphql-ts-client","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Named export only. No default export.","wrong":"import generateTypescriptClient from 'graphql-ts-client'","symbol":"generateTypescriptClient","correct":"import { generateTypescriptClient } from 'graphql-ts-client'"},{"note":"The generated client file exports a default client instance by default (name based on output filename).","wrong":"","symbol":"myAwesomeApi","correct":"import { myAwesomeApi } from './myAwesomeApi'"}],"quickstart":{"code":"import { generateTypescriptClient } from 'graphql-ts-client'\nimport * as fs from 'fs/promises'\n\ngenerateTypescriptClient({\n  output: './myApi.ts',\n  endpoint: process.env.GRAPHQL_ENDPOINT ?? 'https://api.example.com/graphql',\n  headers: {\n    Authorization: `Bearer ${process.env.AUTH_TOKEN ?? ''}`,\n  },\n})\n\n// Generated client usage:\nimport { myApi } from './myApi'\n\nasync function fetchData() {\n  const response = await myApi.queries.users({\n    __args: { limit: 10 },\n    id: true,\n    name: true,\n    email: true,\n  })\n  console.log(response.users)\n}","lang":"typescript","description":"Generates a TypeScript client from a GraphQL endpoint and uses it to query users."},"warnings":[{"fix":"Ensure endpoint is provided and valid.","message":"generateTypescriptClient now requires the 'endpoint' option to be a non-empty string.","severity":"breaking","affected_versions":">=10.0.0"},{"fix":"Remove verbose option and implement custom logging if needed.","message":"The 'verbose' option is deprecated. Use a custom before hook or logger instead.","severity":"deprecated","affected_versions":">=9.0.0"},{"fix":"Use __alias to override the method name if needed.","message":"Generated client method names are derived from the GraphQL query/mutation names. Ensure your schema conforms to GraphQL naming conventions or expect snake_case to be converted to camelCase.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'10.4.0':14 '12':17 'activ':23 'addit':64 'alia':36 'altern':39 'api':12 'apollo':45 'client':3,8,27,46,57 'code':49 'configur':32 'depend':65 'differenti':26 'file':58 'fulli':5 'generat':4,28,50 'graphql':1,11,42 'graphql-request':41 'import':62 'javascript':66 'key':25 'like':40 'listen':34 'maintain':24 'node':16 'produc':54 'request':43 'respons':33 'runtim':30,52 'separ':48 'ship':18 'standalon':56 'support':37 'target':15 'ts':2 'type':6,20 'typescript':7,19,67 'unlik':38 'url/header/retry':31 'usag':53 'version':13 'without':63","created_at":"2026-06-07T16:54:13.076710+00:00","updated_at":"2026-06-07T16:54:13.076710+00:00","problems":[{"fix":"Use import { generateTypescriptClient } from 'graphql-ts-client'","cause":"Using default import instead of named import.","error":"TypeError: generateTypescriptClient is not a function"},{"fix":"Provide a valid GraphQL endpoint URL in the generateTypescriptClient call.","cause":"Missing or empty endpoint option.","error":"Error: Invalid endpoint provided","affected_versions":">=10.0.0"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/wellguimaraes/graphql-ts-client#readme","github":"https://github.com/wellguimaraes/graphql-ts-client","docs":null,"changelog":null,"pypi":null,"npm":"graphql-ts-client","openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}