relay-compiler 10.0.1 → 10.1.3

package/language/javascript/RelayFlowGenerator.js.flow

@@ -19,6 +19,7 @@ const MatchTransform = require('../../transforms/MatchTransform');
 const Profiler = require('../../core/GraphQLCompilerProfiler');
 const RefetchableFragmentTransform = require('../../transforms/RefetchableFragmentTransform');
 const RelayDirectiveTransform = require('../../transforms/RelayDirectiveTransform');
+const RequiredFieldTransform = require('../../transforms/RequiredFieldTransform');
 
 const generateAbstractTypeRefinementKey = require('../../util/generateAbstractTypeRefinementKey');
 const partitionArray = require('../../util/partitionArray');
@@ -49,8 +50,11 @@ import type {
   Directive,
   Metadata,
   ModuleImport,
+  Selection as IRSelection,
 } from '../../core/IR';
+import type {NodeVisitor} from '../../core/IRVisitor';
 import type {Schema, TypeID, EnumTypeID} from '../../core/Schema';
+import type {RequiredDirectiveMetadata} from '../../transforms/RequiredFieldTransform';
 import type {TypeGeneratorOptions} from '../RelayLanguagePluginInterface';
 
 const babelGenerator = require('@babel/generator').default;
@@ -281,7 +285,10 @@ function isPlural(node: Fragment): boolean {
   return Boolean(node.metadata && node.metadata.plural);
 }
 
-function createVisitor(schema: Schema, options: TypeGeneratorOptions) {
+function createVisitor(
+  schema: Schema,
+  options: TypeGeneratorOptions,
+): NodeVisitor {
   const state = {
     customScalars: options.customScalars,
     enumsHasteModule: options.enumsHasteModule,
@@ -298,22 +305,31 @@ function createVisitor(schema: Schema, options: TypeGeneratorOptions) {
   };
   return {
     leave: {
-      Root(node) {
+      Root(node: Root) {
         const inputVariablesType = generateInputVariablesType(
           schema,
           node,
           state,
         );
         const inputObjectTypes = generateInputObjectTypes(state);
+
+        let responseTypeDefinition = selectionsToBabel(
+          schema,
+          /* $FlowFixMe: selections have already been transformed */
+          (node.selections: $ReadOnlyArray<$ReadOnlyArray<Selection>>),
+          state,
+          false,
+        );
+
+        if (node.metadata?.childrenCanBubbleNull === true) {
+          responseTypeDefinition = t.nullableTypeAnnotation(
+            responseTypeDefinition,
+          );
+        }
+
         const responseType = exportType(
           `${node.name}Response`,
-          selectionsToBabel(
-            schema,
-            // $FlowFixMe[incompatible-cast] : selections have already been transformed
-            (node.selections: $ReadOnlyArray<$ReadOnlyArray<Selection>>),
-            state,
-            false,
-          ),
+          responseTypeDefinition,
         );
 
         const operationTypes = [
@@ -441,9 +457,12 @@ function createVisitor(schema: Schema, options: TypeGeneratorOptions) {
           unmasked,
           unmasked ? undefined : getOldFragmentTypeName(node.name),
         );
-        const type = isPluralFragment
-          ? readOnlyArrayOfType(baseType)
-          : baseType;
+        let type = isPluralFragment ? readOnlyArrayOfType(baseType) : baseType;
+
+        if (node.metadata?.childrenCanBubbleNull === true) {
+          type = t.nullableTypeAnnotation(type);
+        }
+
         state.runtimeImports.add('FragmentReference');
 
         return t.program([
@@ -489,7 +508,9 @@ function createVisitor(schema: Schema, options: TypeGeneratorOptions) {
       ScalarField(node) {
         return visitScalarField(schema, node, state);
       },
-      LinkedField: visitLinkedField,
+      LinkedField(node) {
+        return visitLinkedField(schema, node);
+      },
       ModuleImport(node) {
         return [
           {
@@ -536,22 +557,55 @@ function visitNodeWithSelectionsOnly(node) {
   );
 }
 
-function visitScalarField(schema, node, state) {
+function visitScalarField(schema: Schema, node, state: State) {
+  const requiredMetadata: ?RequiredDirectiveMetadata = (node.metadata
+    ?.required: $FlowFixMe);
+  const nodeType =
+    requiredMetadata != null ? schema.getNonNullType(node.type) : node.type;
   return [
     {
       key: node.alias,
       schemaName: node.name,
-      value: transformScalarType(schema, node.type, state),
+      value: transformScalarType(schema, nodeType, state),
     },
   ];
 }
 
-function visitLinkedField(node) {
+function getLinkedFieldNodeType(schema: Schema, node) {
+  const requiredMetadata: ?RequiredDirectiveMetadata = (node.metadata
+    ?.required: $FlowFixMe);
+
+  if (requiredMetadata != null) {
+    return schema.getNonNullType(node.type);
+  }
+  if (node.metadata?.childrenCanBubbleNull === true) {
+    if (schema.isList(node.type)) {
+      // In a plural field, nulls bubble up to the item, resulting in a list of nullable items.
+      return schema.mapListItemType(node.type, inner =>
+        schema.getNullableType(inner),
+      );
+    } else if (schema.isNonNull(node.type)) {
+      const nullable = schema.getNullableType(node.type);
+      if (schema.isList(nullable)) {
+        return schema.getNonNullType(
+          schema.mapListItemType(nullable, inner =>
+            schema.getNullableType(inner),
+          ),
+        );
+      }
+      return nullable;
+    }
+    return node.type;
+  }
+  return node.type;
+}
+
+function visitLinkedField(schema: Schema, node) {
   return [
     {
       key: node.alias,
       schemaName: node.name,
-      nodeType: node.type,
+      nodeType: getLinkedFieldNodeType(schema, node),
       nodeSelections: selectionsToMap(
         flattenArray(
           // $FlowFixMe[incompatible-cast] : selections have already been transformed
@@ -679,7 +733,7 @@ function appendLocal3DPayload(
       t.genericTypeAnnotation(
         t.identifier('Local3DPayload'),
         t.typeParameterInstantiation([
-          t.stringLiteralTypeAnnotation(moduleImport.documentName),
+          t.stringLiteralTypeAnnotation(nullthrows(moduleImport.documentName)),
           exactObjectTypeAnnotation(
             selections
               .filter(sel => sel.schemaName !== 'js')
@@ -735,7 +789,9 @@ function createRawResponseTypeVisitor(schema: Schema, state: State) {
           conditional: true,
         }));
       },
-      LinkedField: visitLinkedField,
+      LinkedField(node) {
+        return visitLinkedField(schema, node);
+      },
       Condition: visitNodeWithSelectionsOnly,
       Defer: visitNodeWithSelectionsOnly,
       Stream: visitNodeWithSelectionsOnly,
@@ -1025,6 +1081,7 @@ const FLOW_TRANSFORMS: $ReadOnlyArray<IRTransform> = [
   RelayDirectiveTransform.transform,
   MaskTransform.transform,
   MatchTransform.transform,
+  RequiredFieldTransform.transform,
   FlattenTransform.transformWithOptions({}),
   RefetchableFragmentTransform.transform,
 ];

package/language/javascript/RelayFlowTypeTransformers.js.flow

@@ -23,7 +23,7 @@ import type {Schema, TypeID, EnumTypeID} from '../../core/Schema';
 
 export type BabelTypes = typeof t;
 export type ScalarTypeMapping = {
-  [type: string]: string | (BabelTypes => mixed),
+  [type: string]: string | (BabelTypes => BabelNode_DEPRECATED),
   ...,
 };
 
@@ -37,7 +37,7 @@ function transformScalarType(
   schema: Schema,
   type: TypeID,
   state: State,
-  objectProps?: mixed,
+  objectProps?: BabelNode_DEPRECATED,
 ): mixed {
   if (schema.isNonNull(type)) {
     return transformNonNullableScalarType(
@@ -58,7 +58,7 @@ function transformNonNullableScalarType(
   type: TypeID,
   state: State,
   objectProps,
-) {
+): BabelNode_DEPRECATED {
   if (schema.isList(type)) {
     return readOnlyArrayOfType(
       transformScalarType(
@@ -135,7 +135,7 @@ function transformNonNullableInputType(
   schema: Schema,
   type: TypeID,
   state: State,
-) {
+): BabelNode_DEPRECATED {
   if (schema.isList(type)) {
     return readOnlyArrayOfType(
       transformInputType(schema, schema.getListItemType(type), state),

package/lib/bin/RelayCompilerMain.js

@@ -14,19 +14,13 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _asyncToGenerator = require("@babel/runtime/helpers/asyncToGenerator");
 
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
 var CodegenRunner = require('../codegen/CodegenRunner');
 
@@ -224,7 +218,7 @@ function getPathBasedConfig(config) {
     }
   }
 
-  return _objectSpread({}, config, {
+  return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, config), {}, {
     schema: schema,
     src: src,
     persistOutput: persistOutput
@@ -242,7 +236,7 @@ function _getWatchConfig() {
     if (config.watch) {
       if (!watchman) {
         console.error('Watchman is required to watch for changes. Running with watch mode disabled.');
-        return _objectSpread({}, config, {
+        return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, config), {}, {
           watch: false,
           watchman: false
         });
@@ -256,7 +250,7 @@ function _getWatchConfig() {
       console.log('HINT: pass --watch to keep watching for changes.');
     }
 
-    return _objectSpread({}, config, {
+    return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, config), {}, {
       watchman: watchman
     });
   });
@@ -425,7 +419,7 @@ function getRelayFileWriter(baseDir, languagePlugin, noFutureProofEnums, outputD
           }
         }
 
-        var _iterator = _createForOfIteratorHelper(queryMap.entries()),
+        var _iterator = (0, _createForOfIteratorHelper2["default"])(queryMap.entries()),
             _step;
 
         try {

package/lib/codegen/CodegenRunner.js

@@ -14,13 +14,9 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _asyncToGenerator = require("@babel/runtime/helpers/asyncToGenerator");
 
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
 var CodegenDirectory = require('./CodegenDirectory');
 
@@ -154,7 +150,7 @@ var CodegenRunner = /*#__PURE__*/function () {
       for (var configName in _this3.writerConfigs) {
         var config = _this3.writerConfigs[configName];
 
-        var _iterator = _createForOfIteratorHelper(filePaths),
+        var _iterator = (0, _createForOfIteratorHelper2["default"])(filePaths),
             _step;
 
         try {
@@ -296,7 +292,7 @@ var CodegenRunner = /*#__PURE__*/function () {
           reporter: _this5._reporter
         });
 
-        var _iterator2 = _createForOfIteratorHelper(outputDirectories.values()),
+        var _iterator2 = (0, _createForOfIteratorHelper2["default"])(outputDirectories.values()),
             _step2;
 
         try {
@@ -304,7 +300,7 @@ var CodegenRunner = /*#__PURE__*/function () {
             var dir = _step2.value;
             var all = [].concat((0, _toConsumableArray2["default"])(dir.changes.created), (0, _toConsumableArray2["default"])(dir.changes.updated), (0, _toConsumableArray2["default"])(dir.changes.deleted), (0, _toConsumableArray2["default"])(dir.changes.unchanged));
 
-            var _iterator3 = _createForOfIteratorHelper(all),
+            var _iterator3 = (0, _createForOfIteratorHelper2["default"])(all),
                 _step3;
 
             try {

package/lib/codegen/NormalizationCodeGenerator.js

@@ -12,14 +12,10 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
-
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
-
 var argumentContainsVariables = require('../util/argumentContainsVariables');
 
 var generateAbstractTypeRefinementKey = require('../util/generateAbstractTypeRefinementKey');
@@ -225,14 +221,13 @@ function generateLinkedField(schema, node) {
       key: handle.key,
       kind: 'LinkedHandle',
       name: node.name
-    }; // T45504512: new connection model
-    // NOTE: this intentionally adds a dynamic key in order to avoid
+    }; // NOTE: this intentionally adds a dynamic key in order to avoid
     // triggering updates to existing queries that do not use dynamic
     // keys.
 
     if (handle.dynamicKey != null) {
       var dynamicKeyArgName = '__dynamicKey';
-      handleNode = _objectSpread({}, handleNode, {
+      handleNode = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, handleNode), {}, {
         dynamicKey: {
           kind: 'Variable',
           name: dynamicKeyArgName,
@@ -245,7 +240,7 @@ function generateLinkedField(schema, node) {
       var handleArgs = generateArgs(handle.handleArgs);
 
       if (handleArgs != null) {
-        handleNode = _objectSpread({}, handleNode, {
+        handleNode = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, handleNode), {}, {
           handleArgs: handleArgs
         });
       }
@@ -268,7 +263,7 @@ function generateLinkedField(schema, node) {
   var storageKey = getStaticStorageKey(field, node.metadata);
 
   if (storageKey != null) {
-    field = _objectSpread({}, field, {
+    field = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
       storageKey: storageKey
     });
   }
@@ -306,7 +301,7 @@ function generateTypeDiscriminator(abstractKey) {
 }
 
 function generateScalarField(node) {
-  var _node$metadata;
+  var _node$metadata, _node$metadata2;
 
   // flowlint-next-line sketchy-null-mixed:off
   if ((_node$metadata = node.metadata) === null || _node$metadata === void 0 ? void 0 : _node$metadata.skipNormalizationNode) {
@@ -321,7 +316,7 @@ function generateScalarField(node) {
       throw createUserError('Dynamic key values are not supported on scalar fields.', [handle.dynamicKey.loc]);
     }
 
-    return {
+    var nodeHandle = {
       alias: node.alias === node.name ? null : node.alias,
       args: generateArgs(node.args),
       filters: handle.filters,
@@ -330,6 +325,13 @@ function generateScalarField(node) {
       kind: 'ScalarHandle',
       name: node.name
     };
+
+    if (handle.handleArgs != null) {
+      // $FlowFixMe handleArgs exists in Handle
+      nodeHandle.handleArgs = generateArgs(handle.handleArgs);
+    }
+
+    return nodeHandle;
   }) || [];
   var field = {
     alias: node.alias === node.name ? null : node.alias,
@@ -342,11 +344,17 @@ function generateScalarField(node) {
   var storageKey = getStaticStorageKey(field, node.metadata);
 
   if (storageKey != null) {
-    field = _objectSpread({}, field, {
+    field = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
       storageKey: storageKey
     });
   }
 
+  if (((_node$metadata2 = node.metadata) === null || _node$metadata2 === void 0 ? void 0 : _node$metadata2.flight) === true) {
+    field = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
+      kind: 'FlightField'
+    });
+  }
+
   return [field].concat(handles);
 }
 

package/lib/codegen/ReaderCodeGenerator.js

@@ -12,11 +12,7 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
-
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 
 var CodeMarker = require('../util/CodeMarker');
 
@@ -46,11 +42,11 @@ function generate(schema, node) {
   var metadata = null;
 
   if (node.metadata != null) {
-    var _node$metadata = node.metadata,
-        mask = _node$metadata.mask,
-        plural = _node$metadata.plural,
-        connection = _node$metadata.connection,
-        refetch = _node$metadata.refetch;
+    var _node$metadata4 = node.metadata,
+        mask = _node$metadata4.mask,
+        plural = _node$metadata4.plural,
+        connection = _node$metadata4.connection,
+        refetch = _node$metadata4.refetch;
 
     if (Array.isArray(connection)) {
       var _metadata;
@@ -85,7 +81,7 @@ function generate(schema, node) {
       };
 
       if (typeof refetch.identifierField === 'string') {
-        metadata.refetch = _objectSpread({}, metadata.refetch, {
+        metadata.refetch = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, metadata.refetch), {}, {
           identifierField: refetch.identifierField
         });
       }
@@ -248,6 +244,8 @@ function generateInlineDataFragmentSpread(schema, node) {
 }
 
 function generateLinkedField(schema, node) {
+  var _node$metadata;
+
   // 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.
@@ -274,14 +272,29 @@ function generateLinkedField(schema, node) {
   var storageKey = getStaticStorageKey(field, node.metadata);
 
   if (storageKey) {
-    field = _objectSpread({}, field, {
+    field = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
       storageKey: storageKey
     });
   }
 
+  var requiredMetadata = (_node$metadata = node.metadata) === null || _node$metadata === void 0 ? void 0 : _node$metadata.required;
+
+  if (requiredMetadata != null) {
+    return createRequiredField(field, requiredMetadata);
+  }
+
   return field;
 }
 
+function createRequiredField(field, requiredMetadata) {
+  return {
+    kind: 'RequiredField',
+    field: field,
+    action: requiredMetadata.action,
+    path: requiredMetadata.path
+  };
+}
+
 function generateModuleImport(schema, node) {
   var fragmentName = node.name;
   var regExpMatch = fragmentName.match(/^([a-zA-Z][a-zA-Z0-9]*)(?:_([a-zA-Z][_a-zA-Z0-9]*))?$/);
@@ -305,6 +318,8 @@ function generateModuleImport(schema, node) {
 }
 
 function generateScalarField(schema, node) {
+  var _node$metadata2, _node$metadata3;
+
   // 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.
@@ -327,11 +342,27 @@ function generateScalarField(schema, node) {
   var storageKey = getStaticStorageKey(field, node.metadata);
 
   if (storageKey) {
-    field = _objectSpread({}, field, {
+    field = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
       storageKey: storageKey
     });
   }
 
+  if (((_node$metadata2 = node.metadata) === null || _node$metadata2 === void 0 ? void 0 : _node$metadata2.flight) === true) {
+    field = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
+      kind: 'FlightField'
+    });
+  }
+
+  var requiredMetadata = (_node$metadata3 = node.metadata) === null || _node$metadata3 === void 0 ? void 0 : _node$metadata3.required;
+
+  if (requiredMetadata != null) {
+    if (field.kind === 'FlightField') {
+      throw new createUserError('@required cannot be used on a ReactFlightComponent.', [node.loc]);
+    }
+
+    return createRequiredField(field, requiredMetadata);
+  }
+
   return field;
 }
 

package/lib/codegen/RelayFileWriter.js

@@ -14,13 +14,9 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _asyncToGenerator = require("@babel/runtime/helpers/asyncToGenerator");
 
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
 var ASTConvert = require('../core/ASTConvert');
 
@@ -152,7 +148,7 @@ function writeAll(_ref2) {
       return codegenDir;
     };
 
-    var _iterator = _createForOfIteratorHelper(writerConfig.generatedDirectories || []),
+    var _iterator = (0, _createForOfIteratorHelper2["default"])(writerConfig.generatedDirectories || []),
         _step;
 
     try {

package/lib/codegen/compileRelayArtifacts.js

@@ -12,13 +12,9 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
 var Printer = require('../core/IRPrinter');
 
@@ -50,7 +46,7 @@ function compile(context, fragmentContext, printContext, codeGenContext) {
   var schema = context.getSchema(); // Add everything from codeGenContext, these are the operations as well as
   // SplitOperations from @match.
 
-  var _iterator = _createForOfIteratorHelper(codeGenContext.documents()),
+  var _iterator = (0, _createForOfIteratorHelper2["default"])(codeGenContext.documents()),
       _step;
 
   try {
@@ -93,7 +89,7 @@ function compile(context, fragmentContext, printContext, codeGenContext) {
     _iterator.f();
   }
 
-  var _iterator2 = _createForOfIteratorHelper(fragmentContext.documents()),
+  var _iterator2 = (0, _createForOfIteratorHelper2["default"])(fragmentContext.documents()),
       _step2;
 
   try {

package/lib/codegen/sortObjectByKey.js

@@ -9,11 +9,9 @@
  */
 'use strict';
 
-function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
 function sortObjectByKey(obj) {
   if (obj == null) {
@@ -22,7 +20,7 @@ function sortObjectByKey(obj) {
 
   var result = {};
 
-  var _iterator = _createForOfIteratorHelper(Object.keys(obj).sort()),
+  var _iterator = (0, _createForOfIteratorHelper2["default"])(Object.keys(obj).sort()),
       _step;
 
   try {