add __experimentalDeferFragmentSpreads flag

Author: lilianammmatos

src/type/schema.js

@@ -134,6 +134,8 @@ export class GraphQLSchema {
   _subTypeMap: ObjMap<ObjMap<boolean>>;
   // Used as a cache for validateSchema().
   __validationErrors: ?$ReadOnlyArray<GraphQLError>;
+  // Referenced by execute()
+  __experimentalDeferFragmentSpreads: boolean;
 
   constructor(config: $ReadOnly<GraphQLSchemaConfig>): void {
     // If this schema was built from a source known to be valid, then it may be
@@ -161,6 +163,8 @@ export class GraphQLSchema {
     this.astNode = config.astNode;
     this.extensionASTNodes = config.extensionASTNodes;
 
+    this.__experimentalDeferFragmentSpreads =
+      config.experimentalDeferFragmentSpreads || false;
     this._queryType = config.query;
     this._mutationType = config.mutation;
     this._subscriptionType = config.subscription;
@@ -304,6 +308,18 @@ export type GraphQLSchemaValidationOptions = {|
    * Default: false
    */
   assumeValid?: boolean,
+
+  /**
+   *
+   * EXPERIMENTAL:
+   *
+   * If enabled, processed fields from fragment spreads with @defer directive
+   * are not returned from the iniital query and the respective data is returned
+   * in patches after the initial result from the synchronous query.
+   *
+   * Default: false
+   */
+  experimentalDeferFragmentSpreads?: boolean,
 |};
 
 export type GraphQLSchemaConfig = {|