address review comments

Author: acao

README.md

@@ -222,10 +222,11 @@ export default {
 };
 ```
 
-##### With [`Netlify functions`](https://docs.netlify.com/functions/overview/)
+##### With [`Netlify Functions`](https://docs.netlify.com/functions/overview/)
 
+in `<functionsDirectory>/graphql.mjs`
 ```js
-import { createHandler } from 'graphql-http/lib/use/netlify'; // npm install graphql-http
+import { createHandler } from 'graphql-http/lib/use/@netlify/functions'; // npm install @netlify/functions
 import { schema } from './previous-step';
 
 // Create the GraphQL over HTTP native fetch handler

docs/README.md

@@ -12,6 +12,7 @@ graphql-http
 - [client](modules/client.md)
 - [common](modules/common.md)
 - [handler](modules/handler.md)
+- [use/@netlify/functions](modules/use__netlify_functions.md)
 - [use/express](modules/use_express.md)
 - [use/fastify](modules/use_fastify.md)
 - [use/fetch](modules/use_fetch.md)

docs/modules/use__netlify_functions.md

@@ -0,0 +1,51 @@
+[graphql-http](../README.md) / use/@netlify/functions
+
+# Module: use/@netlify/functions
+
+## Table of contents
+
+### Type Aliases
+
+- [HandlerOptions](use__netlify_functions.md#handleroptions)
+
+### Functions
+
+- [createHandler](use__netlify_functions.md#createhandler)
+
+## Server/netlify
+
+### HandlerOptions
+
+Ƭ **HandlerOptions**<`Context`\>: [`HandlerOptions`](../interfaces/handler.HandlerOptions.md)<`HandlerEvent`, `HandlerContext`, `Context`\>
+
+Handler options when using the netlify adapter
+
+#### Type parameters
+
+| Name | Type |
+| :------ | :------ |
+| `Context` | extends [`OperationContext`](handler.md#operationcontext) = `undefined` |
+
+___
+
+### createHandler
+
+▸ **createHandler**<`Context`\>(`options`): `Handler`
+
+Create a GraphQL over HTTP spec compliant request handler for netlify functions
+
+#### Type parameters
+
+| Name | Type |
+| :------ | :------ |
+| `Context` | extends [`OperationContext`](handler.md#operationcontext) = `undefined` |
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `options` | [`HandlerOptions`](use__netlify_functions.md#handleroptions)<`Context`\> |
+
+#### Returns
+
+`Handler`

functions/graphql.mjs

@@ -0,0 +1,7 @@
+import { GraphQLSchema } from 'graphql';
+import { createHandler } from 'graphql-http/lib/use/@netlify/functions'; // npm install @netlify/functions
+
+const schema = new GraphQLSchema()
+
+// Create the GraphQL over HTTP native fetch handler
+export const handler = createHandler({ schema });

package.json

@@ -65,6 +65,11 @@
       "require": "./lib/use/fastify.js",
       "import": "./lib/use/fastify.mjs"
     },
+    "./lib/use/@netlify/functions": {
+      "types": "./lib/use/@netlify/functions.d.ts",
+      "require": "./lib/use/@netlify/functions.js",
+      "import": "./lib/use/@netlify/functions.mjs"
+    },
     "./lib/use/koa": {
       "types": "./lib/use/koa.d.ts",
       "require": "./lib/use/koa.js",

src/use/netlify.ts renamed to src/use/@netlify/functions.ts

@@ -2,7 +2,7 @@ import {
   createHandler as createRawHandler,
   HandlerOptions as RawHandlerOptions,
   OperationContext,
-} from '../handler';
+} from '../../handler';
 
 import type { Handler, HandlerEvent, HandlerContext } from '@netlify/functions';