feat(use): Built-in handlers for some environments and frameworks

[enisdenjo]

Speed up and improve DX by shipping with built-in support for some environments inside the lib/use folder.

Node

graphql-http/lib/use/node

import http from 'http';
-import { createHandler } from 'graphql-http';
+import { createHandler } from 'graphql-http/lib/use/node';
import { schema } from './my-graphql-schema';

const handler = createHandler({ schema });

const server = http.createServer(async (req, res) => {
-  if (!req.url.startsWith('/graphql')) {
-    return res.writeHead(404).end();
-  }
-  try {
-    const [body, init] = await handler({
-      url: req.url,
-      method: req.method,
-      headers: req.headers,
-      body: () =>
-        new Promise((resolve) => {
-          let body = '';
-          req.on('data', (chunk) => (body += chunk));
-          req.on('end', () => resolve(body));
-        }),
-      raw: req,
-    });
-    res.writeHead(init.status, init.statusText, init.headers).end(body);
-  } catch (err) {
-    res.writeHead(500).end(err.message);
-  }
+  if (req.url.startsWith('/graphql')) {
+    handler(req, res);
+  } else {
+    res.writeHead(404).end();
+  }
});

Express

graphql-http/lib/use/express

import express from 'express'; // yarn add express
-import { createHandler } from 'graphql-http';
+import { createHandler } from 'graphql-http/lib/use/express';
import { schema } from './my-graphql-schema';

const handler = createHandler({ schema });

const app = express();
-app.all('/graphql', async (req, res) => {
-  try {
-    const [body, init] = await handler({
-      url: req.url,
-      method: req.method,
-      headers: req.headers,
-      body: () =>
-        new Promise((resolve) => {
-          let body = '';
-          req.on('data', (chunk) => (body += chunk));
-          req.on('end', () => resolve(body));
-        }),
-      raw: req,
-    });
-    res.writeHead(init.status, init.statusText, init.headers).end(body);
-  } catch (err) {
-    res.writeHead(500).end(err.message);
-  }
-});
+app.all('/graphql', handler);

app.listen({ port: 4000 });
console.log('Listening to port 4000');

Fastify

graphql-http/lib/use/fastify

import Fastify from 'fastify'; // yarn add fastify
-import { createHandler } from 'graphql-http';
+import { createHandler } from 'graphql-http/lib/use/fastify';
import { schema } from './my-graphql-schema';

const handler = createHandler({ schema });

const fastify = Fastify();
-fastify.all('/graphql', async (req, res) => {
-  try {
-    const [body, init] = await handler({
-      url: req.url,
-      method: req.method,
-      headers: req.headers,
-      body: req.body, // fastify reads the body for you
-      raw: req,
-    });
-    res.writeHead(init.status, init.statusText, init.headers).end(body);
-  } catch (err) {
-    res.writeHead(500).end(err.message);
-  }
-});
+fastify.all('/graphql', handler);

fastify.listen({ port: 4000 });
console.log('Listening to port 4000');

Deno (and other fetch native environments)

graphql-http/lib/use/fetch

import { serve } from 'https://deno.land/[email protected]/http/server.ts';
-import { createHandler } from 'https://esm.sh/graphql-http';
+import { createHandler } from 'https://esm.sh/graphql-http/lib/use/fetch';
import { schema } from './my-graphql-schema';

const handler = createHandler({ schema });

await serve(
  async (req: Request) => {
    const [path, _search] = req.url.split('?');
-   if (!path.endsWith('/graphql')) {
-     return new Response(null, { status: 404, statusText: 'Not Found' });
-   }
-
-   const [body, init] = await handler({
-     url: req.url,
-     method: req.method,
-     headers: req.headers,
-     body: () => req.text(),
-     raw: req,
-   });
-   return new Response(body, init);
+   if (path.endsWith('/graphql')) {
+     return handler(req);
+   } else {
+     return new Response(null, { status: 404 });
+   }
  },
  {
    port: 4000,
  },
);

[enisdenjo]

🎉 This PR is included in version 1.7.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀