merge from master

Author: Carglass

.eslintrc.yml

@@ -253,7 +253,7 @@ rules:
   operator-assignment: [error, always]
   padding-line-between-statements: off
   prefer-object-spread: error
-  quotes: [error, single, { avoidEscape: true, allowTemplateLiterals: true }]
+  quotes: [error, single, { avoidEscape: true, allowTemplateLiterals: false }]
   sort-keys: off
   sort-vars: off
   spaced-comment: [error, always]

.npmignore

@@ -12,11 +12,13 @@ package-lock.json
 .babelrc
 .nycrc
 .nyc_output
+codecov.yml
 CONTRIBUTING.md
 node_modules
 coverage
 resources
 src
+docs
 dist
 __tests__
 npm

.travis.yml

@@ -11,12 +11,16 @@ node_js:
   - '8'
   - '6'
 
-script: npm run testonly
+script: |
+  if [[ "$(node -pe process.version)" == v10.* ]]; then # Is latest LTS?
+    npm run test:ci &&
+    bash <(curl -s https://codecov.io/bash) -f coverage/coverage-final.json
+  else
+    npm run testonly
+  fi
 
 jobs:
   include:
-    - node_js: 'lts/*'
-      script: npm run test:ci && bash <(curl -s https://codecov.io/bash) -f coverage/coverage-final.json
     - stage: deploy
       if: branch = master OR tag IS present
       script: echo "Deploying..."

docs/APIReference-Errors.md

@@ -0,0 +1,109 @@
+---
+title: graphql/error
+layout: ../_core/GraphQLJSLayout
+category: API Reference
+permalink: /graphql-js/error/
+sublinks: formatError,GraphQLError,locatedError,syntaxError
+next: /graphql-js/execution/
+---
+
+The `graphql/error` module is responsible for creating and formatting
+GraphQL errors. You can import either from the `graphql/error` module, or from the root `graphql` module. For example:
+
+```js
+import { GraphQLError } from 'graphql'; // ES6
+var { GraphQLError } = require('graphql'); // CommonJS
+```
+
+## Overview
+
+<ul class="apiIndex">
+  <li>
+    <a href="#graphqlerror">
+      <pre>class GraphQLError</pre>
+      A representation of an error that occurred within GraphQL.
+    </a>
+  </li>
+  <li>
+    <a href="#syntaxerror">
+      <pre>function syntaxError</pre>
+      Produces a GraphQLError representing a syntax error.
+    </a>
+  </li>
+  <li>
+    <a href="#locatedError">
+      <pre>function locatedError</pre>
+      Produces a new GraphQLError aware of the location responsible for the error.
+    </a>
+  </li>
+  <li>
+    <a href="#formaterror">
+      <pre>function formatError</pre>
+      Format an error according to the rules described by the Response Format.
+    </a>
+  </li>
+</ul>
+
+## Errors
+
+### GraphQLError
+
+```js
+class GraphQLError extends Error {
+ constructor(
+   message: string,
+   nodes?: Array<any>,
+   stack?: ?string,
+   source?: Source,
+   positions?: Array<number>,
+   originalError?: ?Error,
+   extensions?: ?{ [key: string]: mixed }
+ )
+}
+```
+
+A representation of an error that occurred within GraphQL. Contains
+information about where in the query the error occurred for debugging. Most
+commonly constructed with `locatedError` below.
+
+### syntaxError
+
+```js
+function syntaxError(
+  source: Source,
+  position: number,
+  description: string
+): GraphQLError;
+```
+
+Produces a GraphQLError representing a syntax error, containing useful
+descriptive information about the syntax error's position in the source.
+
+### locatedError
+
+```js
+function locatedError(error: ?Error, nodes: Array<any>): GraphQLError {
+```
+
+Given an arbitrary Error, presumably thrown while attempting to execute a
+GraphQL operation, produce a new GraphQLError aware of the location in the
+document responsible for the original Error.
+
+### formatError
+
+```js
+function formatError(error: GraphQLError): GraphQLFormattedError
+
+type GraphQLFormattedError = {
+  message: string,
+  locations: ?Array<GraphQLErrorLocation>
+};
+
+type GraphQLErrorLocation = {
+  line: number,
+  column: number
+};
+```
+
+Given a GraphQLError, format it according to the rules described by the
+Response Format, Errors section of the GraphQL Specification.

docs/APIReference-Execution.md

@@ -0,0 +1,60 @@
+---
+title: graphql/execution
+layout: ../_core/GraphQLJSLayout
+category: API Reference
+permalink: /graphql-js/execution/
+sublinks: execute
+next: /graphql-js/language/
+---
+
+The `graphql/execution` module is responsible for the execution phase of
+fulfilling a GraphQL request. You can import either from the `graphql/execution` module, or from the root `graphql` module. For example:
+
+```js
+import { execute } from 'graphql'; // ES6
+var { execute } = require('graphql'); // CommonJS
+```
+
+## Overview
+
+<ul class="apiIndex">
+  <li>
+    <a href="#execute">
+      <pre>function execute</pre>
+      Executes a GraphQL request on the provided schema.
+    </a>
+  </li>
+</ul>
+
+## Execution
+
+### execute
+
+```js
+export function execute(
+  schema: GraphQLSchema,
+  documentAST: Document,
+  rootValue?: mixed,
+  contextValue?: mixed,
+  variableValues?: ?{[key: string]: mixed},
+  operationName?: ?string
+): MaybePromise<ExecutionResult>
+
+type MaybePromise<T> = Promise<T> | T;
+
+type ExecutionResult = {
+  data: ?Object;
+  errors?: Array<GraphQLError>;
+}
+```
+
+Implements the "Evaluating requests" section of the GraphQL specification.
+
+Returns a Promise that will eventually be resolved and never rejected.
+
+If the arguments to this function do not result in a legal execution context,
+a GraphQLError will be thrown immediately explaining the invalid input.
+
+`ExecutionResult` represents the result of execution. `data` is the result of
+executing the query, `errors` is null if no errors occurred, and is a
+non-empty array if an error occurred.

docs/APIReference-ExpressGraphQL.md

@@ -0,0 +1,35 @@
+---
+title: express-graphql
+layout: ../_core/GraphQLJSLayout
+category: API Reference
+permalink: /graphql-js/express-graphql/
+sublinks: graphqlHTTP
+next: /graphql-js/graphql/
+---
+
+The `express-graphql` module provides a simple way to create an [Express](https://expressjs.com/) server that runs a GraphQL API.
+
+```js
+import graphqlHTTP from 'express-graphql'; // ES6
+var graphqlHTTP = require('express-graphql'); // CommonJS
+```
+
+### graphqlHTTP
+
+```js
+graphqlHTTP({
+  schema: GraphQLSchema,
+  graphiql?: ?boolean,
+  rootValue?: ?any,
+  context?: ?any,
+  pretty?: ?boolean,
+  formatError?: ?Function,
+  validationRules?: ?Array<any>,
+}): Middleware
+```
+
+Constructs an Express application based on a GraphQL schema.
+
+See the [express-graphql tutorial](/graphql-js/running-an-express-graphql-server/) for sample usage.
+
+See the [GitHub README](https://github.com/graphql/express-graphql) for more extensive documentation of the details of this method.