expose all of the execution environment to resolvers

presumably we should do this

Author: yaacovCR

src/execution/__tests__/executor-test.ts

@@ -215,7 +215,8 @@ describe('Execute: Handles basic execution tasks', () => {
 
     expect(resolvedInfo).to.have.all.keys(
       'fieldName',
-      'fieldNodes',
+      'fieldSet',
+      'deferDepth',
       'returnType',
       'parentType',
       'path',
@@ -238,9 +239,10 @@ describe('Execute: Handles basic execution tasks', () => {
       operation,
     });
 
-    const field = operation.selectionSet.selections[0];
+    const fieldNode = operation.selectionSet.selections[0];
     expect(resolvedInfo).to.deep.include({
-      fieldNodes: [field],
+      fieldSet: [{ fieldNode, depth: 0, deferDepth: undefined }],
+      deferDepth: undefined,
       variableValues: { var: 'abc' },
     });
 

src/execution/execute.ts

@@ -786,6 +786,7 @@ function executeField(
     fieldSet,
     parentType,
     path,
+    asyncPayloadRecord,
   );
 
   // Get the resolve function, regardless of if its result is normal or abrupt (error).
@@ -865,12 +866,14 @@ export function buildResolveInfo(
   fieldSet: FieldSet,
   parentType: GraphQLObjectType,
   path: Path,
+  asyncPayloadRecord?: AsyncPayloadRecord | undefined,
 ): GraphQLResolveInfo {
   // The resolve function's optional fourth argument is a collection of
   // information about the current execution state.
   return {
     fieldName: fieldDef.name,
-    fieldNodes: fieldSet.map(({ fieldNode }) => fieldNode),
+    fieldSet,
+    deferDepth: asyncPayloadRecord?.deferDepth,
     returnType: fieldDef.type,
     parentType,
     path,

src/type/definition.ts

@@ -890,7 +890,12 @@ export type GraphQLFieldResolver<
 
 export interface GraphQLResolveInfo {
   readonly fieldName: string;
-  readonly fieldNodes: ReadonlyArray<FieldNode>;
+  readonly fieldSet: ReadonlyArray<{
+    fieldNode: FieldNode;
+    depth: number;
+    deferDepth: number | undefined;
+  }>;
+  readonly deferDepth: number | undefined;
   readonly returnType: GraphQLOutputType;
   readonly parentType: GraphQLObjectType;
   readonly path: Path;