relay-compiler 1.3.0 → 1.5.0

package/lib/RelayCodeGenerator.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayCodeGenerator
  * 
@@ -13,51 +11,109 @@
 
 'use strict';
 
-var _toConsumableArray3 = _interopRequireDefault(require('babel-runtime/helpers/toConsumableArray'));
+var _require = require('relay-runtime'),
+    getStorageKey = _require.getStorageKey;
+// TODO T21875029 ../../relay-runtime/util/stableCopy
 
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
-var _require = require('graphql'),
-    GraphQLList = _require.GraphQLList;
+var _require2 = require('graphql'),
+    GraphQLList = _require2.GraphQLList;
 
-var getRawType = require('./GraphQLSchemaUtils').getRawType,
-    isAbstractType = require('./GraphQLSchemaUtils').isAbstractType,
-    getNullableType = require('./GraphQLSchemaUtils').getNullableType;
+var _require3 = require('./GraphQLCompilerPublic'),
+    IRVisitor = _require3.IRVisitor,
+    SchemaUtils = _require3.SchemaUtils;
 
-/* eslint-disable no-redeclare */
+// TODO T21875029 ../../relay-runtime/util/RelayConcreteNode
+
+
+var getRawType = SchemaUtils.getRawType,
+    isAbstractType = SchemaUtils.isAbstractType,
+    getNullableType = SchemaUtils.getNullableType;
 
 
 /**
  * @public
  *
- * Converts a Relay IR node into a plain JS object representation that can be
+ * Converts a GraphQLIR node into a plain JS object representation that can be
  * used at runtime.
  */
 function generate(node) {
-  require('fbjs/lib/invariant')(['Root', 'Fragment'].indexOf(node.kind) >= 0, 'RelayCodeGenerator: Unknown AST kind `%s`. Source: %s.', node.kind, getErrorMessage(node));
-  return require('./RelayIRVisitor').visit(node, RelayCodeGenVisitor);
+  require('fbjs/lib/invariant')(['Batch', 'Fragment'].indexOf(node.kind) >= 0, 'RelayCodeGenerator: Unknown AST kind `%s`. Source: %s.', node.kind, getErrorMessage(node));
+  return IRVisitor.visit(node, RelayCodeGenVisitor);
 }
-/* eslint-enable no-redeclare */
 
 var RelayCodeGenVisitor = {
   leave: {
-    Root: function Root(node) {
-      return {
-        argumentDefinitions: node.argumentDefinitions,
-        kind: 'Root',
-        name: node.name,
-        operation: node.operation,
-        selections: flattenArray(node.selections)
-      };
+    Batch: function Batch(node) {
+      require('fbjs/lib/invariant')(node.requests.length !== 0, 'Batch must contain Requests.');
+      if (isSingleRequest(node)) {
+        var request = node.requests[0];
+        return {
+          kind: 'Request',
+          operationKind: request.root.operation,
+          name: node.name,
+          id: request.id,
+          text: request.text,
+          metadata: node.metadata,
+          fragment: node.fragment,
+          operation: {
+            kind: 'Operation',
+            name: request.root.name,
+            argumentDefinitions: request.root.argumentDefinitions,
+            selections: flattenArray(request.root.selections)
+          }
+        };
+      } else {
+        return {
+          kind: 'BatchRequest',
+          operationKind: node.requests[0].root.operation,
+          name: node.name,
+          metadata: node.metadata,
+          fragment: node.fragment,
+          requests: node.requests.map(function (request) {
+            var isDeferrableFragment = request.metadata && request.metadata.deferrable;
+            var operation = isDeferrableFragment ? {
+              kind: 'DeferrableOperation',
+              name: request.root.name,
+              argumentDefinitions: request.root.argumentDefinitions,
+              selections: flattenArray(request.root.selections),
+              fragmentName: request.metadata.fragmentName,
+              rootFieldVariable: request.metadata.rootFieldVariable
+            } : {
+              kind: 'Operation',
+              name: request.root.name,
+              argumentDefinitions: request.root.argumentDefinitions,
+              selections: flattenArray(request.root.selections)
+            };
+
+            return {
+              name: request.name,
+              id: request.id,
+              text: request.text,
+              argumentDependencies: request.argumentDependencies.map(function (dependency) {
+                return {
+                  name: dependency.argumentName,
+                  fromRequestName: dependency.fromName,
+                  fromRequestPath: dependency.fromPath,
+                  ifList: dependency.ifList,
+                  ifNull: dependency.ifNull,
+                  maxRecurse: dependency.maxRecurse
+                };
+              }),
+              operation: operation
+            };
+          })
+        };
+      }
     },
     Fragment: function Fragment(node) {
       return {
-        argumentDefinitions: node.argumentDefinitions,
         kind: 'Fragment',
-        metadata: node.metadata || null,
         name: node.name,
-        selections: flattenArray(node.selections),
-        type: node.type.toString()
+        type: node.type.toString(),
+        metadata: node.metadata || null,
+        argumentDefinitions: node.argumentDefinitions,
+        selections: flattenArray(node.selections)
       };
     },
     LocalArgumentDefinition: function LocalArgumentDefinition(node) {
@@ -91,6 +147,15 @@ var RelayCodeGenVisitor = {
         args: valuesOrNull(sortByName(node.args))
       };
     },
+    DeferrableFragmentSpread: function DeferrableFragmentSpread(node) {
+      return {
+        kind: 'DeferrableFragmentSpread',
+        name: node.name,
+        args: node.args,
+        rootFieldVariable: node.rootFieldVariable,
+        storageKey: node.storageKey
+      };
+    },
     InlineFragment: function InlineFragment(node) {
       return {
         kind: 'InlineFragment',
@@ -99,49 +164,61 @@ var RelayCodeGenVisitor = {
       };
     },
     LinkedField: function LinkedField(node) {
+      // Note: it is important that the arguments of this field be sorted to
+      // ensure stable generation of storage keys for equivalent arguments
+      // which may have originally appeared in different orders across an app.
       var handles = node.handles && node.handles.map(function (handle) {
         return {
           kind: 'LinkedHandle',
           alias: node.alias,
+          name: node.name,
           args: valuesOrNull(sortByName(node.args)),
           handle: handle.name,
-          name: node.name,
           key: handle.key,
           filters: handle.filters
         };
       }) || [];
       var type = getRawType(node.type);
-      return [{
+      var field = {
         kind: 'LinkedField',
         alias: node.alias,
+        name: node.name,
+        storageKey: null,
         args: valuesOrNull(sortByName(node.args)),
         concreteType: !isAbstractType(type) ? type.toString() : null,
-        name: node.name,
         plural: isPlural(node.type),
-        selections: flattenArray(node.selections),
-        storageKey: getStorageKey(node.name, node.args)
-      }].concat((0, _toConsumableArray3['default'])(handles));
+        selections: flattenArray(node.selections)
+      };
+      // Precompute storageKey if possible
+      field.storageKey = getStaticStorageKey(field);
+      return [field].concat(handles);
     },
     ScalarField: function ScalarField(node) {
+      // Note: it is important that the arguments of this field be sorted to
+      // ensure stable generation of storage keys for equivalent arguments
+      // which may have originally appeared in different orders across an app.
       var handles = node.handles && node.handles.map(function (handle) {
         return {
           kind: 'ScalarHandle',
           alias: node.alias,
+          name: node.name,
           args: valuesOrNull(sortByName(node.args)),
           handle: handle.name,
-          name: node.name,
           key: handle.key,
           filters: handle.filters
         };
       }) || [];
-      return [{
+      var field = {
         kind: 'ScalarField',
         alias: node.alias,
-        args: valuesOrNull(sortByName(node.args)),
         name: node.name,
+        args: valuesOrNull(sortByName(node.args)),
         selections: valuesOrUndefined(flattenArray(node.selections)),
-        storageKey: getStorageKey(node.name, node.args)
-      }].concat((0, _toConsumableArray3['default'])(handles));
+        storageKey: null
+      };
+      // Precompute storageKey if possible
+      field.storageKey = getStaticStorageKey(field);
+      return [field].concat(handles);
     },
     Variable: function Variable(node, key, parent) {
       return {
@@ -155,17 +232,21 @@ var RelayCodeGenVisitor = {
       return {
         kind: 'Literal',
         name: parent.name,
-        value: node.value,
+        value: require('./stableCopy')(node.value),
         type: parent.type ? parent.type.toString() : null
       };
     },
     Argument: function Argument(node, key, parent, ancestors) {
-      require('fbjs/lib/invariant')(['Variable', 'Literal'].indexOf(node.value.kind) >= 0, 'RelayCodeGenerator: Complex argument values (Lists or ' + 'InputObjects with nested variables) are not supported, argument ' + '`%s` had value `%s`. Source: %s.', node.name, require('./prettyStringify')(node.value), getErrorMessage(ancestors[0]));
+      require('fbjs/lib/invariant')(['Variable', 'Literal'].indexOf(node.value.kind) >= 0, 'RelayCodeGenerator: Complex argument values (Lists or ' + 'InputObjects with nested variables) are not supported, argument ' + '`%s` had value `%s`. Source: %s.', node.name, JSON.stringify(node.value, null, 2), getErrorMessage(ancestors[0]));
       return node.value.value !== null ? node.value : null;
     }
   }
 };
 
+function isSingleRequest(batch) {
+  return batch.requests.length === 1 && batch.requests[0].argumentDependencies.length === 0;
+}
+
 function isPlural(type) {
   return getNullableType(type) instanceof GraphQLList;
 }
@@ -193,28 +274,17 @@ function getErrorMessage(node) {
 }
 
 /**
- * Computes storage key if possible.
- *
- * Storage keys which can be known ahead of runtime are:
- *
- * - Fields that do not take arguments.
- * - Fields whose arguments are all statically known (ie. literals) at build
- *   time.
+ * Pre-computes storage key if possible and advantageous. Storage keys are
+ * generated for fields with supplied arguments that are all statically known
+ * (ie. literals, no variables) at build time.
  */
-function getStorageKey(fieldName, args) {
-  if (!args || !args.length) {
+function getStaticStorageKey(field) {
+  if (!field.args || field.args.length === 0 || field.args.some(function (arg) {
+    return arg.kind !== 'Literal';
+  })) {
     return null;
   }
-  var isLiteral = true;
-  var preparedArgs = {};
-  args.forEach(function (arg) {
-    if (arg.kind !== 'Literal') {
-      isLiteral = false;
-    } else {
-      preparedArgs[arg.name] = arg.value;
-    }
-  });
-  return isLiteral ? require('./formatStorageKey')(fieldName, preparedArgs) : null;
+  return getStorageKey(field, {});
 }
 
 module.exports = { generate: generate };

package/lib/RelayCompilerBin.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * 
  * @providesModule RelayCompilerBin
@@ -19,10 +17,8 @@ var _asyncToGenerator3 = _interopRequireDefault(_asyncToGenerator2);
 
 var _toConsumableArray3 = _interopRequireDefault(require('babel-runtime/helpers/toConsumableArray'));
 
-/* eslint-disable no-console-disallow */
-
 let run = (() => {
-  var _ref = (0, _asyncToGenerator3.default)(function* (options) {
+  var _ref2 = (0, _asyncToGenerator3.default)(function* (options) {
     var schemaPath = require('path').resolve(process.cwd(), options.schema);
     if (!require('fs').existsSync(schemaPath)) {
       throw new Error('--schema path does not exist: ' + schemaPath + '.');
@@ -37,39 +33,67 @@ let run = (() => {
     if (options.watch && !hasWatchmanRootFile(srcDir)) {
       throw new Error(('\n--watch requires that the src directory have a valid watchman "root" file.\n\nRoot files can include:\n- A .git/ Git folder\n- A .hg/ Mercurial folder\n- A .watchmanconfig file\n\nEnsure that one such file exists in ' + srcDir + ' or its parents.\n    ').trim());
     }
+    if (options.verbose && options.quiet) {
+      throw new Error("I can't be quiet and verbose at the same time");
+    }
 
-    var reporter = new (require('./RelayConsoleReporter'))({ verbose: options.verbose });
+    var reporter = new ConsoleReporter({
+      verbose: options.verbose,
+      quiet: options.quiet
+    });
 
-    var useWatchman = options.watchman && (yield require('./RelayWatchmanClient').isAvailable());
+    var useWatchman = options.watchman && (yield WatchmanClient.isAvailable());
 
+    var schema = getSchema(schemaPath);
     var parserConfigs = {
-      'default': {
+      js: {
         baseDir: srcDir,
-        getFileFilter: require('./RelayFileIRParser').getFileFilter,
-        getParser: require('./RelayFileIRParser').getParser,
+        getFileFilter: require('./RelayJSModuleParser').getFileFilter,
+        getParser: require('./RelayJSModuleParser').getParser,
         getSchema: function getSchema() {
-          return _getSchema(schemaPath);
+          return schema;
         },
         watchmanExpression: useWatchman ? buildWatchExpression(options) : null,
         filepaths: useWatchman ? null : getFilepathsFromGlob(srcDir, options)
+      },
+      graphql: {
+        baseDir: srcDir,
+        getParser: DotGraphQLParser.getParser,
+        getSchema: function getSchema() {
+          return schema;
+        },
+        watchmanExpression: useWatchman ? buildWatchExpression({
+          extensions: ['graphql'],
+          include: options.include,
+          exclude: options.exclude
+        }) : null,
+        filepaths: useWatchman ? null : getFilepathsFromGlob(srcDir, {
+          extensions: ['graphql'],
+          include: options.include,
+          exclude: options.exclude
+        })
       }
     };
     var writerConfigs = {
-      'default': {
+      js: {
         getWriter: getRelayFileWriter(srcDir),
         isGeneratedFile: function isGeneratedFile(filePath) {
           return filePath.endsWith('.js') && filePath.includes('__generated__');
         },
-        parser: 'default'
+        parser: 'js',
+        baseParsers: ['graphql']
       }
     };
-    var codegenRunner = new (require('./RelayCodegenRunner'))({
+    var codegenRunner = new CodegenRunner({
       reporter: reporter,
       parserConfigs: parserConfigs,
       writerConfigs: writerConfigs,
-      onlyValidate: options.validate
+      onlyValidate: options.validate,
+      // TODO: allow passing in a flag or detect?
+      sourceControl: null
     });
     if (!options.validate && !options.watch && options.watchman) {
+      // eslint-disable-next-line no-console
       console.log('HINT: pass --watch to keep watching for changes.');
     }
     var result = options.watch ? yield codegenRunner.watchAll() : yield codegenRunner.compileAll();
@@ -83,7 +107,7 @@ let run = (() => {
   });
 
   return function run(_x) {
-    return _ref.apply(this, arguments);
+    return _ref2.apply(this, arguments);
   };
 })();
 
@@ -91,13 +115,20 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'd
 
 require('babel-polyfill');
 
-var _require = require('graphql'),
-    buildASTSchema = _require.buildASTSchema,
-    buildClientSchema = _require.buildClientSchema,
-    parse = _require.parse,
-    printSchema = _require.printSchema;
+var _require = require('./GraphQLCompilerPublic'),
+    CodegenRunner = _require.CodegenRunner,
+    ConsoleReporter = _require.ConsoleReporter,
+    WatchmanClient = _require.WatchmanClient,
+    DotGraphQLParser = _require.DotGraphQLParser;
+
+var _require2 = require('graphql'),
+    buildASTSchema = _require2.buildASTSchema,
+    buildClientSchema = _require2.buildClientSchema,
+    parse = _require2.parse,
+    printSchema = _require2.printSchema;
 
-var codegenTransforms = require('./RelayIRTransforms').codegenTransforms,
+var commonTransforms = require('./RelayIRTransforms').commonTransforms,
+    codegenTransforms = require('./RelayIRTransforms').codegenTransforms,
     fragmentTransforms = require('./RelayIRTransforms').fragmentTransforms,
     printTransforms = require('./RelayIRTransforms').printTransforms,
     queryTransforms = require('./RelayIRTransforms').queryTransforms,
@@ -122,46 +153,55 @@ function getFilepathsFromGlob(baseDir, options) {
     return inc + '/*.+(' + extensions.join('|') + ')';
   });
 
-  // $FlowFixMe(site=react_native_fb,www)
   var glob = require('fast-glob');
   return glob.sync(patterns, {
     cwd: baseDir,
-    bashNative: [],
-    onlyFiles: true,
     ignore: exclude
   });
 }
 
 function getRelayFileWriter(baseDir) {
-  return function (onlyValidate, schema, documents, baseDocuments) {
+  return function (_ref) {
+    var onlyValidate = _ref.onlyValidate,
+        schema = _ref.schema,
+        documents = _ref.documents,
+        baseDocuments = _ref.baseDocuments,
+        sourceControl = _ref.sourceControl,
+        reporter = _ref.reporter;
     return new (require('./RelayFileWriter'))({
       config: {
-        formatModule: require('./formatGeneratedModule'),
+        baseDir: baseDir,
         compilerTransforms: {
+          commonTransforms: commonTransforms,
           codegenTransforms: codegenTransforms,
           fragmentTransforms: fragmentTransforms,
           printTransforms: printTransforms,
           queryTransforms: queryTransforms
         },
-        baseDir: baseDir,
-        schemaExtensions: schemaExtensions
+        customScalars: {},
+        formatModule: require('./formatGeneratedModule'),
+        inputFieldWhiteListForFlow: [],
+        schemaExtensions: schemaExtensions,
+        useHaste: false
       },
       onlyValidate: onlyValidate,
       schema: schema,
       baseDocuments: baseDocuments,
-      documents: documents
+      documents: documents,
+      reporter: reporter,
+      sourceControl: sourceControl
     });
   };
 }
 
-function _getSchema(schemaPath) {
+function getSchema(schemaPath) {
   try {
     var source = require('fs').readFileSync(schemaPath, 'utf8');
     if (require('path').extname(schemaPath) === '.json') {
       source = printSchema(buildClientSchema(JSON.parse(source).data));
     }
-    source = '\n  directive @include(if: Boolean) on FRAGMENT | FIELD\n  directive @skip(if: Boolean) on FRAGMENT | FIELD\n\n  ' + source + '\n  ';
-    return buildASTSchema(parse(source));
+    source = '\n  directive @include(if: Boolean) on FRAGMENT_SPREAD | FIELD\n  directive @skip(if: Boolean) on FRAGMENT_SPREAD | FIELD\n\n  ' + source + '\n  ';
+    return buildASTSchema(parse(source), { assumeValid: true });
   } catch (error) {
     throw new Error(('\nError loading schema. Expected the schema to be a .graphql or a .json\nfile, describing your GraphQL server\'s API. Error detail:\n\n' + error.stack + '\n    ').trim());
   }
@@ -216,6 +256,10 @@ var argv = require('yargs').usage('Create Relay generated files\n\n' + '$0 --sch
     describe: 'More verbose logging',
     type: 'boolean'
   },
+  quiet: {
+    describe: 'No output to stdout',
+    type: 'boolean'
+  },
   watchman: {
     describe: 'Use watchman when not in watch mode',
     type: 'boolean',
@@ -233,6 +277,7 @@ var argv = require('yargs').usage('Create Relay generated files\n\n' + '$0 --sch
 }).help().argv;
 
 // Run script with args
+// $FlowFixMe: Invalid types for yargs. Please fix this when touching this code.
 run(argv)['catch'](function (error) {
   console.error(String(error.stack || error));
   process.exit(1);

package/lib/RelayCompilerCache.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayCompilerCache
  * 
@@ -17,10 +15,15 @@ var _classCallCheck3 = _interopRequireDefault(require('babel-runtime/helpers/cla
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
+var _require = require('./GraphQLCompilerPublic'),
+    Profiler = _require.Profiler;
+
 /**
  * A file backed cache. Values are JSON encoded on disk, so only JSON
  * serializable values should be used.
  */
+
+
 var RelayCompilerCache = function () {
 
   /**
@@ -42,13 +45,17 @@ var RelayCompilerCache = function () {
   }
 
   RelayCompilerCache.prototype.getOrCompute = function getOrCompute(key, compute) {
-    var cacheFile = require('path').join(this._dir, key);
-    if (require('fs').existsSync(cacheFile)) {
-      return JSON.parse(require('fs').readFileSync(cacheFile, 'utf8'));
-    }
-    var value = compute();
-    require('fs').writeFileSync(cacheFile, JSON.stringify(value), 'utf8');
-    return value;
+    var _this = this;
+
+    return Profiler.run('RelayCompilerCache.getOrCompute', function () {
+      var cacheFile = require('path').join(_this._dir, key);
+      if (require('fs').existsSync(cacheFile)) {
+        return JSON.parse(require('fs').readFileSync(cacheFile, 'utf8'));
+      }
+      var value = compute();
+      require('fs').writeFileSync(cacheFile, JSON.stringify(value), 'utf8');
+      return value;
+    });
   };
 
   return RelayCompilerCache;

package/lib/RelayCompilerPublic.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * 
  * @providesModule RelayCompilerPublic
@@ -13,13 +11,29 @@
 
 'use strict';
 
+var _require = require('./GraphQLCompilerPublic'),
+    ASTConvert = _require.ASTConvert,
+    CodegenRunner = _require.CodegenRunner,
+    ConsoleReporter = _require.ConsoleReporter,
+    MultiReporter = _require.MultiReporter;
+
 module.exports = {
-  Compiler: require('./RelayCompiler'),
-  ConsoleReporter: require('./RelayConsoleReporter'),
-  FileIRParser: require('./RelayFileIRParser'),
+  ConsoleReporter: ConsoleReporter,
+  Parser: require('./RelayParser'),
+  CodeGenerator: require('./RelayCodeGenerator'),
+
+  GraphQLCompilerContext: require('./GraphQLCompilerContext'),
+
+  /** @deprecated Use JSModuleParser. */
+  FileIRParser: require('./RelayJSModuleParser'),
+
   FileWriter: require('./RelayFileWriter'),
   IRTransforms: require('./RelayIRTransforms'),
-  MultiReporter: require('./RelayMultiReporter'),
-  Runner: require('./RelayCodegenRunner'),
-  formatGeneratedModule: require('./formatGeneratedModule')
+  JSModuleParser: require('./RelayJSModuleParser'),
+  MultiReporter: MultiReporter,
+  Runner: CodegenRunner,
+  compileRelayArtifacts: require('./compileRelayArtifacts'),
+  formatGeneratedModule: require('./formatGeneratedModule'),
+  convertASTDocuments: ASTConvert.convertASTDocuments,
+  transformASTSchema: ASTConvert.transformASTSchema
 };

package/lib/RelayCompilerScope.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayCompilerScope
  *