UNPKG

graphql-http

Version:

Simple, pluggable, zero-dependency, GraphQL over HTTP spec compliant server, client and audit suite.

109 lines (108 loc) 3.85 kB
"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.createHandler = exports.parseRequestParams = void 0; const handler_1 = require("../handler"); /** * The GraphQL over HTTP spec compliant request parser for an incoming GraphQL request. * * If the HTTP request _is not_ a [well-formatted GraphQL over HTTP request](https://graphql.github.io/graphql-over-http/draft/#sec-Request), the function will respond * on the `FastifyReply` argument and return `null`. * * If the HTTP request _is_ a [well-formatted GraphQL over HTTP request](https://graphql.github.io/graphql-over-http/draft/#sec-Request), but is invalid or malformed, * the function will throw an error and it is up to the user to handle and respond as they see fit. * * ```js * import Fastify from 'fastify'; // yarn add fastify * import { parseRequestParams } from 'graphql-http/lib/use/fastify'; * * const fastify = Fastify(); * fastify.all('/graphql', async (req, reply) => { * try { * const maybeParams = await parseRequestParams(req, reply); * if (!maybeParams) { * // not a well-formatted GraphQL over HTTP request, * // parser responded and there's nothing else to do * return; * } * * // well-formatted GraphQL over HTTP request, * // with valid parameters * reply.status(200).send(JSON.stringify(maybeParams, null, ' ')); * } catch (err) { * // well-formatted GraphQL over HTTP request, * // but with invalid parameters * reply.status(400).send(err.message); * } * }); * * fastify.listen({ port: 4000 }); * console.log('Listening to port 4000'); * ``` * * @category Server/fastify */ async function parseRequestParams(req, reply) { const rawReq = toRequest(req, reply); const paramsOrRes = await (0, handler_1.parseRequestParams)(rawReq); if (!('query' in paramsOrRes)) { const [body, init] = paramsOrRes; reply .status(init.status) .headers(init.headers || {}) // "or undefined" because `null` will be JSON stringified .send(body || undefined); return null; } return paramsOrRes; } exports.parseRequestParams = parseRequestParams; /** * Create a GraphQL over HTTP spec compliant request handler for * the fastify framework. * * ```js * import Fastify from 'fastify'; // yarn add fastify * import { createHandler } from 'graphql-http/lib/use/fastify'; * import { schema } from './my-graphql-schema'; * * const fastify = Fastify(); * fastify.all('/graphql', createHandler({ schema })); * * fastify.listen({ port: 4000 }); * console.log('Listening to port 4000'); * ``` * * @category Server/fastify */ function createHandler(options) { const handle = (0, handler_1.createHandler)(options); return async function requestListener(req, reply) { try { const [body, init] = await handle(toRequest(req, reply)); reply .status(init.status) .headers(init.headers || {}) // "or undefined" because `null` will be JSON stringified .send(body || undefined); } catch (err) { // The handler shouldnt throw errors. // If you wish to handle them differently, consider implementing your own request handler. console.error('Internal error occurred during request handling. ' + 'Please check your implementation.', err); reply.status(500).send(); } }; } exports.createHandler = createHandler; function toRequest(req, reply) { return { url: req.url, method: req.method, headers: req.headers, // eslint-disable-next-line @typescript-eslint/no-explicit-any body: req.body, raw: req, context: { reply }, }; }