react-relay 14.1.0 → 16.0.0

package/lib/relay-hooks/prepareEntryPoint_DEPRECATED.js

@@ -1,56 +1,38 @@
-/**
- * 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.
- *
- * @emails oncall+relay
- * 
- * @format
- */
 'use strict';
 
 var preloadQuery = require('./preloadQuery_DEPRECATED');
-
 function prepareEntryPoint(environmentProvider, entryPoint, entryPointParams) {
-  // Start loading the code for the entrypoint
   if (entryPoint.root.getModuleIfRequired() == null) {
     entryPoint.root.load();
   }
-
   var preloadProps = entryPoint.getPreloadProps(entryPointParams);
   var queries = preloadProps.queries,
-      entryPoints = preloadProps.entryPoints;
+    entryPoints = preloadProps.entryPoints;
   var preloadedQueries = {};
   var preloadedEntryPoints = {};
-
   if (queries != null) {
     var queriesPropNames = Object.keys(queries);
     queriesPropNames.forEach(function (queryPropName) {
       var _queries$queryPropNam = queries[queryPropName],
-          environmentProviderOptions = _queries$queryPropNam.environmentProviderOptions,
-          options = _queries$queryPropNam.options,
-          parameters = _queries$queryPropNam.parameters,
-          variables = _queries$queryPropNam.variables;
+        environmentProviderOptions = _queries$queryPropNam.environmentProviderOptions,
+        options = _queries$queryPropNam.options,
+        parameters = _queries$queryPropNam.parameters,
+        variables = _queries$queryPropNam.variables;
       var environment = environmentProvider.getEnvironment(environmentProviderOptions);
       preloadedQueries[queryPropName] = preloadQuery(environment, parameters, variables, options, environmentProviderOptions);
     });
   }
-
   if (entryPoints != null) {
     var entryPointPropNames = Object.keys(entryPoints);
     entryPointPropNames.forEach(function (entryPointPropName) {
       var entryPointDescription = entryPoints[entryPointPropName];
-
       if (entryPointDescription == null) {
         return;
       }
-
       var nestedEntryPoint = entryPointDescription.entryPoint,
-          nestedParams = entryPointDescription.entryPointParams;
+        nestedParams = entryPointDescription.entryPointParams;
       preloadedEntryPoints[entryPointPropName] = prepareEntryPoint(environmentProvider, nestedEntryPoint, nestedParams);
     });
   }
 }
-
 module.exports = prepareEntryPoint;

package/lib/relay-hooks/react-cache/RelayReactCache.js

@@ -1,35 +1,19 @@
-/**
- * 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.
- *
- * 
- * @emails oncall+relay
- * @format
- */
 'use strict';
 
-var invariant = require('invariant'); // $FlowFixMe[prop-missing] These exist in experimental builds but aren't in React's types yet.
-
-
+var invariant = require('invariant');
 var _require = require('react'),
-    unstable_getCacheForType = _require.unstable_getCacheForType,
-    unstable_getCacheSignal = _require.unstable_getCacheSignal;
-
+  unstable_getCacheForType = _require.unstable_getCacheForType,
+  unstable_getCacheSignal = _require.unstable_getCacheSignal;
 var _require2 = require('relay-runtime'),
-    RelayFeatureFlags = _require2.RelayFeatureFlags;
-
+  RelayFeatureFlags = _require2.RelayFeatureFlags;
 function getCacheForType(factory) {
   !(typeof unstable_getCacheForType === 'function' && RelayFeatureFlags.USE_REACT_CACHE) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReactCache.getCacheForType should only be called when the USE_REACT_CACHE feature flag is enabled and when on an experimental React build that supports it.') : invariant(false) : void 0;
   return unstable_getCacheForType(factory);
 }
-
 function getCacheSignal() {
   !(typeof unstable_getCacheSignal === 'function' && RelayFeatureFlags.USE_REACT_CACHE) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReactCache.getCacheSignal should only be called when the USE_REACT_CACHE feature flag is enabled and when on an experimental React build that supports it.') : invariant(false) : void 0;
   return unstable_getCacheSignal();
 }
-
 module.exports = {
   getCacheForType: getCacheForType,
   getCacheSignal: getCacheSignal

package/lib/relay-hooks/react-cache/getQueryResultOrFetchQuery_REACT_CACHE.js

@@ -1,102 +1,64 @@
-/**
- * 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.
- *
- * 
- * @emails oncall+relay
- * @format
- */
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
-
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-
 var SuspenseResource = require('../SuspenseResource');
-
 var _require = require('./RelayReactCache'),
-    getCacheForType = _require.getCacheForType,
-    getCacheSignal = _require.getCacheSignal;
-
+  getCacheForType = _require.getCacheForType,
+  getCacheSignal = _require.getCacheSignal;
 var invariant = require('invariant');
-
 var _require2 = require('relay-runtime'),
-    RelayFeatureFlags = _require2.RelayFeatureFlags,
-    fetchQueryInternal = _require2.__internal.fetchQuery;
-
+  fetchQueryInternal = _require2.__internal.fetchQuery,
+  RelayFeatureFlags = _require2.RelayFeatureFlags;
 var warning = require("fbjs/lib/warning");
-
 var DEFAULT_FETCH_POLICY = 'store-or-network';
 var WEAKMAP_SUPPORTED = typeof WeakMap === 'function';
-
 var QueryCache = /*#__PURE__*/function () {
   function QueryCache() {
     this._map = WEAKMAP_SUPPORTED ? new WeakMap() : new Map();
   }
-
   var _proto = QueryCache.prototype;
-
   _proto.get = function get(environment, key) {
     var forEnv = this._map.get(environment);
-
     if (!forEnv) {
       forEnv = new Map();
-
       this._map.set(environment, forEnv);
     }
-
     return forEnv.get(key);
   };
-
   _proto.set = function set(environment, key, value) {
     var forEnv = this._map.get(environment);
-
     if (!forEnv) {
       forEnv = new Map();
-
       this._map.set(environment, forEnv);
     }
-
     forEnv.set(key, value);
   };
-
   _proto["delete"] = function _delete(environment, key) {
     var forEnv = this._map.get(environment);
-
     if (!forEnv) {
       return;
     }
-
     forEnv["delete"](key);
-
     if (forEnv.size === 0) {
       this._map["delete"](environment);
     }
   };
-
   return QueryCache;
 }();
-
 function createQueryCache() {
   return new QueryCache();
 }
-
 var noopOnCommit = function noopOnCommit() {
   return function () {
     return undefined;
   };
 };
-
 var noopPromise = new Promise(function () {});
-
 function getQueryCacheKey(operation, fetchPolicy, renderPolicy, fetchKey) {
   return "".concat(fetchPolicy, "-").concat(renderPolicy, "-").concat(operation.request.identifier, "-").concat(fetchKey !== null && fetchKey !== void 0 ? fetchKey : '');
 }
-
 function constructQueryResult(operation) {
   var rootFragmentRef = {
     __id: operation.fragment.dataID,
@@ -108,7 +70,6 @@ function constructQueryResult(operation) {
     fragmentRef: rootFragmentRef
   };
 }
-
 function makeInitialCacheEntry() {
   return {
     status: 'pending',
@@ -117,35 +78,24 @@ function makeInitialCacheEntry() {
     suspenseResource: null
   };
 }
-
 function getQueryResultOrFetchQuery_REACT_CACHE(environment, queryOperationDescriptor, options) {
   var _options$fetchPolicy, _options$renderPolicy;
-
   var fetchPolicy = (_options$fetchPolicy = options === null || options === void 0 ? void 0 : options.fetchPolicy) !== null && _options$fetchPolicy !== void 0 ? _options$fetchPolicy : DEFAULT_FETCH_POLICY;
   var renderPolicy = (_options$renderPolicy = options === null || options === void 0 ? void 0 : options.renderPolicy) !== null && _options$renderPolicy !== void 0 ? _options$renderPolicy : environment.UNSTABLE_getDefaultRenderPolicy();
   var cache = getCacheForType(createQueryCache);
   var cacheKey = getQueryCacheKey(queryOperationDescriptor, fetchPolicy, renderPolicy, options === null || options === void 0 ? void 0 : options.fetchKey);
   var initialEntry = cache.get(environment, cacheKey);
-
   function updateCache(updater) {
     var currentEntry = cache.get(environment, cacheKey);
-
     if (!currentEntry) {
       currentEntry = makeInitialCacheEntry();
       cache.set(environment, cacheKey, currentEntry);
-    } // $FlowExpectedError[prop-missing] Extra properties are passed in -- this is fine
-
-
-    var newStatus = updater(currentEntry); // $FlowExpectedError[cannot-spread-inexact] Flow cannot understand that this is valid...
-
-    cache.set(environment, cacheKey, (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, currentEntry), newStatus)); // ... but we can because QueryCacheEntry spreads QueryCacheEntryStatus, so spreading
-    // a QueryCacheEntryStatus into a QueryCacheEntry will result in a valid QueryCacheEntry.
-  } // Initiate a query to fetch the data if needed:
-
-
+    }
+    var newStatus = updater(currentEntry);
+    cache.set(environment, cacheKey, (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, currentEntry), newStatus));
+  }
   if (RelayFeatureFlags.USE_REACT_CACHE_LEGACY_TIMEOUTS) {
     var _entry;
-
     if (initialEntry === undefined) {
       onCacheMiss(environment, queryOperationDescriptor, fetchPolicy, renderPolicy, updateCache, options === null || options === void 0 ? void 0 : options.fetchObservable);
       var createdEntry = cache.get(environment, cacheKey);
@@ -154,7 +104,6 @@ function getQueryResultOrFetchQuery_REACT_CACHE(environment, queryOperationDescr
     } else {
       _entry = initialEntry;
     }
-
     if (!_entry.suspenseResource) {
       _entry.suspenseResource = new SuspenseResource(function () {
         var retention = environment.retain(queryOperationDescriptor);
@@ -166,70 +115,49 @@ function getQueryResultOrFetchQuery_REACT_CACHE(environment, queryOperationDescr
         };
       });
     }
-
     if (_entry.onCommit === noopOnCommit) {
       _entry.onCommit = function () {
         !_entry.suspenseResource ? process.env.NODE_ENV !== "production" ? invariant(false, 'SuspenseResource should have been initialized. This is a bug in Relay.') : invariant(false) : void 0;
-
         var retention = _entry.suspenseResource.permanentRetain(environment);
-
         return function () {
           retention.dispose();
         };
       };
     }
-
     _entry.suspenseResource.temporaryRetain(environment);
   } else {
     if (initialEntry === undefined) {
-      // This is the behavior we eventually want: We retain the query until the
-      // presiding Cache component unmounts, at which point the AbortSignal
-      // will be triggered.
-      onCacheMiss(environment, queryOperationDescriptor, fetchPolicy, renderPolicy, updateCache, options === null || options === void 0 ? void 0 : options.fetchObservable); // Since this is the first time rendering, retain the query. React will
-      // trigger the abort signal when this cache entry is no longer needed.
-
+      onCacheMiss(environment, queryOperationDescriptor, fetchPolicy, renderPolicy, updateCache, options === null || options === void 0 ? void 0 : options.fetchObservable);
       var retention = environment.retain(queryOperationDescriptor);
-
       var dispose = function dispose() {
         retention.dispose();
         cache["delete"](environment, cacheKey);
       };
-
       var abortSignal = getCacheSignal();
       abortSignal.addEventListener('abort', dispose, {
         once: true
       });
     }
   }
-
-  var entry = cache.get(environment, cacheKey); // could be a different entry now if synchronously resolved
-
+  var entry = cache.get(environment, cacheKey);
   !(entry !== undefined) ? process.env.NODE_ENV !== "production" ? invariant(false, 'An entry should have been created by onCacheMiss. This is a bug in Relay.') : invariant(false) : void 0;
-
   switch (entry.status) {
     case 'pending':
       throw entry.promise;
-
     case 'rejected':
       throw entry.error;
-
     case 'resolved':
       return [entry.result, entry.onCommit];
   }
-
   !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'switch statement should be exhaustive') : invariant(false) : void 0;
 }
-
 function onCacheMiss(environment, operation, fetchPolicy, renderPolicy, updateCache, customFetchObservable) {
-  // NB: Besides checking if the data is available, calling `check` will write missing
-  // data to the store using any missing data handlers specified in the environment.
   var queryAvailability = environment.check(operation);
   var queryStatus = queryAvailability.status;
   var hasFullQuery = queryStatus === 'available';
   var canPartialRender = hasFullQuery || renderPolicy === 'partial' && queryStatus !== 'stale';
   var shouldFetch;
   var shouldRenderNow;
-
   switch (fetchPolicy) {
     case 'store-only':
       {
@@ -237,21 +165,18 @@ function onCacheMiss(environment, operation, fetchPolicy, renderPolicy, updateCa
         shouldRenderNow = true;
         break;
       }
-
     case 'store-or-network':
       {
         shouldFetch = !hasFullQuery;
         shouldRenderNow = canPartialRender;
         break;
       }
-
     case 'store-and-network':
       {
         shouldFetch = true;
         shouldRenderNow = canPartialRender;
         break;
       }
-
     case 'network-only':
     default:
       {
@@ -260,17 +185,14 @@ function onCacheMiss(environment, operation, fetchPolicy, renderPolicy, updateCa
         break;
       }
   }
-
   if (shouldFetch) {
     executeOperationAndKeepUpToDate(environment, operation, updateCache, customFetchObservable);
     updateCache(function (existing) {
       switch (existing.status) {
         case 'resolved':
           return existing;
-
         case 'rejected':
           return existing;
-
         case 'pending':
           return shouldRenderNow ? {
             status: 'resolved',
@@ -288,16 +210,13 @@ function onCacheMiss(environment, operation, fetchPolicy, renderPolicy, updateCa
     });
   }
 }
-
 function executeOperationAndKeepUpToDate(environment, operation, updateCache, customFetchObservable) {
   var resolvePromise;
   var promise = new Promise(function (r) {
     resolvePromise = r;
-  }); // $FlowExpectedError[prop-missing] Expando to annotate Promises.
-
+  });
   promise.displayName = 'Relay(' + operation.request.node.operation.name + ')';
-  var isFirstPayload = true; // FIXME We may still need to cancel network requests for live queries.
-
+  var isFirstPayload = true;
   var fetchObservable = customFetchObservable !== null && customFetchObservable !== void 0 ? customFetchObservable : fetchQueryInternal(environment, operation);
   fetchObservable.subscribe({
     start: function start(subscription) {},
@@ -310,16 +229,12 @@ function executeOperationAndKeepUpToDate(environment, operation, updateCache, cu
           };
         });
       } else {
-        // TODO:T92030819 Remove this warning and actually throw the network error
-        // To complete this task we need to have a way of precisely tracking suspendable points
         process.env.NODE_ENV !== "production" ? warning(false, 'getQueryResultOrFetchQuery: An incremental payload for query `%` returned an error: `%`:`%`.', operation.request.node.operation.name, _error.message, _error.stack) : void 0;
       }
-
       resolvePromise();
       isFirstPayload = false;
     },
     next: function next(response) {
-      // Stop suspending on the first payload because of streaming, defer, etc.
       updateCache(function (_existing) {
         return {
           status: 'resolved',
@@ -329,10 +244,7 @@ function executeOperationAndKeepUpToDate(environment, operation, updateCache, cu
       resolvePromise();
       isFirstPayload = false;
     }
-  }); // If the above subscription yields a value synchronously, then one of the updates
-  // above will have already happened and we'll now be in a resolved or rejected state.
-  // But in the usual case, we save the promise to the entry here:
-
+  });
   updateCache(function (existing) {
     return existing.status === 'pending' ? {
       status: 'pending',
@@ -340,5 +252,4 @@ function executeOperationAndKeepUpToDate(environment, operation, updateCache, cu
     } : existing;
   });
 }
-
 module.exports = getQueryResultOrFetchQuery_REACT_CACHE;

package/lib/relay-hooks/react-cache/readFragmentInternal_REACT_CACHE.js

@@ -1,36 +1,20 @@
-/**
- * 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.
- *
- * 
- * @emails oncall+relay
- * @format
- */
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
-
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-
 var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
-
 var _require = require('../QueryResource'),
-    getQueryResourceForEnvironment = _require.getQueryResourceForEnvironment;
-
+  getQueryResourceForEnvironment = _require.getQueryResourceForEnvironment;
 var invariant = require('invariant');
-
 var _require2 = require('relay-runtime'),
-    fetchQueryInternal = _require2.__internal.fetchQuery,
-    createOperationDescriptor = _require2.createOperationDescriptor,
-    getPendingOperationsForFragment = _require2.getPendingOperationsForFragment,
-    getSelector = _require2.getSelector,
-    getVariablesFromFragment = _require2.getVariablesFromFragment,
-    handlePotentialSnapshotErrors = _require2.handlePotentialSnapshotErrors;
-
+  fetchQueryInternal = _require2.__internal.fetchQuery,
+  RelayFeatureFlags = _require2.RelayFeatureFlags,
+  createOperationDescriptor = _require2.createOperationDescriptor,
+  getPendingOperationsForFragment = _require2.getPendingOperationsForFragment,
+  getSelector = _require2.getSelector,
+  getVariablesFromFragment = _require2.getVariablesFromFragment,
+  handlePotentialSnapshotErrors = _require2.handlePotentialSnapshotErrors;
 var warning = require("fbjs/lib/warning");
-
 function isMissingData(state) {
   if (state.kind === 'bailout') {
     return false;
@@ -42,32 +26,24 @@ function isMissingData(state) {
     });
   }
 }
-
 function getMissingClientEdges(state) {
   if (state.kind === 'bailout') {
     return null;
   } else if (state.kind === 'singular') {
     var _state$snapshot$missi;
-
     return (_state$snapshot$missi = state.snapshot.missingClientEdges) !== null && _state$snapshot$missi !== void 0 ? _state$snapshot$missi : null;
   } else {
     var edges = null;
-
     var _iterator = (0, _createForOfIteratorHelper2["default"])(state.snapshots),
-        _step;
-
+      _step;
     try {
       for (_iterator.s(); !(_step = _iterator.n()).done;) {
         var snapshot = _step.value;
-
         if (snapshot.missingClientEdges) {
           var _edges;
-
           edges = (_edges = edges) !== null && _edges !== void 0 ? _edges : [];
-
           var _iterator2 = (0, _createForOfIteratorHelper2["default"])(snapshot.missingClientEdges),
-              _step2;
-
+            _step2;
           try {
             for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
               var edge = _step2.value;
@@ -85,18 +61,15 @@ function getMissingClientEdges(state) {
     } finally {
       _iterator.f();
     }
-
     return edges;
   }
 }
-
 function handlePotentialSnapshotErrorsForState(environment, state) {
   if (state.kind === 'singular') {
     handlePotentialSnapshotErrors(environment, state.snapshot.missingRequiredFields, state.snapshot.relayResolverErrors);
   } else if (state.kind === 'plural') {
     var _iterator3 = (0, _createForOfIteratorHelper2["default"])(state.snapshots),
-        _step3;
-
+      _step3;
     try {
       for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
         var snapshot = _step3.value;
@@ -109,22 +82,15 @@ function handlePotentialSnapshotErrorsForState(environment, state) {
     }
   }
 }
-
 function handleMissingClientEdge(environment, parentFragmentNode, parentFragmentRef, missingClientEdgeRequestInfo, queryOptions) {
   var originalVariables = getVariablesFromFragment(parentFragmentNode, parentFragmentRef);
   var variables = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, originalVariables), {}, {
-    id: missingClientEdgeRequestInfo.clientEdgeDestinationID // TODO should be a reserved name
-
+    id: missingClientEdgeRequestInfo.clientEdgeDestinationID
   });
-  var queryOperationDescriptor = createOperationDescriptor(missingClientEdgeRequestInfo.request, variables, queryOptions === null || queryOptions === void 0 ? void 0 : queryOptions.networkCacheConfig); // This may suspend. We don't need to do anything with the results; all we're
-  // doing here is started the query if needed and retaining and releasing it
-  // according to the component mount/suspense cycle; QueryResource
-  // already handles this by itself.
-
+  var queryOperationDescriptor = createOperationDescriptor(missingClientEdgeRequestInfo.request, variables, queryOptions === null || queryOptions === void 0 ? void 0 : queryOptions.networkCacheConfig);
   var QueryResource = getQueryResourceForEnvironment(environment);
   return QueryResource.prepare(queryOperationDescriptor, fetchQueryInternal(environment, queryOperationDescriptor), queryOptions === null || queryOptions === void 0 ? void 0 : queryOptions.fetchPolicy);
 }
-
 function getFragmentState(environment, fragmentSelector) {
   if (fragmentSelector == null) {
     return {
@@ -151,36 +117,25 @@ function getFragmentState(environment, fragmentSelector) {
       epoch: environment.getStore().getEpoch()
     };
   }
-} // fragmentNode cannot change during the lifetime of the component, though fragmentRef may change.
-
-
+}
 function readFragmentInternal_REACT_CACHE(environment, fragmentNode, fragmentRef, hookDisplayName, queryOptions, fragmentKey) {
   var _fragmentNode$metadat, _fragmentNode$metadat2;
-
   var fragmentSelector = getSelector(fragmentNode, fragmentRef);
   var isPlural = (fragmentNode === null || fragmentNode === void 0 ? void 0 : (_fragmentNode$metadat = fragmentNode.metadata) === null || _fragmentNode$metadat === void 0 ? void 0 : _fragmentNode$metadat.plural) === true;
-
   if (isPlural) {
     !(fragmentRef == null || Array.isArray(fragmentRef)) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected fragment pointer%s for fragment `%s` to be ' + 'an array, instead got `%s`. Remove `@relay(plural: true)` ' + 'from fragment `%s` to allow the prop to be an object.', fragmentKey != null ? " for key `".concat(fragmentKey, "`") : '', fragmentNode.name, typeof fragmentRef, fragmentNode.name) : invariant(false) : void 0;
   } else {
     !!Array.isArray(fragmentRef) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected fragment pointer%s for fragment `%s` not to be ' + 'an array, instead got `%s`. Add `@relay(plural: true)` ' + 'to fragment `%s` to allow the prop to be an array.', fragmentKey != null ? " for key `".concat(fragmentKey, "`") : '', fragmentNode.name, typeof fragmentRef, fragmentNode.name) : invariant(false) : void 0;
   }
-
   !(fragmentRef == null || isPlural && Array.isArray(fragmentRef) && fragmentRef.length === 0 || fragmentSelector != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected to receive an object where `...%s` was spread, ' + 'but the fragment reference was not found`. This is most ' + 'likely the result of:\n' + "- Forgetting to spread `%s` in `%s`'s parent's fragment.\n" + '- Conditionally fetching `%s` but unconditionally passing %s prop ' + 'to `%s`. If the parent fragment only fetches the fragment conditionally ' + '- with e.g. `@include`, `@skip`, or inside a `... on SomeType { }` ' + 'spread  - then the fragment reference will not exist. ' + 'In this case, pass `null` if the conditions for evaluating the ' + 'fragment are not met (e.g. if the `@include(if)` value is false.)', fragmentNode.name, fragmentNode.name, hookDisplayName, fragmentNode.name, fragmentKey == null ? 'a fragment reference' : "the `".concat(fragmentKey, "`"), hookDisplayName) : invariant(false) : void 0;
-  var state = getFragmentState(environment, fragmentSelector); // Handle the queries for any missing client edges; this may suspend.
-  // FIXME handle client edges in parallel.
-
+  var state = getFragmentState(environment, fragmentSelector);
   var clientEdgeQueries = null;
-
   if (((_fragmentNode$metadat2 = fragmentNode.metadata) === null || _fragmentNode$metadat2 === void 0 ? void 0 : _fragmentNode$metadat2.hasClientEdges) === true) {
     var missingClientEdges = getMissingClientEdges(state);
-
     if (missingClientEdges !== null && missingClientEdges !== void 0 && missingClientEdges.length) {
       clientEdgeQueries = [];
-
       var _iterator4 = (0, _createForOfIteratorHelper2["default"])(missingClientEdges),
-          _step4;
-
+        _step4;
       try {
         for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
           var edge = _step4.value;
@@ -193,25 +148,16 @@ function readFragmentInternal_REACT_CACHE(environment, fragmentNode, fragmentRef
       }
     }
   }
-
   if (isMissingData(state)) {
-    // Suspend if an active operation bears on this fragment, either the
-    // fragment's owner or some other mutation etc. that could affect it:
     !(fragmentSelector != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'refinement, see invariants above') : invariant(false) : void 0;
     var fragmentOwner = fragmentSelector.kind === 'PluralReaderSelector' ? fragmentSelector.selectors[0].owner : fragmentSelector.owner;
     var pendingOperationsResult = getPendingOperationsForFragment(environment, fragmentNode, fragmentOwner);
-
     if (pendingOperationsResult) {
       throw pendingOperationsResult.promise;
-    } // Report required fields only if we're not suspending, since that means
-    // they're missing even though we are out of options for possibly fetching them:
-
-
+    }
     handlePotentialSnapshotErrorsForState(environment, state);
   }
-
   var data;
-
   if (state.kind === 'bailout') {
     data = isPlural ? [] : null;
   } else if (state.kind === 'singular') {
@@ -221,19 +167,16 @@ function readFragmentInternal_REACT_CACHE(environment, fragmentNode, fragmentRef
       return s.data;
     });
   }
-
-  if (process.env.NODE_ENV !== "production") {
+  if (RelayFeatureFlags.LOG_MISSING_RECORDS_IN_PROD || process.env.NODE_ENV !== "production") {
     if (fragmentRef != null && (data === undefined || Array.isArray(data) && data.length > 0 && data.every(function (d) {
       return d === undefined;
     }))) {
       process.env.NODE_ENV !== "production" ? warning(false, 'Relay: Expected to have been able to read non-null data for ' + 'fragment `%s` declared in ' + '`%s`, since fragment reference was non-null. ' + "Make sure that that `%s`'s parent isn't " + 'holding on to and/or passing a fragment reference for data that ' + 'has been deleted.', fragmentNode.name, hookDisplayName, hookDisplayName) : void 0;
     }
   }
-
   return {
     data: data,
     clientEdgeQueries: clientEdgeQueries
   };
 }
-
 module.exports = readFragmentInternal_REACT_CACHE;