Added new 'FormattedExecutionResult' type

Back port of #2688

Author: IvanGoncharov

src/execution/execute.js

@@ -16,6 +16,7 @@ import promiseForObject from '../jsutils/promiseForObject';
 import { type PromiseOrValue } from '../jsutils/PromiseOrValue';
 import { type Path, addPath, pathToArray } from '../jsutils/Path';
 
+import { type GraphQLFormattedError } from '../error/formatError';
 import { GraphQLError } from '../error/GraphQLError';
 import { locatedError } from '../error/locatedError';
 
@@ -117,6 +118,12 @@ export type ExecutionResult = {
   ...
 };
 
+export type FormattedExecutionResult = {|
+  errors?: $ReadOnlyArray<GraphQLFormattedError>,
+  data?: ObjMap<mixed> | null,
+  extensions?: ObjMap<mixed>,
+|};
+
 export type ExecutionArgs = {|
   schema: GraphQLSchema,
   document: DocumentNode,

src/execution/index.js

@@ -3,6 +3,10 @@
 export { pathToArray as responsePathAsArray } from '../jsutils/Path';
 
 export { execute, defaultFieldResolver, defaultTypeResolver } from './execute';
-export type { ExecutionArgs, ExecutionResult } from './execute';
+export type {
+  ExecutionArgs,
+  ExecutionResult,
+  FormattedExecutionResult,
+} from './execute';
 
 export { getDirectiveValues } from './values';

src/index.js

@@ -288,7 +288,11 @@ export {
   getDirectiveValues,
 } from './execution';
 
-export type { ExecutionArgs, ExecutionResult } from './execution';
+export type {
+  ExecutionArgs,
+  ExecutionResult,
+  FormattedExecutionResult,
+} from './execution';
 
 export { subscribe, createSourceEventStream } from './subscription';
 export type { SubscriptionArgs } from './subscription';

tstypes/execution/execute.d.ts

@@ -3,7 +3,7 @@ import { PromiseOrValue } from '../jsutils/PromiseOrValue';
 import { Path, addPath, pathToArray } from '../jsutils/Path';
 
 import { GraphQLError } from '../error/GraphQLError';
-import { locatedError } from '../error/locatedError';
+import { GraphQLFormattedError } from '../error/formatError';
 
 import {
   DirectiveNode,
@@ -56,6 +56,12 @@ export interface ExecutionResult<TData = ExecutionResultDataDefault> {
   data?: TData | null;
 }
 
+export interface FormattedExecutionResult<TData = ExecutionResultDataDefault> {
+  errors?: ReadonlyArray<GraphQLFormattedError>;
+  // TS_SPECIFIC: TData. Motivation: https://github.com/graphql/graphql-js/pull/2490#issuecomment-639154229
+  data?: TData | null;
+}
+
 export type ExecutionArgs = {
   schema: GraphQLSchema;
   document: DocumentNode;

tstypes/execution/index.d.ts

@@ -6,6 +6,7 @@ export {
   defaultTypeResolver,
   ExecutionArgs,
   ExecutionResult,
+  FormattedExecutionResult,
 } from './execute';
 
 export { getDirectiveValues } from './values';

tstypes/index.d.ts

@@ -287,6 +287,7 @@ export {
   getDirectiveValues,
   ExecutionArgs,
   ExecutionResult,
+  FormattedExecutionResult,
 } from './execution';
 
 export {