feat(handler): Custom GraphQL parse option

Author: enisdenjo

docs/interfaces/HandlerOptions.md

@@ -16,6 +16,7 @@
 - [execute](HandlerOptions.md#execute)
 - [onOperation](HandlerOptions.md#onoperation)
 - [onSubscribe](HandlerOptions.md#onsubscribe)
+- [parse](HandlerOptions.md#parse)
 - [schema](HandlerOptions.md#schema)
 - [validate](HandlerOptions.md#validate)
 
@@ -133,6 +134,30 @@ further execution.
 
 ___
 
+### parse
+
+• `Optional` **parse**: (`source`: `string` \| `Source`, `options?`: `ParseOptions`) => `DocumentNode`
+
+#### Type declaration
+
+▸ (`source`, `options?`): `DocumentNode`
+
+Given a GraphQL source, parses it into a Document.
+Throws GraphQLError if a syntax error is encountered.
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `source` | `string` \| `Source` |
+| `options?` | `ParseOptions` |
+
+##### Returns
+
+`DocumentNode`
+
+___
+
 ### schema
 
 • `Optional` **schema**: `GraphQLSchema` \| (`req`: [`Request`](Request.md)<`RawRequest`\>, `args`: `Omit`<`ExecutionArgs`, ``"schema"``\>) => [`Response`](../README.md#response) \| `GraphQLSchema` \| `Promise`<[`Response`](../README.md#response) \| `GraphQLSchema`\>

src/handler.ts

@@ -10,7 +10,7 @@ import {
   GraphQLSchema,
   validate as graphqlValidate,
   execute as graphqlExecute,
-  parse,
+  parse as graphqlParse,
   DocumentNode,
   getOperationAST,
   OperationTypeNode,
@@ -82,6 +82,10 @@ export interface HandlerOptions<RawRequest = unknown> {
    * used to execute the query and mutation operations.
    */
   execute?: typeof graphqlExecute;
+  /**
+   * GraphQL parse function allowing you to apply a custom parser.
+   */
+  parse?: typeof graphqlParse;
   /**
    * The subscribe callback executed right after processing the request
    * before proceeding with the GraphQL operation execution.
@@ -210,6 +214,7 @@ export function createHandler<RawRequest = unknown>(
     context,
     validate = graphqlValidate,
     execute = graphqlExecute,
+    parse = graphqlParse,
     onSubscribe,
     onOperation,
   } = options;