more jsdoc and make req.respond await

http.ts

@@ -6,6 +6,7 @@ const dec = new TextDecoder()
 /**
  * Create a new GraphQL HTTP middleware with schema, context etc
  * @param {GraphQLOptions} options
+ *
  * @example
  * ```ts
  * const graphql = await GraphQLHTTP({ schema })
@@ -18,7 +19,7 @@ export function GraphQLHTTP<Req extends Request = Request, Ctx extends { request
 ) {
   return async (request: Req) => {
     if (!['PUT', 'POST', 'PATCH'].includes(request.method)) {
-      request.respond({
+      await request.respond({
         status: 405,
         body: 'Method Not Allowed'
       })
@@ -33,10 +34,10 @@ export function GraphQLHTTP<Req extends Request = Request, Ctx extends { request
           request
         })
 
-        request.respond({ body: JSON.stringify(result, null, 2), status: 200 })
+        await request.respond({ body: JSON.stringify(result, null, 2), status: 200 })
       } catch (e) {
         console.error(e)
-        request.respond({ status: 400, body: 'Malformed request body' })
+        await request.respond({ status: 400, body: 'Malformed request body' })
       }
     }
   }

types.ts

@@ -1,3 +1,6 @@
 import { ServerRequest } from 'https://deno.land/[email protected]/http/server.ts'
 
+/**
+ * Request type with only required properties
+ */
 export type Request = Pick<ServerRequest, 'respond' | 'body' | 'method'>