relay-runtime 18.1.0 → 19.0.0

package/lib/store/RelayReader.js

@@ -4,9 +4,9 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
-var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _excluded = ["message"];
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 var _require = require('./live-resolvers/LiveResolverSuspenseSentinel'),
   isSuspenseSentinel = _require.isSuspenseSentinel;
 var RelayConcreteVariables = require('./RelayConcreteVariables');
@@ -36,14 +36,15 @@ function read(recordSource, selector, resolverCache, resolverContext) {
 }
 var RelayReader = /*#__PURE__*/function () {
   function RelayReader(recordSource, selector, resolverCache, resolverContext) {
-    var _selector$clientEdgeT;
+    var _selector$clientEdgeT, _ref, _this$_owner$node$ope, _this$_owner$node$ope2;
     this._clientEdgeTraversalPath = (_selector$clientEdgeT = selector.clientEdgeTraversalPath) !== null && _selector$clientEdgeT !== void 0 && _selector$clientEdgeT.length ? (0, _toConsumableArray2["default"])(selector.clientEdgeTraversalPath) : [];
     this._missingClientEdges = [];
     this._missingLiveResolverFields = [];
     this._isMissingData = false;
     this._isWithinUnmatchedTypeRefinement = false;
-    this._errorResponseFields = null;
+    this._fieldErrors = null;
     this._owner = selector.owner;
+    this._useExecTimeResolvers = (_ref = (_this$_owner$node$ope = this._owner.node.operation.use_exec_time_resolvers) !== null && _this$_owner$node$ope !== void 0 ? _this$_owner$node$ope : ((_this$_owner$node$ope2 = this._owner.node.operation.exec_time_resolvers_enabled_provider) === null || _this$_owner$node$ope2 === void 0 ? void 0 : _this$_owner$node$ope2.get()) === true) !== null && _ref !== void 0 ? _ref : false;
     this._recordSource = recordSource;
     this._seenRecords = new Set();
     this._selector = selector;
@@ -55,6 +56,7 @@ var RelayReader = /*#__PURE__*/function () {
   }
   var _proto = RelayReader.prototype;
   _proto.read = function read() {
+    var _this$_selector$node$;
     var _this$_selector = this._selector,
       node = _this$_selector.node,
       dataID = _this$_selector.dataID,
@@ -75,6 +77,10 @@ var RelayReader = /*#__PURE__*/function () {
     }
     this._isWithinUnmatchedTypeRefinement = !isDataExpectedToBePresent;
     var data = this._traverse(node, dataID, null);
+    var catchTo = (_this$_selector$node$ = this._selector.node.metadata) === null || _this$_selector$node$ === void 0 ? void 0 : _this$_selector$node$.catchTo;
+    if (catchTo != null) {
+      data = this._catchErrors(data, catchTo, null);
+    }
     if (this._updatedDataIDs.size > 0) {
       this._resolverCache.notifyUpdatedSubscribers(this._updatedDataIDs);
       this._updatedDataIDs.clear();
@@ -86,58 +92,52 @@ var RelayReader = /*#__PURE__*/function () {
       missingLiveResolverFields: this._missingLiveResolverFields,
       seenRecords: this._seenRecords,
       selector: this._selector,
-      errorResponseFields: this._errorResponseFields
+      fieldErrors: this._fieldErrors
     };
   };
-  _proto._maybeAddErrorResponseFields = function _maybeAddErrorResponseFields(record, storageKey) {
+  _proto._maybeAddFieldErrors = function _maybeAddFieldErrors(record, storageKey) {
     var errors = RelayModernRecord.getErrors(record, storageKey);
     if (errors == null) {
       return;
     }
     var owner = this._fragmentName;
-    if (this._errorResponseFields == null) {
-      this._errorResponseFields = [];
-    }
-    var _iterator = (0, _createForOfIteratorHelper2["default"])(errors),
-      _step;
-    try {
-      for (_iterator.s(); !(_step = _iterator.n()).done;) {
-        var _error$path, _this$_selector$node$, _this$_selector$node$2;
-        var error = _step.value;
-        this._errorResponseFields.push({
-          kind: 'relay_field_payload.error',
-          owner: owner,
-          fieldPath: ((_error$path = error.path) !== null && _error$path !== void 0 ? _error$path : []).join('.'),
-          error: error,
-          shouldThrow: (_this$_selector$node$ = (_this$_selector$node$2 = this._selector.node.metadata) === null || _this$_selector$node$2 === void 0 ? void 0 : _this$_selector$node$2.throwOnFieldError) !== null && _this$_selector$node$ !== void 0 ? _this$_selector$node$ : false,
-          handled: false
-        });
-      }
-    } catch (err) {
-      _iterator.e(err);
-    } finally {
-      _iterator.f();
+    if (this._fieldErrors == null) {
+      this._fieldErrors = [];
+    }
+    for (var i = 0; i < errors.length; i++) {
+      var _error$path, _this$_selector$node$2, _this$_selector$node$3;
+      var error = errors[i];
+      this._fieldErrors.push({
+        kind: 'relay_field_payload.error',
+        owner: owner,
+        fieldPath: ((_error$path = error.path) !== null && _error$path !== void 0 ? _error$path : []).join('.'),
+        error: error,
+        shouldThrow: (_this$_selector$node$2 = (_this$_selector$node$3 = this._selector.node.metadata) === null || _this$_selector$node$3 === void 0 ? void 0 : _this$_selector$node$3.throwOnFieldError) !== null && _this$_selector$node$2 !== void 0 ? _this$_selector$node$2 : false,
+        handled: false,
+        uiContext: undefined
+      });
     }
   };
-  _proto._markDataAsMissing = function _markDataAsMissing() {
-    var _this$_selector$node$3, _this$_selector$node$4;
+  _proto._markDataAsMissing = function _markDataAsMissing(fieldName) {
+    var _this$_selector$node$4, _this$_selector$node$5;
     if (this._isWithinUnmatchedTypeRefinement) {
       return;
     }
-    if (this._errorResponseFields == null) {
-      this._errorResponseFields = [];
+    if (this._fieldErrors == null) {
+      this._fieldErrors = [];
     }
-    var fieldPath = '';
     var owner = this._fragmentName;
-    this._errorResponseFields.push(((_this$_selector$node$3 = (_this$_selector$node$4 = this._selector.node.metadata) === null || _this$_selector$node$4 === void 0 ? void 0 : _this$_selector$node$4.throwOnFieldError) !== null && _this$_selector$node$3 !== void 0 ? _this$_selector$node$3 : false) ? {
+    this._fieldErrors.push(((_this$_selector$node$4 = (_this$_selector$node$5 = this._selector.node.metadata) === null || _this$_selector$node$5 === void 0 ? void 0 : _this$_selector$node$5.throwOnFieldError) !== null && _this$_selector$node$4 !== void 0 ? _this$_selector$node$4 : false) ? {
       kind: 'missing_expected_data.throw',
       owner: owner,
-      fieldPath: fieldPath,
-      handled: false
+      fieldPath: fieldName,
+      handled: false,
+      uiContext: undefined
     } : {
       kind: 'missing_expected_data.log',
       owner: owner,
-      fieldPath: fieldPath
+      fieldPath: fieldName,
+      uiContext: undefined
     });
     this._isMissingData = true;
     if (this._clientEdgeTraversalPath.length) {
@@ -155,7 +155,7 @@ var RelayReader = /*#__PURE__*/function () {
     this._seenRecords.add(dataID);
     if (record == null) {
       if (record === undefined) {
-        this._markDataAsMissing();
+        this._markDataAsMissing('<record>');
       }
       return record;
     }
@@ -167,37 +167,85 @@ var RelayReader = /*#__PURE__*/function () {
     !this._variables.hasOwnProperty(name) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Undefined variable `%s`.', name) : invariant(false) : void 0;
     return this._variables[name];
   };
-  _proto._maybeReportUnexpectedNull = function _maybeReportUnexpectedNull(fieldPath, action) {
+  _proto._maybeReportUnexpectedNull = function _maybeReportUnexpectedNull(selection) {
+    if (selection.action === 'NONE') {
+      return;
+    }
     var owner = this._fragmentName;
-    if (this._errorResponseFields == null) {
-      this._errorResponseFields = [];
+    if (this._fieldErrors == null) {
+      this._fieldErrors = [];
     }
-    switch (action) {
+    var fieldName;
+    if (selection.field.linkedField != null) {
+      var _selection$field$link;
+      fieldName = (_selection$field$link = selection.field.linkedField.alias) !== null && _selection$field$link !== void 0 ? _selection$field$link : selection.field.linkedField.name;
+    } else {
+      var _selection$field$alia;
+      fieldName = (_selection$field$alia = selection.field.alias) !== null && _selection$field$alia !== void 0 ? _selection$field$alia : selection.field.name;
+    }
+    switch (selection.action) {
       case 'THROW':
-        this._errorResponseFields.push({
+        this._fieldErrors.push({
           kind: 'missing_required_field.throw',
-          fieldPath: fieldPath,
+          fieldPath: fieldName,
           owner: owner,
-          handled: false
+          handled: false,
+          uiContext: undefined
         });
         return;
       case 'LOG':
-        this._errorResponseFields.push({
+        this._fieldErrors.push({
           kind: 'missing_required_field.log',
-          fieldPath: fieldPath,
-          owner: owner
+          fieldPath: fieldName,
+          owner: owner,
+          uiContext: undefined
         });
         return;
       default:
-        action;
+        selection.action;
     }
   };
-  _proto._handleCatchToResult = function _handleCatchToResult(selection, record, data, value) {
-    var _selection$field$back, _selection$field, _field$alias, _this$_errorResponseF;
-    var field = (_selection$field$back = (_selection$field = selection.field) === null || _selection$field === void 0 ? void 0 : _selection$field.backingField) !== null && _selection$field$back !== void 0 ? _selection$field$back : selection.field;
-    var fieldName = (_field$alias = field === null || field === void 0 ? void 0 : field.alias) !== null && _field$alias !== void 0 ? _field$alias : field === null || field === void 0 ? void 0 : field.name;
-    !(fieldName != null) ? process.env.NODE_ENV !== "production" ? invariant(false, "Couldn't determine field name for this field. It might be a ReaderClientExtension - which is not yet supported.") : invariant(false) : void 0;
-    var errors = (_this$_errorResponseF = this._errorResponseFields) === null || _this$_errorResponseF === void 0 ? void 0 : _this$_errorResponseF.map(function (error) {
+  _proto._handleRequiredFieldValue = function _handleRequiredFieldValue(selection, value) {
+    if (value == null) {
+      this._maybeReportUnexpectedNull(selection);
+      return false;
+    }
+    return true;
+  };
+  _proto._catchErrors = function _catchErrors(_value, to, previousResponseFields) {
+    var value = _value;
+    switch (to) {
+      case 'RESULT':
+        value = this._asResult(_value);
+        break;
+      case 'NULL':
+        if (this._fieldErrors != null && this._fieldErrors.length > 0) {
+          value = null;
+        }
+        break;
+      default:
+        to;
+    }
+    var childrenFieldErrors = this._fieldErrors;
+    this._fieldErrors = previousResponseFields;
+    if (childrenFieldErrors != null) {
+      if (this._fieldErrors == null) {
+        this._fieldErrors = [];
+      }
+      for (var i = 0; i < childrenFieldErrors.length; i++) {
+        this._fieldErrors.push(markFieldErrorHasHandled(childrenFieldErrors[i]));
+      }
+    }
+    return value;
+  };
+  _proto._asResult = function _asResult(value) {
+    if (this._fieldErrors == null || this._fieldErrors.length === 0) {
+      return {
+        ok: true,
+        value: value
+      };
+    }
+    var errors = this._fieldErrors.map(function (error) {
       switch (error.kind) {
         case 'relay_field_payload.error':
           var _error$error = error.error,
@@ -221,27 +269,14 @@ var RelayReader = /*#__PURE__*/function () {
           return null;
         default:
           error.kind;
-          !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'Unexpected error errorResponseField kind: %s', error.kind) : invariant(false) : void 0;
+          !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'Unexpected error fieldError kind: %s', error.kind) : invariant(false) : void 0;
       }
     }).filter(Boolean);
-    data[fieldName] = errors != null ? {
+    return {
       ok: false,
       errors: errors
-    } : {
-      ok: true,
-      value: value
     };
   };
-  _proto._handleRequiredFieldValue = function _handleRequiredFieldValue(selection, value) {
-    if (value == null) {
-      var action = selection.action;
-      if (action !== 'NONE') {
-        this._maybeReportUnexpectedNull(selection.path, action);
-      }
-      return false;
-    }
-    return true;
-  };
   _proto._traverseSelections = function _traverseSelections(selections, record, data) {
     for (var i = 0; i < selections.length; i++) {
       var selection = selections[i];
@@ -254,22 +289,14 @@ var RelayReader = /*#__PURE__*/function () {
           break;
         case 'CatchField':
           {
-            var previousResponseFields = this._errorResponseFields;
-            this._errorResponseFields = null;
+            var _selection$field$back, _selection$field, _field$alias;
+            var previousResponseFields = this._fieldErrors;
+            this._fieldErrors = null;
             var catchFieldValue = this._readClientSideDirectiveField(selection, record, data);
-            if (selection.to === 'RESULT') {
-              this._handleCatchToResult(selection, record, data, catchFieldValue);
-            }
-            var childrenErrorResponseFields = this._errorResponseFields;
-            this._errorResponseFields = previousResponseFields;
-            if (childrenErrorResponseFields != null) {
-              if (this._errorResponseFields == null) {
-                this._errorResponseFields = [];
-              }
-              for (var _i = 0; _i < childrenErrorResponseFields.length; _i++) {
-                this._errorResponseFields.push(markFieldErrorHasHandled(childrenErrorResponseFields[_i]));
-              }
-            }
+            var field = (_selection$field$back = (_selection$field = selection.field) === null || _selection$field === void 0 ? void 0 : _selection$field.backingField) !== null && _selection$field$back !== void 0 ? _selection$field$back : selection.field;
+            var fieldName = (_field$alias = field === null || field === void 0 ? void 0 : field.alias) !== null && _field$alias !== void 0 ? _field$alias : field === null || field === void 0 ? void 0 : field.name;
+            !(fieldName != null) ? process.env.NODE_ENV !== "production" ? invariant(false, "Couldn't determine field name for this field. It might be a ReaderClientExtension - which is not yet supported.") : invariant(false) : void 0;
+            data[fieldName] = this._catchErrors(catchFieldValue, selection.to, previousResponseFields);
             break;
           }
         case 'ScalarField':
@@ -302,7 +329,11 @@ var RelayReader = /*#__PURE__*/function () {
         case 'RelayLiveResolver':
         case 'RelayResolver':
           {
-            this._readResolverField(selection, record, data);
+            if (this._useExecTimeResolvers) {
+              this._readScalar(selection, record, data);
+            } else {
+              this._readResolverField(selection, record, data);
+            }
             break;
           }
         case 'FragmentSpread':
@@ -310,11 +341,7 @@ var RelayReader = /*#__PURE__*/function () {
           break;
         case 'AliasedInlineFragmentSpread':
           {
-            var fieldValue = this._readInlineFragment(selection.fragment, record, {}, true);
-            if (fieldValue === false) {
-              fieldValue = null;
-            }
-            data[selection.name] = fieldValue;
+            this._readAliasedInlineFragment(selection, record, data);
             break;
           }
         case 'ModuleImport':
@@ -350,7 +377,16 @@ var RelayReader = /*#__PURE__*/function () {
           break;
         case 'ClientEdgeToClientObject':
         case 'ClientEdgeToServerObject':
-          this._readClientEdge(selection, record, data);
+          if (this._useExecTimeResolvers && (selection.backingField.kind === 'RelayResolver' || selection.backingField.kind === 'RelayLiveResolver')) {
+            var linkedField = selection.linkedField;
+            if (linkedField.plural) {
+              this._readPluralLink(linkedField, record, data);
+            } else {
+              this._readLink(linkedField, record, data);
+            }
+          } else {
+            this._readClientEdge(selection, record, data);
+          }
           break;
         default:
           selection;
@@ -370,22 +406,41 @@ var RelayReader = /*#__PURE__*/function () {
           return this._readLink(selection.field, record, data);
         }
       case 'RelayResolver':
-        return this._readResolverField(selection.field, record, data);
       case 'RelayLiveResolver':
-        return this._readResolverField(selection.field, record, data);
+        {
+          if (this._useExecTimeResolvers) {
+            return this._readScalar(selection.field, record, data);
+          } else {
+            return this._readResolverField(selection.field, record, data);
+          }
+        }
       case 'ClientEdgeToClientObject':
       case 'ClientEdgeToServerObject':
-        return this._readClientEdge(selection.field, record, data);
+        if (this._useExecTimeResolvers && (selection.field.backingField.kind === 'RelayResolver' || selection.field.backingField.kind === 'RelayLiveResolver')) {
+          var field = selection.field;
+          if (field.linkedField.plural) {
+            return this._readPluralLink(field.linkedField, record, data);
+          } else {
+            return this._readLink(field.linkedField, record, data);
+          }
+        } else {
+          return this._readClientEdge(selection.field, record, data);
+        }
+      case 'AliasedInlineFragmentSpread':
+        return this._readAliasedInlineFragment(selection.field, record, data);
       default:
         selection.field.kind;
-        !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Unexpected ast kind `%s`.', selection.kind) : invariant(false) : void 0;
+        !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Unexpected ast kind `%s`.', selection.field.kind) : invariant(false) : void 0;
     }
   };
   _proto._readResolverField = function _readResolverField(field, record, data) {
     var _field$alias2;
     var parentRecordID = RelayModernRecord.getDataID(record);
+    var prevErrors = this._fieldErrors;
+    this._fieldErrors = null;
     var result = this._readResolverFieldImpl(field, parentRecordID);
     var fieldName = (_field$alias2 = field.alias) !== null && _field$alias2 !== void 0 ? _field$alias2 : field.name;
+    this._prependPreviousErrors(prevErrors, fieldName);
     data[fieldName] = result;
     return result;
   };
@@ -398,14 +453,14 @@ var RelayReader = /*#__PURE__*/function () {
         return {
           data: snapshot.data,
           isMissingData: snapshot.isMissingData,
-          errorResponseFields: snapshot.errorResponseFields
+          fieldErrors: snapshot.fieldErrors
         };
       }
       snapshot = read(_this._recordSource, singularReaderSelector, _this._resolverCache);
       return {
         data: snapshot.data,
         isMissingData: snapshot.isMissingData,
-        errorResponseFields: snapshot.errorResponseFields
+        fieldErrors: snapshot.fieldErrors
       };
     };
     var evaluate = function evaluate() {
@@ -450,74 +505,52 @@ var RelayReader = /*#__PURE__*/function () {
     return result;
   };
   _proto._propagateResolverMetadata = function _propagateResolverMetadata(fieldPath, cachedSnapshot, resolverError, seenRecord, suspenseID, updatedDataIDs) {
+    var _this2 = this;
     if (cachedSnapshot != null) {
       if (cachedSnapshot.missingClientEdges != null) {
-        var _iterator2 = (0, _createForOfIteratorHelper2["default"])(cachedSnapshot.missingClientEdges),
-          _step2;
-        try {
-          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-            var missing = _step2.value;
-            this._missingClientEdges.push(missing);
-          }
-        } catch (err) {
-          _iterator2.e(err);
-        } finally {
-          _iterator2.f();
+        for (var i = 0; i < cachedSnapshot.missingClientEdges.length; i++) {
+          var missing = cachedSnapshot.missingClientEdges[i];
+          this._missingClientEdges.push(missing);
         }
       }
       if (cachedSnapshot.missingLiveResolverFields != null) {
         this._isMissingData = this._isMissingData || cachedSnapshot.missingLiveResolverFields.length > 0;
-        var _iterator3 = (0, _createForOfIteratorHelper2["default"])(cachedSnapshot.missingLiveResolverFields),
-          _step3;
-        try {
-          for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-            var missingResolverField = _step3.value;
-            this._missingLiveResolverFields.push(missingResolverField);
-          }
-        } catch (err) {
-          _iterator3.e(err);
-        } finally {
-          _iterator3.f();
+        for (var _i = 0; _i < cachedSnapshot.missingLiveResolverFields.length; _i++) {
+          var missingResolverField = cachedSnapshot.missingLiveResolverFields[_i];
+          this._missingLiveResolverFields.push(missingResolverField);
         }
       }
-      if (cachedSnapshot.errorResponseFields != null) {
-        if (this._errorResponseFields == null) {
-          this._errorResponseFields = [];
+      if (cachedSnapshot.fieldErrors != null) {
+        if (this._fieldErrors == null) {
+          this._fieldErrors = [];
         }
-        var _iterator4 = (0, _createForOfIteratorHelper2["default"])(cachedSnapshot.errorResponseFields),
-          _step4;
-        try {
-          for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-            var _this$_selector$node$5;
-            var error = _step4.value;
-            if (((_this$_selector$node$5 = this._selector.node.metadata) === null || _this$_selector$node$5 === void 0 ? void 0 : _this$_selector$node$5.throwOnFieldError) === true) {
-              this._errorResponseFields.push(error);
-            } else {
-              this._errorResponseFields.push(markFieldErrorHasHandled(error));
-            }
+        for (var _i2 = 0; _i2 < cachedSnapshot.fieldErrors.length; _i2++) {
+          var _this$_selector$node$6;
+          var error = cachedSnapshot.fieldErrors[_i2];
+          if (((_this$_selector$node$6 = this._selector.node.metadata) === null || _this$_selector$node$6 === void 0 ? void 0 : _this$_selector$node$6.throwOnFieldError) === true) {
+            this._fieldErrors.push(error);
+          } else {
+            this._fieldErrors.push(markFieldErrorHasHandled(error));
           }
-        } catch (err) {
-          _iterator4.e(err);
-        } finally {
-          _iterator4.f();
         }
       }
       this._isMissingData = this._isMissingData || cachedSnapshot.isMissingData;
     }
     if (resolverError) {
-      var _this$_selector$node$6, _this$_selector$node$7;
+      var _this$_selector$node$7, _this$_selector$node$8;
       var errorEvent = {
         kind: 'relay_resolver.error',
         fieldPath: fieldPath,
         owner: this._fragmentName,
         error: resolverError,
-        shouldThrow: (_this$_selector$node$6 = (_this$_selector$node$7 = this._selector.node.metadata) === null || _this$_selector$node$7 === void 0 ? void 0 : _this$_selector$node$7.throwOnFieldError) !== null && _this$_selector$node$6 !== void 0 ? _this$_selector$node$6 : false,
-        handled: false
+        shouldThrow: (_this$_selector$node$7 = (_this$_selector$node$8 = this._selector.node.metadata) === null || _this$_selector$node$8 === void 0 ? void 0 : _this$_selector$node$8.throwOnFieldError) !== null && _this$_selector$node$7 !== void 0 ? _this$_selector$node$7 : false,
+        handled: false,
+        uiContext: undefined
       };
-      if (this._errorResponseFields == null) {
-        this._errorResponseFields = [errorEvent];
+      if (this._fieldErrors == null) {
+        this._fieldErrors = [errorEvent];
       } else {
-        this._errorResponseFields.push(errorEvent);
+        this._fieldErrors.push(errorEvent);
       }
     }
     if (seenRecord != null) {
@@ -525,28 +558,16 @@ var RelayReader = /*#__PURE__*/function () {
     }
     if (suspenseID != null) {
       this._isMissingData = true;
-      this._missingLiveResolverFields.push({
-        path: "".concat(this._fragmentName, ".").concat(fieldPath),
-        liveStateID: suspenseID
-      });
+      this._missingLiveResolverFields.push(suspenseID);
     }
     if (updatedDataIDs != null) {
-      var _iterator5 = (0, _createForOfIteratorHelper2["default"])(updatedDataIDs),
-        _step5;
-      try {
-        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-          var recordID = _step5.value;
-          this._updatedDataIDs.add(recordID);
-        }
-      } catch (err) {
-        _iterator5.e(err);
-      } finally {
-        _iterator5.f();
-      }
+      updatedDataIDs.forEach(function (recordID) {
+        _this2._updatedDataIDs.add(recordID);
+      });
     }
   };
   _proto._readClientEdge = function _readClientEdge(field, record, data) {
-    var _this2 = this;
+    var _this3 = this;
     var _backingField$alias;
     var backingField = field.backingField;
     !(backingField.kind !== 'ClientExtension') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Client extension client edges are not yet implemented.') : invariant(false) : void 0;
@@ -566,21 +587,21 @@ var RelayReader = /*#__PURE__*/function () {
         storeIDs = clientEdgeResolverResponse.map(function (itemResponse) {
           var _field$concreteType;
           var concreteType = (_field$concreteType = field.concreteType) !== null && _field$concreteType !== void 0 ? _field$concreteType : itemResponse.__typename;
-          !(typeof concreteType === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Expected resolver for field at `%s` in `%s` modeling an edge to an abstract type to return an object with a `__typename` property.', backingField.path, _this2._owner.identifier) : invariant(false) : void 0;
-          var localId = extractIdFromResponse(itemResponse, backingField.path, _this2._owner.identifier);
-          var id = _this2._resolverCache.ensureClientRecord(localId, concreteType);
+          !(typeof concreteType === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Expected resolver for field at `%s` in `%s` modeling an edge to an abstract type to return an object with a `__typename` property.', backingField.path, _this3._owner.identifier) : invariant(false) : void 0;
+          var localId = extractIdFromResponse(itemResponse, backingField.path, _this3._owner.identifier);
+          var id = _this3._resolverCache.ensureClientRecord(localId, concreteType);
           var modelResolvers = field.modelResolvers;
           if (modelResolvers != null) {
             var modelResolver = modelResolvers[concreteType];
-            !(modelResolver !== undefined) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Invalid `__typename` returned by resolver at `%s` in `%s`. Expected one of %s but got `%s`.', backingField.path, _this2._owner.identifier, Object.keys(modelResolvers).join(', '), concreteType) : invariant(false) : void 0;
-            var model = _this2._readResolverFieldImpl(modelResolver, id);
+            !(modelResolver !== undefined) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Invalid `__typename` returned by resolver at `%s` in `%s`. Expected one of %s but got `%s`.', backingField.path, _this3._owner.identifier, Object.keys(modelResolvers).join(', '), concreteType) : invariant(false) : void 0;
+            var model = _this3._readResolverFieldImpl(modelResolver, id);
             return model != null ? id : null;
           }
           return id;
         });
       } else {
         storeIDs = clientEdgeResolverResponse.map(function (obj) {
-          return extractIdFromResponse(obj, backingField.path, _this2._owner.identifier);
+          return extractIdFromResponse(obj, backingField.path, _this3._owner.identifier);
         });
       }
       this._clientEdgeTraversalPath.push(null);
@@ -624,7 +645,10 @@ var RelayReader = /*#__PURE__*/function () {
       this._clientEdgeTraversalPath.push(traversalPathSegment);
       var prevData = data[fieldName];
       !(prevData == null || typeof prevData === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Expected data for field at `%s` in `%s` on record `%s` ' + 'to be an object, got `%s`.', backingField.path, this._owner.identifier, RelayModernRecord.getDataID(record), prevData) : invariant(false) : void 0;
+      var prevErrors = this._fieldErrors;
+      this._fieldErrors = null;
       var edgeValue = this._traverse(field.linkedField, storeID, prevData);
+      this._prependPreviousErrors(prevErrors, fieldName);
       this._clientEdgeTraversalPath.pop();
       data[fieldName] = edgeValue;
       return edgeValue;
@@ -635,10 +659,10 @@ var RelayReader = /*#__PURE__*/function () {
     var fieldName = (_field$alias3 = field.alias) !== null && _field$alias3 !== void 0 ? _field$alias3 : field.name;
     var storageKey = getStorageKey(field, this._variables);
     var value = RelayModernRecord.getValue(record, storageKey);
-    if (value === null) {
-      this._maybeAddErrorResponseFields(record, storageKey);
+    if (value === null || RelayFeatureFlags.ENABLE_NONCOMPLIANT_ERROR_HANDLING_ON_LISTS && Array.isArray(value) && value.length === 0) {
+      this._maybeAddFieldErrors(record, storageKey);
     } else if (value === undefined) {
-      this._markDataAsMissing();
+      this._markDataAsMissing(fieldName);
     }
     data[fieldName] = value;
     return value;
@@ -651,18 +675,39 @@ var RelayReader = /*#__PURE__*/function () {
     if (linkedID == null) {
       data[fieldName] = linkedID;
       if (linkedID === null) {
-        this._maybeAddErrorResponseFields(record, storageKey);
+        this._maybeAddFieldErrors(record, storageKey);
       } else if (linkedID === undefined) {
-        this._markDataAsMissing();
+        this._markDataAsMissing(fieldName);
       }
       return linkedID;
     }
     var prevData = data[fieldName];
     !(prevData == null || typeof prevData === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Expected data for field `%s` at `%s` on record `%s` ' + 'to be an object, got `%s`.', fieldName, this._owner.identifier, RelayModernRecord.getDataID(record), prevData) : invariant(false) : void 0;
+    var prevErrors = this._fieldErrors;
+    this._fieldErrors = null;
     var value = this._traverse(field, linkedID, prevData);
+    this._prependPreviousErrors(prevErrors, fieldName);
     data[fieldName] = value;
     return value;
   };
+  _proto._prependPreviousErrors = function _prependPreviousErrors(prevErrors, fieldNameOrIndex) {
+    if (this._fieldErrors != null) {
+      for (var i = 0; i < this._fieldErrors.length; i++) {
+        var event = this._fieldErrors[i];
+        if (event.owner === this._fragmentName && (event.kind === 'missing_expected_data.throw' || event.kind === 'missing_expected_data.log' || event.kind === 'missing_required_field.throw' || event.kind === 'missing_required_field.log')) {
+          event.fieldPath = "".concat(fieldNameOrIndex, ".").concat(event.fieldPath);
+        }
+      }
+      if (prevErrors != null) {
+        for (var _i3 = this._fieldErrors.length - 1; _i3 >= 0; _i3--) {
+          prevErrors.push(this._fieldErrors[_i3]);
+        }
+        this._fieldErrors = prevErrors;
+      }
+    } else {
+      this._fieldErrors = prevErrors;
+    }
+  };
   _proto._readActorChange = function _readActorChange(field, record, data) {
     var _field$alias5;
     var fieldName = (_field$alias5 = field.alias) !== null && _field$alias5 !== void 0 ? _field$alias5 : field.name;
@@ -671,9 +716,9 @@ var RelayReader = /*#__PURE__*/function () {
     if (externalRef == null) {
       data[fieldName] = externalRef;
       if (externalRef === undefined) {
-        this._markDataAsMissing();
+        this._markDataAsMissing(fieldName);
       } else if (externalRef === null) {
-        this._maybeAddErrorResponseFields(record, storageKey);
+        this._maybeAddFieldErrors(record, storageKey);
       }
       return data[fieldName];
     }
@@ -692,47 +737,53 @@ var RelayReader = /*#__PURE__*/function () {
   _proto._readPluralLink = function _readPluralLink(field, record, data) {
     var storageKey = getStorageKey(field, this._variables);
     var linkedIDs = RelayModernRecord.getLinkedRecordIDs(record, storageKey);
-    if (linkedIDs === null) {
-      this._maybeAddErrorResponseFields(record, storageKey);
+    if (linkedIDs === null || RelayFeatureFlags.ENABLE_NONCOMPLIANT_ERROR_HANDLING_ON_LISTS && Array.isArray(linkedIDs) && linkedIDs.length === 0) {
+      this._maybeAddFieldErrors(record, storageKey);
     }
     return this._readLinkedIds(field, linkedIDs, record, data);
   };
   _proto._readLinkedIds = function _readLinkedIds(field, linkedIDs, record, data) {
-    var _this3 = this;
+    var _this4 = this;
     var _field$alias6;
     var fieldName = (_field$alias6 = field.alias) !== null && _field$alias6 !== void 0 ? _field$alias6 : field.name;
     if (linkedIDs == null) {
       data[fieldName] = linkedIDs;
       if (linkedIDs === undefined) {
-        this._markDataAsMissing();
+        this._markDataAsMissing(fieldName);
       }
       return linkedIDs;
     }
     var prevData = data[fieldName];
     !(prevData == null || Array.isArray(prevData)) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Expected data for field `%s` on record `%s` ' + 'to be an array, got `%s`.', fieldName, RelayModernRecord.getDataID(record), prevData) : invariant(false) : void 0;
+    var prevErrors = this._fieldErrors;
+    this._fieldErrors = null;
     var linkedArray = prevData || [];
     linkedIDs.forEach(function (linkedID, nextIndex) {
       if (linkedID == null) {
         if (linkedID === undefined) {
-          _this3._markDataAsMissing();
+          _this4._markDataAsMissing(String(nextIndex));
         }
         linkedArray[nextIndex] = linkedID;
         return;
       }
       var prevItem = linkedArray[nextIndex];
       !(prevItem == null || typeof prevItem === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReader(): Expected data for field `%s` on record `%s` ' + 'to be an object, got `%s`.', fieldName, RelayModernRecord.getDataID(record), prevItem) : invariant(false) : void 0;
-      linkedArray[nextIndex] = _this3._traverse(field, linkedID, prevItem);
+      var prevErrors = _this4._fieldErrors;
+      _this4._fieldErrors = null;
+      linkedArray[nextIndex] = _this4._traverse(field, linkedID, prevItem);
+      _this4._prependPreviousErrors(prevErrors, nextIndex);
     });
+    this._prependPreviousErrors(prevErrors, fieldName);
     data[fieldName] = linkedArray;
     return linkedArray;
   };
   _proto._readModuleImport = function _readModuleImport(moduleImport, record, data) {
-    var _moduleImport$compone;
     var componentKey = getModuleComponentKey(moduleImport.documentName);
-    var component = (_moduleImport$compone = moduleImport.componentModuleProvider) !== null && _moduleImport$compone !== void 0 ? _moduleImport$compone : RelayModernRecord.getValue(record, componentKey);
+    var relayStoreComponent = RelayModernRecord.getValue(record, componentKey);
+    var component = relayStoreComponent !== undefined ? relayStoreComponent : moduleImport.componentModuleProvider;
     if (component == null) {
       if (component === undefined) {
-        this._markDataAsMissing();
+        this._markDataAsMissing('<module-import>');
       }
       return;
     }
@@ -744,6 +795,16 @@ var RelayReader = /*#__PURE__*/function () {
     data[FRAGMENT_PROP_NAME_KEY] = moduleImport.fragmentPropName;
     data[MODULE_COMPONENT_KEY] = component;
   };
+  _proto._readAliasedInlineFragment = function _readAliasedInlineFragment(aliasedInlineFragment, record, data) {
+    var prevErrors = this._fieldErrors;
+    this._fieldErrors = null;
+    var fieldValue = this._readInlineFragment(aliasedInlineFragment.fragment, record, {}, true);
+    this._prependPreviousErrors(prevErrors, aliasedInlineFragment.name);
+    if (fieldValue === false) {
+      fieldValue = null;
+    }
+    data[aliasedInlineFragment.name] = fieldValue;
+  };
   _proto._readInlineFragment = function _readInlineFragment(inlineFragment, record, data, skipUnmatchedAbstractTypes) {
     if (inlineFragment.type == null) {
       var hasExpectedData = this._traverseSelections(inlineFragment.selections, record, data);
@@ -827,7 +888,7 @@ var RelayReader = /*#__PURE__*/function () {
     var typeRecord = this._recordSource.get(generateTypeID(typeName));
     var implementsInterface = typeRecord != null ? RelayModernRecord.getValue(typeRecord, abstractKey) : null;
     if (implementsInterface == null) {
-      this._markDataAsMissing();
+      this._markDataAsMissing('<abstract-type-hint>');
     }
     return implementsInterface;
   };