relay-runtime 13.0.0-rc.2 → 13.0.3

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) Facebook, Inc. and its affiliates.
+Copyright (c) Meta Platforms, Inc. and affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,5 +1,4 @@
-Relay Runtime
----
+## Relay Runtime
 
 A set of Relay APIs responsible for data fetching, reading and normalization of
 the GraphQL data.
@@ -7,7 +6,6 @@ the GraphQL data.
 Example:
 
 ```js
-
 // @flow strict-local
 
 import type {FetchFunction} from 'relay-runtime';
@@ -61,7 +59,6 @@ fetchQuery(
     console.log(data);
   },
 });
-
 ```
 
 For complete API reference, visit https://relay.dev/.

package/index.js

@@ -1,7 +1,7 @@
 /**
- * Relay v13.0.0-rc.2
+ * Relay v13.0.3
  *
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.

package/index.js.flow

@@ -46,6 +46,7 @@ const RelayModernStore = require('./store/RelayModernStore');
 const RelayOperationTracker = require('./store/RelayOperationTracker');
 const RelayRecordSource = require('./store/RelayRecordSource');
 const RelayStoreUtils = require('./store/RelayStoreUtils');
+const ResolverFragments = require('./store/ResolverFragments');
 const ViewerPattern = require('./store/ViewerPattern');
 const requestSubscription = require('./subscription/requestSubscription');
 const createPayloadFor3DField = require('./util/createPayloadFor3DField');
@@ -69,6 +70,7 @@ const RelayProfiler = require('./util/RelayProfiler');
 const RelayReplaySubject = require('./util/RelayReplaySubject');
 const reportMissingRequiredFields = require('./util/reportMissingRequiredFields');
 const stableCopy = require('./util/stableCopy');
+const withProvidedVariables = require('./util/withProvidedVariables');
 
 export type {ConnectionMetadata} from './handlers/connection/ConnectionHandler';
 export type {
@@ -352,6 +354,7 @@ module.exports = {
   getPendingOperationsForFragment: getPendingOperationsForFragment,
   getValueAtPath: getValueAtPath,
   __internal: {
+    ResolverFragments,
     OperationTracker: RelayOperationTracker,
     createRelayContext: createRelayContext,
     getOperationVariables: RelayConcreteVariables.getOperationVariables,
@@ -360,5 +363,6 @@ module.exports = {
     getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
     getObservableForActiveRequest:
       fetchQueryInternal.getObservableForActiveRequest,
+    withProvidedVariables: withProvidedVariables,
   },
 };

package/lib/index.js

@@ -73,6 +73,8 @@ var RelayRecordSource = require('./store/RelayRecordSource');
 
 var RelayStoreUtils = require('./store/RelayStoreUtils');
 
+var ResolverFragments = require('./store/ResolverFragments');
+
 var ViewerPattern = require('./store/ViewerPattern');
 
 var requestSubscription = require('./subscription/requestSubscription');
@@ -119,6 +121,8 @@ var reportMissingRequiredFields = require('./util/reportMissingRequiredFields');
 
 var stableCopy = require('./util/stableCopy');
 
+var withProvidedVariables = require('./util/withProvidedVariables');
+
 // As early as possible, check for the existence of the JavaScript globals which
 // Relay Runtime relies upon, and produce a clear message if they do not exist.
 if (process.env.NODE_ENV !== "production") {
@@ -230,12 +234,14 @@ module.exports = {
   getPendingOperationsForFragment: getPendingOperationsForFragment,
   getValueAtPath: getValueAtPath,
   __internal: {
+    ResolverFragments: ResolverFragments,
     OperationTracker: RelayOperationTracker,
     createRelayContext: createRelayContext,
     getOperationVariables: RelayConcreteVariables.getOperationVariables,
     fetchQuery: fetchQueryInternal.fetchQuery,
     fetchQueryDeduped: fetchQueryInternal.fetchQueryDeduped,
     getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
-    getObservableForActiveRequest: fetchQueryInternal.getObservableForActiveRequest
+    getObservableForActiveRequest: fetchQueryInternal.getObservableForActiveRequest,
+    withProvidedVariables: withProvidedVariables
   }
 };

package/lib/mutations/readUpdatableQuery_EXPERIMENTAL.js

@@ -21,7 +21,7 @@ var _require = require('../query/GraphQLTag'),
 var _require2 = require('../store/RelayStoreUtils'),
     getArgumentValues = _require2.getArgumentValues;
 
-var nonUpdatableKeys = ['id', '__id', '__typename'];
+var nonUpdatableKeys = ['id', '__id', '__typename', 'js'];
 
 function readUpdatableQuery_EXPERIMENTAL(query, variables, proxy) {
   // TODO assert that the concrete request is an updatable query
@@ -37,7 +37,7 @@ function readUpdatableQuery_EXPERIMENTAL(query, variables, proxy) {
 }
 
 function updateProxyFromSelections(mutableUpdatableProxy, recordProxy, queryVariables, selections, root) {
-  var _selection$alias, _selection$alias2;
+  var _selection$alias3;
 
   var _iterator = (0, _createForOfIteratorHelper2["default"])(selections),
       _step;
@@ -48,21 +48,23 @@ function updateProxyFromSelections(mutableUpdatableProxy, recordProxy, queryVari
 
       switch (selection.kind) {
         case 'LinkedField':
-          // Linked fields are assignable if they contain fragment spreads or
-          // read-only otherwise.
-          var isAssignable = selection.selections.some(function (item) {
-            return item.kind === 'FragmentSpread';
-          });
-          var set = !isAssignable ? undefined : selection.plural ? createSetterForPluralLinkedField(selection, queryVariables, recordProxy, root) : createSetterForSingularLinkedField(selection, queryVariables, recordProxy, root);
-          var get = selection.plural ? createGetterForPluralLinkedField(selection, queryVariables, recordProxy, root) : createGetterForSingularLinkedField(selection, queryVariables, recordProxy, root);
-          Object.defineProperty(mutableUpdatableProxy, (_selection$alias = selection.alias) !== null && _selection$alias !== void 0 ? _selection$alias : selection.name, {
-            get: get,
-            set: set
-          });
+          if (selection.plural) {
+            Object.defineProperty(mutableUpdatableProxy, (_selection$alias = selection.alias) !== null && _selection$alias !== void 0 ? _selection$alias : selection.name, {
+              // $FlowFixMe[incompatible-call] these getters and setters have different types on purpose
+              get: createGetterForPluralLinkedField(selection, queryVariables, recordProxy, root),
+              set: createSetterForPluralLinkedField(selection, queryVariables, recordProxy, root)
+            });
+          } else {
+            Object.defineProperty(mutableUpdatableProxy, (_selection$alias2 = selection.alias) !== null && _selection$alias2 !== void 0 ? _selection$alias2 : selection.name, {
+              get: createGetterForSingularLinkedField(selection, queryVariables, recordProxy, root),
+              set: createSetterForSingularLinkedField(selection, queryVariables, recordProxy, root)
+            });
+          }
+
           break;
 
         case 'ScalarField':
-          var scalarFieldName = (_selection$alias2 = selection.alias) !== null && _selection$alias2 !== void 0 ? _selection$alias2 : selection.name;
+          var scalarFieldName = (_selection$alias3 = selection.alias) !== null && _selection$alias3 !== void 0 ? _selection$alias3 : selection.name;
           Object.defineProperty(mutableUpdatableProxy, scalarFieldName, {
             get: function get() {
               var _selection$args;
@@ -106,6 +108,10 @@ function updateProxyFromSelections(mutableUpdatableProxy, recordProxy, queryVari
     };
 
     for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _selection$alias;
+
+      var _selection$alias2;
+
       _loop();
     }
   } catch (err) {
@@ -122,8 +128,7 @@ function createSetterForPluralLinkedField(selection, queryVariables, recordProxy
     var variables = getArgumentValues((_selection$args3 = selection.args) !== null && _selection$args3 !== void 0 ? _selection$args3 : [], queryVariables);
 
     if (newValue == null) {
-      // $FlowFixMe[unclear-type] No good way to type these variables
-      recordProxy.setValue(null, selection.name, variables);
+      throw new Error('Do not assign null to plural linked fields; assign an empty array instead.');
     } else {
       var recordProxies = newValue.map(function (item) {
         if (item == null) {
@@ -158,7 +163,7 @@ function createSetterForSingularLinkedField(selection, queryVariables, recordPro
 
     if (newValue == null) {
       // $FlowFixMe[unclear-type] No good way to type these variables
-      recordProxy.setValue(null, selection.name, variables);
+      recordProxy.setValue(newValue, selection.name, variables);
     } else {
       var __id = newValue.__id;
 

package/lib/mutations/validateMutation.js

@@ -98,6 +98,7 @@ if (process.env.NODE_ENV !== "production") {
       case INLINE_FRAGMENT:
         var type = selection.type;
         var isConcreteType = selection.abstractKey == null;
+        validateAbstractKey(context, selection.abstractKey);
         selection.selections.forEach(function (subselection) {
           if (isConcreteType && optimisticResponse.__typename !== type) {
             return;
@@ -116,11 +117,13 @@ if (process.env.NODE_ENV !== "production") {
       case MODULE_IMPORT:
         return validateModuleImport(context);
 
+      case TYPE_DISCRIMINATOR:
+        return validateAbstractKey(context, selection.abstractKey);
+
       case LINKED_HANDLE:
       case SCALAR_HANDLE:
       case DEFER:
       case STREAM:
-      case TYPE_DISCRIMINATOR:
         {
           // TODO(T35864292) - Add missing validations for these types
           return;
@@ -136,6 +139,13 @@ if (process.env.NODE_ENV !== "production") {
     context.moduleImportPaths.add(context.path);
   };
 
+  var validateAbstractKey = function validateAbstractKey(context, abstractKey) {
+    if (abstractKey != null) {
+      var path = "".concat(context.path, ".").concat(abstractKey);
+      context.visitedPaths.add(path);
+    }
+  };
+
   var validateField = function validateField(optimisticResponse, field, context) {
     var fieldName = field.alias || field.name;
     var path = "".concat(context.path, ".").concat(fieldName);

package/lib/network/RelayNetwork.js

@@ -10,6 +10,8 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+var withProvidedVariables = require('../util/withProvidedVariables');
+
 var _require = require('./ConvertToExecuteFunction'),
     convertFetch = _require.convertFetch;
 
@@ -25,22 +27,24 @@ function create(fetchFn, subscribe) {
   var observeFetch = convertFetch(fetchFn);
 
   function execute(request, variables, cacheConfig, uploadables, logRequestInfo) {
+    var operationVariables = withProvidedVariables(variables, request.providedVariables);
+
     if (request.operationKind === 'subscription') {
       !subscribe ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayNetwork: This network layer does not support Subscriptions. ' + 'To use Subscriptions, provide a custom network layer.') : invariant(false) : void 0;
       !!uploadables ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayNetwork: Cannot provide uploadables while subscribing.') : invariant(false) : void 0;
-      return subscribe(request, variables, cacheConfig);
+      return subscribe(request, operationVariables, cacheConfig);
     }
 
     var pollInterval = cacheConfig.poll;
 
     if (pollInterval != null) {
       !!uploadables ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayNetwork: Cannot provide uploadables while polling.') : invariant(false) : void 0;
-      return observeFetch(request, variables, {
+      return observeFetch(request, operationVariables, {
         force: true
       }).poll(pollInterval);
     }
 
-    return observeFetch(request, variables, cacheConfig, uploadables, logRequestInfo);
+    return observeFetch(request, operationVariables, cacheConfig, uploadables, logRequestInfo);
   }
 
   return {

package/lib/query/fetchQuery.js

@@ -122,6 +122,9 @@ function fetchQuery(environment, query, variables, options) {
     if (snapshot.missingRequiredFields != null) {
       reportMissingRequiredFields(environment, snapshot.missingRequiredFields);
     }
+    /* $FlowFixMe[incompatible-return] we assume readData returns the right
+     * data just having written it from network or checked availability. */
+
 
     return snapshot.data;
   }

package/lib/store/RelayConcreteVariables.js

@@ -68,13 +68,15 @@ function getFragmentVariables(fragment, rootVariables, argumentVariables) {
 }
 /**
  * Determines the variables that are in scope for a given operation given values
- * for some/all of its arguments. Extraneous input variables are filtered from
- * the output, and missing variables are set to default values (if given in the
+ * for some/all of its arguments.
+ * - extraneous input variables are filtered from the output
+ * - missing variables are set to default values (if given in the
  * operation's definition).
+ * - variables with provider modules are added
  */
 
 
-function getOperationVariables(operation, variables) {
+function getOperationVariables(operation, providedVariables, variables) {
   var operationVariables = {};
   operation.argumentDefinitions.forEach(function (def) {
     var value = def.defaultValue;
@@ -85,6 +87,13 @@ function getOperationVariables(operation, variables) {
 
     operationVariables[def.name] = value;
   });
+
+  if (providedVariables != null) {
+    Object.keys(providedVariables).forEach(function (varName) {
+      operationVariables[varName] = providedVariables[varName].get();
+    });
+  }
+
   return operationVariables;
 }
 

package/lib/store/RelayExperimentalGraphResponseTransform.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.normalizeResponse = normalizeResponse;
+exports.normalizeResponseWithMetadata = normalizeResponseWithMetadata;
+exports.GraphModeNormalizer = void 0;
 
 var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
@@ -30,7 +32,9 @@ var _require = require('../util/RelayConcreteNode'),
     FRAGMENT_SPREAD = _require.FRAGMENT_SPREAD,
     INLINE_FRAGMENT = _require.INLINE_FRAGMENT,
     LINKED_FIELD = _require.LINKED_FIELD,
-    SCALAR_FIELD = _require.SCALAR_FIELD;
+    LINKED_HANDLE = _require.LINKED_HANDLE,
+    SCALAR_FIELD = _require.SCALAR_FIELD,
+    SCALAR_HANDLE = _require.SCALAR_HANDLE;
 
 var _require2 = require('./RelayConcreteVariables'),
     getLocalVariables = _require2.getLocalVariables;
@@ -96,6 +100,17 @@ function normalizeResponse(response, selector, options) {
   return normalizer.normalizeResponse(node, dataID, response);
 }
 
+function normalizeResponseWithMetadata(response, selector, options) {
+  var node = selector.node,
+      variables = selector.variables,
+      dataID = selector.dataID;
+  var normalizer = new GraphModeNormalizer(variables, options);
+  var chunks = Array.from(normalizer.normalizeResponse(node, dataID, response));
+  return [chunks, {
+    duplicateFieldsAvoided: normalizer.duplicateFieldsAvoided
+  }];
+}
+
 var GraphModeNormalizer = /*#__PURE__*/function () {
   function GraphModeNormalizer(variables, options) {
     this._actorIdentifier = options.actorIdentifier;
@@ -105,6 +120,7 @@ var GraphModeNormalizer = /*#__PURE__*/function () {
     this._sentFields = new Map();
     this._nextStreamID = 0;
     this._variables = variables;
+    this.duplicateFieldsAvoided = 0;
   }
 
   var _proto = GraphModeNormalizer.prototype;
@@ -218,6 +234,7 @@ var GraphModeNormalizer = /*#__PURE__*/function () {
 
 
               if (sentFields.has(storageKey)) {
+                this.duplicateFieldsAvoided++;
                 break;
               }
 
@@ -237,6 +254,7 @@ var GraphModeNormalizer = /*#__PURE__*/function () {
 
 
               if (sentFields.has(_storageKey)) {
+                this.duplicateFieldsAvoided++;
                 break;
               }
 
@@ -310,6 +328,18 @@ var GraphModeNormalizer = /*#__PURE__*/function () {
             // over client extensions.
             break;
 
+          case SCALAR_HANDLE:
+          case LINKED_HANDLE:
+            // Handles allow us to record information that will be needed to
+            // perform additional process when we insert data into the store. For
+            // example, connection edges need to be prepended/appended to the
+            // pre-existing values.
+            //
+            // GraphMode will eventually need some replacement for this, but it is
+            // not nessesary in order to measure things like response size, so we
+            // can ignore these for now.
+            break;
+
           default:
             throw new Error("Unexpected selection type: ".concat(selection.kind));
         }
@@ -388,4 +418,6 @@ var GraphModeNormalizer = /*#__PURE__*/function () {
   };
 
   return GraphModeNormalizer;
-}();
+}();
+
+exports.GraphModeNormalizer = GraphModeNormalizer;

package/lib/store/RelayModernOperationDescriptor.js

@@ -34,7 +34,7 @@ var _require3 = require('./RelayStoreUtils'),
 function createOperationDescriptor(request, variables, cacheConfig) {
   var dataID = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : ROOT_ID;
   var operation = request.operation;
-  var operationVariables = getOperationVariables(operation, variables);
+  var operationVariables = getOperationVariables(operation, request.params.providedVariables, variables);
   var requestDescriptor = createRequestDescriptor(request, operationVariables, cacheConfig);
   var operationDescriptor = {
     fragment: createReaderSelector(request.fragment, dataID, operationVariables, requestDescriptor),

package/lib/store/RelayPublishQueue.js

@@ -10,7 +10,7 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var _global$ErrorUtils$ap, _global, _global$ErrorUtils;
+var _global$ErrorUtils$ap, _global$ErrorUtils;
 
 var RelayRecordSourceMutator = require('../mutations/RelayRecordSourceMutator');
 
@@ -26,7 +26,9 @@ var invariant = require('invariant');
 
 var warning = require("fbjs/lib/warning");
 
-var applyWithGuard = (_global$ErrorUtils$ap = (_global = global) === null || _global === void 0 ? void 0 : (_global$ErrorUtils = _global.ErrorUtils) === null || _global$ErrorUtils === void 0 ? void 0 : _global$ErrorUtils.applyWithGuard) !== null && _global$ErrorUtils$ap !== void 0 ? _global$ErrorUtils$ap : function (callback, context, args, onError, name) {
+var _global = typeof global !== 'undefined' ? global : typeof window !== 'undefined' ? window : undefined;
+
+var applyWithGuard = (_global$ErrorUtils$ap = _global === null || _global === void 0 ? void 0 : (_global$ErrorUtils = _global.ErrorUtils) === null || _global$ErrorUtils === void 0 ? void 0 : _global$ErrorUtils.applyWithGuard) !== null && _global$ErrorUtils$ap !== void 0 ? _global$ErrorUtils$ap : function (callback, context, args, onError, name) {
   return callback.apply(context, args);
 };
 /**

package/lib/store/RelayReader.js

@@ -90,6 +90,7 @@ var RelayReader = /*#__PURE__*/function () {
     this._selector = selector;
     this._variables = selector.variables;
     this._resolverCache = resolverCache;
+    this._fragmentName = selector.node.name;
   }
 
   var _proto = RelayReader.prototype;
@@ -219,7 +220,7 @@ var RelayReader = /*#__PURE__*/function () {
       return;
     }
 
-    var owner = this._selector.node.name;
+    var owner = this._fragmentName;
 
     switch (action) {
       case 'THROW':
@@ -236,15 +237,21 @@ var RelayReader = /*#__PURE__*/function () {
         if (this._missingRequiredFields == null) {
           this._missingRequiredFields = {
             action: action,
-            fields: []
+            fields: [{
+              path: fieldPath,
+              owner: owner
+            }]
+          };
+        } else {
+          this._missingRequiredFields = {
+            action: action,
+            fields: [].concat((0, _toConsumableArray2["default"])(this._missingRequiredFields.fields), [{
+              path: fieldPath,
+              owner: owner
+            }])
           };
         }
 
-        this._missingRequiredFields.fields.push({
-          path: fieldPath,
-          owner: owner
-        });
-
         return;
 
       default:
@@ -466,9 +473,7 @@ var RelayReader = /*#__PURE__*/function () {
           throw new Error('Relay Resolver fields are not yet supported.');
         }
 
-        this._readResolverField(selection.field, record, data);
-
-        break;
+        return this._readResolverField(selection.field, record, data);
 
       default:
         selection.field.kind;
@@ -490,6 +495,8 @@ var RelayReader = /*#__PURE__*/function () {
 
     var fragmentValue;
     var fragmentReaderSelector;
+    var fragmentMissingRequiredFields;
+    var previousMissingRequriedFields;
     var fragmentSeenRecordIDs = new Set();
 
     var getDataForResolverFragment = function getDataForResolverFragment(singularReaderSelector) {
@@ -508,14 +515,18 @@ var RelayReader = /*#__PURE__*/function () {
 
         _this._seenRecords = fragmentSeenRecordIDs;
         var resolverFragmentData = {};
+        previousMissingRequriedFields = _this._missingRequiredFields;
+        _this._missingRequiredFields = null;
 
         _this._createInlineDataOrResolverFragmentPointer(singularReaderSelector.node, record, resolverFragmentData);
 
+        fragmentMissingRequiredFields = _this._missingRequiredFields;
         fragmentValue = (_resolverFragmentData = resolverFragmentData[FRAGMENTS_KEY]) === null || _resolverFragmentData === void 0 ? void 0 : _resolverFragmentData[fragment.name];
         !(typeof fragmentValue === 'object' && fragmentValue !== null) ? process.env.NODE_ENV !== "production" ? invariant(false, "Expected reader data to contain a __fragments property with a property for the fragment named ".concat(fragment.name, ", but it is missing.")) : invariant(false) : void 0;
         return fragmentValue;
       } finally {
         _this._seenRecords = existingSeenRecords;
+        _this._missingRequiredFields = previousMissingRequriedFields;
       }
     };
 
@@ -537,12 +548,18 @@ var RelayReader = /*#__PURE__*/function () {
           fragmentValue: fragmentValue,
           resolverID: resolverID,
           seenRecordIDs: fragmentSeenRecordIDs,
-          readerSelector: fragmentReaderSelector
+          readerSelector: fragmentReaderSelector,
+          missingRequiredFields: fragmentMissingRequiredFields
         };
       });
     }, getDataForResolverFragment),
         result = _this$_resolverCache$[0],
-        seenRecord = _this$_resolverCache$[1];
+        seenRecord = _this$_resolverCache$[1],
+        missingRequiredFields = _this$_resolverCache$[2];
+
+    if (missingRequiredFields != null) {
+      this._addMissingRequiredFields(missingRequiredFields);
+    }
 
     if (seenRecord != null) {
       this._seenRecords.add(seenRecord);
@@ -550,6 +567,7 @@ var RelayReader = /*#__PURE__*/function () {
 
     var applicationName = (_field$alias = field.alias) !== null && _field$alias !== void 0 ? _field$alias : field.name;
     data[applicationName] = result;
+    return result;
   };
 
   _proto._readClientEdge = function _readClientEdge(field, record, data) {
@@ -816,13 +834,37 @@ var RelayReader = /*#__PURE__*/function () {
     }
 
     var inlineData = {};
+    var parentFragmentName = this._fragmentName;
+    this._fragmentName = fragmentSpreadOrFragment.name;
 
-    this._traverseSelections(fragmentSpreadOrFragment.selections, record, inlineData); // $FlowFixMe[cannot-write] - writing into read-only field
+    this._traverseSelections(fragmentSpreadOrFragment.selections, record, inlineData);
 
+    this._fragmentName = parentFragmentName; // $FlowFixMe[cannot-write] - writing into read-only field
 
     fragmentPointers[fragmentSpreadOrFragment.name] = inlineData;
   };
 
+  _proto._addMissingRequiredFields = function _addMissingRequiredFields(additional) {
+    if (this._missingRequiredFields == null) {
+      this._missingRequiredFields = additional;
+      return;
+    }
+
+    if (this._missingRequiredFields.action === 'THROW') {
+      return;
+    }
+
+    if (additional.action === 'THROW') {
+      this._missingRequiredFields = additional;
+      return;
+    }
+
+    this._missingRequiredFields = {
+      action: 'LOG',
+      fields: [].concat((0, _toConsumableArray2["default"])(this._missingRequiredFields.fields), (0, _toConsumableArray2["default"])(additional.fields))
+    };
+  };
+
   return RelayReader;
 }();
 

package/lib/store/RelayStoreUtils.js

@@ -211,6 +211,7 @@ var RelayStoreUtils = {
   RELAY_RESOLVER_INVALIDATION_KEY: '__resolverValueMayBeInvalid',
   RELAY_RESOLVER_INPUTS_KEY: '__resolverInputValues',
   RELAY_RESOLVER_READER_SELECTOR_KEY: '__resolverReaderSelector',
+  RELAY_RESOLVER_MISSING_REQUIRED_FIELDS_KEY: '__resolverMissingRequiredFields',
   formatStorageKey: formatStorageKey,
   getArgumentValue: getArgumentValue,
   getArgumentValues: getArgumentValues,

package/lib/store/ResolverCache.js

@@ -24,6 +24,7 @@ var RelayModernRecord = require('./RelayModernRecord');
 var _require2 = require('./RelayStoreUtils'),
     RELAY_RESOLVER_INPUTS_KEY = _require2.RELAY_RESOLVER_INPUTS_KEY,
     RELAY_RESOLVER_INVALIDATION_KEY = _require2.RELAY_RESOLVER_INVALIDATION_KEY,
+    RELAY_RESOLVER_MISSING_REQUIRED_FIELDS_KEY = _require2.RELAY_RESOLVER_MISSING_REQUIRED_FIELDS_KEY,
     RELAY_RESOLVER_READER_SELECTOR_KEY = _require2.RELAY_RESOLVER_READER_SELECTOR_KEY,
     RELAY_RESOLVER_VALUE_KEY = _require2.RELAY_RESOLVER_VALUE_KEY,
     getStorageKey = _require2.getStorageKey;
@@ -39,7 +40,11 @@ var NoopResolverCache = /*#__PURE__*/function () {
   var _proto = NoopResolverCache.prototype;
 
   _proto.readFromCacheOrEvaluate = function readFromCacheOrEvaluate(record, field, variables, evaluate, getDataForResolverFragment) {
-    return [evaluate().resolverResult, undefined];
+    var _evaluate = evaluate(),
+        resolverResult = _evaluate.resolverResult,
+        missingRequiredFields = _evaluate.missingRequiredFields;
+
+    return [resolverResult, undefined, missingRequiredFields];
   };
 
   _proto.invalidateDataIDs = function invalidateDataIDs(updatedDataIDs) {};
@@ -85,6 +90,7 @@ var RecordResolverCache = /*#__PURE__*/function () {
       RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_VALUE_KEY, evaluationResult.resolverResult);
       RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_INPUTS_KEY, evaluationResult.fragmentValue);
       RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_READER_SELECTOR_KEY, evaluationResult.readerSelector);
+      RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_MISSING_REQUIRED_FIELDS_KEY, evaluationResult.missingRequiredFields);
       recordSource.set(linkedID, linkedRecord); // Link the resolver value record to the resolver field of the record being read:
 
       var nextRecord = RelayModernRecord.clone(record);
@@ -112,7 +118,9 @@ var RecordResolverCache = /*#__PURE__*/function () {
 
 
     var answer = linkedRecord[RELAY_RESOLVER_VALUE_KEY];
-    return [answer, linkedID];
+    var missingRequiredFields = // $FlowFixMe[incompatible-type] - casting mixed
+    linkedRecord[RELAY_RESOLVER_MISSING_REQUIRED_FIELDS_KEY];
+    return [answer, linkedID, missingRequiredFields];
   };
 
   _proto2.invalidateDataIDs = function invalidateDataIDs(updatedDataIDs) {

package/lib/store/ResolverFragments.js

@@ -37,9 +37,9 @@ function withResolverContext(context, cb) {
 // The declarations ensure that the type of the returned data is:
 //   - non-nullable if the provided ref type is non-nullable
 //   - nullable if the provided ref type is nullable
-//   - array of non-nullable if the privoided ref type is an array of
+//   - array of non-nullable if the provided ref type is an array of
 //     non-nullable refs
-//   - array of nullable if the privoided ref type is an array of nullable refs
+//   - array of nullable if the provided ref type is an array of nullable refs
 
 
 function readFragment(fragmentInput, fragmentKey) {

package/lib/subscription/requestSubscription.js

@@ -21,8 +21,6 @@ var _require2 = require('../store/RelayModernOperationDescriptor'),
 var _require3 = require('../store/RelayModernSelector'),
     createReaderSelector = _require3.createReaderSelector;
 
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
-
 var warning = require("fbjs/lib/warning");
 
 function requestSubscription(environment, config) {