\n\n## Install\n\n```sh\nnpm i @hydre/graphql-http\n```\n\nIt is recommended to use [@hydre/make_schema](https://github.com/HydreIO/make_schema) too,\n\n```\nnpm i @hydre/make_schema\n```\n\n## Usage\n\nThis is an example with Koa but using others is pretty much the same.\nImport them by path\n\n```js\nimport graphqlHTTP from '@hydre/graphql-http/koa'\nimport graphqlHTTP from '@hydre/graphql-http/lambda'\nimport graphqlHTTP from '@hydre/graphql-http/tinyhttp'\nimport graphqlHTTP from '@hydre/graphql-http/fastify'\n```\n\n```js\nimport Koa from 'koa'\nimport { readFileSync } from 'fs'\nimport bodyParser from 'koa-bodyparser'\nimport { readFile } from 'fs/promises'\nimport graphql from 'graphql'\nimport graphqlHTTP from '@hydre/graphql-http/koa'\nimport makeSchema from '@hydre/make_schema'\n\nconst { buildSchema } = graphql\nconst schema = buildSchema(readFileSync('/path/to/schema.gql', 'utf-8'))\nconst app = new Koa().use(bodyParser()).use(\n graphqlHTTP({\n schema: make_schema({\n document: await readFile('test/schema.gql', 'utf8'),\n resolvers: {\n Query: {\n hello({ name }) {\n return `Hello ${name} !`\n },\n me() {\n return { friend: 'Bob', name: 'Alice' }\n },\n animal() {\n return { speak: () => 'jajaja', __typename: 'Cat' }\n },\n },\n User: {\n sayHello({ friend }, { to }) {\n return `Hello ${to}, I'm ${friend}'s friend`\n },\n },\n // as we don't define the Spanish, by default it will say 'jajaja'\n Cat: {\n speak() {\n return 'miaou'\n },\n },\n Subscription: {\n async *onMessage() {\n while (true) {\n await setTimeout(1000)\n yield 'Hello'\n }\n },\n },\n },\n }),\n // rootValue is what comes as a first argument in your resolvers, it is an object resolved by default\n // a bit like how Promise.resolve() works, meaning that your subsequent resolvers won't be called\n // if something is already present in this rootValue.\n // This is useful for the first layer of calls and can contains functions but it can become confusing\n // and is not made for nested layers like { user { language: string, speak: function } } as `speak()` won't contains previously resolved\n // fields of the user object so won't know about the language for example.\n // If you're not advanced in Graphql, you should stick to the built schema only\n rootValue: {},\n buildContext: async ctx => {},\n formatError: error => error,\n })\n)\n\napp.listen(3000)\n```\n","readmeFilename":"README.md"}
![](\"https://img.shields.io/github/license/hydreio/graphql-http.svg?style=for-the-badge\")
\n \n ![](\"https://img.shields.io/npm/v/@hydre/graphql-http.svg?logo=npm&style=for-the-badge\")
\n \n ![](\"https://img.shields.io/npm/dw/@hydre/graphql-http?logo=npm&style=for-the-badge\")
\n ![](\"https://img.shields.io/github/actions/workflow/status/hydreio/graphql-http/CI?logo=Github&style=for-the-badge\")
\n