react-relay 15.0.0 → 16.1.0

package/lib/jest-react/internalAct.js

@@ -1,33 +1,7 @@
-/**
- * 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.
- *
- * @format
- * @oncall relay
- */
-
-/* global jest */
-
-// This file is sync'd from https://github.com/facebook/react/tree/main/packages/jest-react
-
-// This version of `act` is only used by our tests. Unlike the public version
-// of `act`, it's designed to work identically in both production and
-// development. It may have slightly different behavior from the public
-// version, too, since our constraints in our test suite are not the same as
-// those of developers using React — we're testing React itself, as opposed to
-// building an app with React.
-
 'use strict';
 
 var enqueueTask = require('./enqueueTask');
 var Scheduler = require('scheduler/unstable_mock');
-
-// The subset of a Promise that React APIs rely on. This resolves a value.
-// This doesn't require a return value neither from the handler nor the
-// then function.
-
 var actingUpdatesScopeDepth = 0;
 function act(scope) {
   if (Scheduler.unstable_flushAllWithoutAsserting === undefined) {
@@ -40,8 +14,6 @@ function act(scope) {
   var previousActingUpdatesScopeDepth = actingUpdatesScopeDepth;
   actingUpdatesScopeDepth++;
   if (process.env.NODE_ENV !== "production" && actingUpdatesScopeDepth === 1) {
-    // Because this is not the "real" `act`, we set this to `false` so React
-    // knows not to fire `act` warnings.
     global.IS_REACT_ACT_ENVIRONMENT = false;
   }
   var unwind = function unwind() {
@@ -51,16 +23,10 @@ function act(scope) {
     actingUpdatesScopeDepth--;
     if (process.env.NODE_ENV !== "production") {
       if (actingUpdatesScopeDepth > previousActingUpdatesScopeDepth) {
-        // if it's _less than_ previousActingUpdatesScopeDepth, then we can
-        // assume the 'other' one has warned
         console.error('You seem to have overlapping act() calls, this is not supported. ' + 'Be sure to await previous act() calls before making a new one. ');
       }
     }
   };
-
-  // TODO: This would be way simpler if 1) we required a promise to be
-  // returned and 2) we could use async/await. Since it's only our used in
-  // our test suite, we should be able to.
   try {
     var result = scope();
     if (typeof result === 'object' && result !== null && typeof result.then === 'function') {
@@ -84,8 +50,6 @@ function act(scope) {
     } else {
       var returnValue = result;
       try {
-        // TODO: Let's not support non-async scopes at all in our tests. Need to
-        // migrate existing tests.
         var didFlushWork;
         do {
           didFlushWork = Scheduler.unstable_flushAllWithoutAsserting();
@@ -105,8 +69,6 @@ function act(scope) {
   }
 }
 function flushActWork(resolve, reject) {
-  // Flush suspended fallbacks
-  // $FlowFixMe: Flow doesn't know about global Jest object
   jest.runOnlyPendingTimers();
   enqueueTask(function () {
     try {

package/lib/legacy.js

@@ -1,14 +1,3 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var ReactRelayContext = require('./ReactRelayContext');
@@ -18,10 +7,6 @@ var ReactRelayPaginationContainer = require('./ReactRelayPaginationContainer');
 var ReactRelayQueryRenderer = require('./ReactRelayQueryRenderer');
 var ReactRelayRefetchContainer = require('./ReactRelayRefetchContainer');
 var RelayRuntime = require('relay-runtime');
-/**
- * Legacy react-relay exports.
- * Should prefer using interface defined in ./hooks.js
- */
 module.exports = {
   ConnectionHandler: RelayRuntime.ConnectionHandler,
   QueryRenderer: ReactRelayQueryRenderer,

package/lib/multi-actor/ActorChange.js

@@ -1,14 +1,3 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var RelayEnvironmentProvider = require('../relay-hooks/RelayEnvironmentProvider');

package/lib/multi-actor/index.js

@@ -1,12 +1 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';

package/lib/multi-actor/useRelayActorEnvironment.js

@@ -1,14 +1,3 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var ReactRelayContext = require('./../ReactRelayContext');

package/lib/relay-hooks/EntryPointContainer.react.js

@@ -1,14 +1,3 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var ProfilerContext = require('./ProfilerContext');

package/lib/relay-hooks/EntryPointTypes.flow.js

@@ -1,14 +1 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
-'use strict';
-
-/* eslint-disable no-unused-vars */
+'use strict';

package/lib/relay-hooks/FragmentResource.js

@@ -1,14 +1,3 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
@@ -34,12 +23,7 @@ var _require2 = require('relay-runtime'),
   isPromise = _require2.isPromise,
   recycleNodesInto = _require2.recycleNodesInto;
 var WEAKMAP_SUPPORTED = typeof WeakMap === 'function';
-// TODO: Fix to not rely on LRU. If the number of active fragments exceeds this
-// capacity, readSpec() will fail to find cached entries and break object
-// identity even if data hasn't changed.
 var CACHE_CAPACITY = 1000000;
-
-// this is frozen so that users don't accidentally push data into the array
 var CONSTANT_READONLY_EMPTY_ARRAY = Object.freeze([]);
 function isMissingData(snapshot) {
   if (Array.isArray(snapshot)) {
@@ -94,13 +78,6 @@ function getFragmentResult(cacheKey, snapshot, storeEpoch) {
     storeEpoch: storeEpoch
   };
 }
-
-/**
- * The purpose of this cache is to allow information to be passed from an
- * initial read which suspends through to the commit that follows a subsequent
- * successful read. Specifically, the QueryResource result for the data fetch
- * is passed through so that that query can be retained on commit.
- */
 var ClientEdgeQueryResultsCache = /*#__PURE__*/function () {
   function ClientEdgeQueryResultsCache(environment) {
     (0, _defineProperty2["default"])(this, "_cache", new Map());
@@ -112,8 +89,7 @@ var ClientEdgeQueryResultsCache = /*#__PURE__*/function () {
     var _this$_cache$get$, _this$_cache$get;
     return (_this$_cache$get$ = (_this$_cache$get = this._cache.get(fragmentIdentifier)) === null || _this$_cache$get === void 0 ? void 0 : _this$_cache$get[0]) !== null && _this$_cache$get$ !== void 0 ? _this$_cache$get$ : undefined;
   };
-  _proto.recordQueryResults = function recordQueryResults(fragmentIdentifier, value // may be mutated after being passed here
-  ) {
+  _proto.recordQueryResults = function recordQueryResults(fragmentIdentifier, value) {
     var _this = this;
     var existing = this._cache.get(fragmentIdentifier);
     if (!existing) {
@@ -159,30 +135,14 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       this._clientEdgeQueryResultsCache = new ClientEdgeQueryResultsCache(environment);
     }
   }
-
-  /**
-   * This function should be called during a Component's render function,
-   * to read the data for a fragment, or suspend if the fragment is being
-   * fetched.
-   */
   var _proto2 = FragmentResourceImpl.prototype;
   _proto2.read = function read(fragmentNode, fragmentRef, componentDisplayName, fragmentKey) {
     return this.readWithIdentifier(fragmentNode, fragmentRef, getFragmentIdentifier(fragmentNode, fragmentRef), componentDisplayName, fragmentKey);
-  }
-
-  /**
-   * Like `read`, but with a pre-computed fragmentIdentifier that should be
-   * equal to `getFragmentIdentifier(fragmentNode, fragmentRef)` from the
-   * arguments.
-   */;
+  };
   _proto2.readWithIdentifier = function readWithIdentifier(fragmentNode, fragmentRef, fragmentIdentifier, componentDisplayName, fragmentKey) {
     var _this3 = this;
     var _fragmentNode$metadat, _fragmentNode$metadat2, _missingLiveResolverF2, _missingLiveResolverF3;
     var environment = this._environment;
-
-    // If fragmentRef is null or undefined, pass it directly through.
-    // This is a convenience when consuming fragments via a HOC API, when the
-    // prop corresponding to the fragment ref might be passed as null.
     if (fragmentRef == null) {
       return {
         cacheKey: fragmentIdentifier,
@@ -193,9 +153,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       };
     }
     var storeEpoch = environment.getStore().getEpoch();
-
-    // If fragmentRef is plural, ensure that it is an array.
-    // If it's empty, return the empty array directly before doing any more work.
     if ((fragmentNode === null || fragmentNode === void 0 ? void 0 : (_fragmentNode$metadat = fragmentNode.metadata) === null || _fragmentNode$metadat === void 0 ? void 0 : _fragmentNode$metadat.plural) === true) {
       !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;
       if (fragmentRef.length === 0) {
@@ -208,10 +165,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         };
       }
     }
-
-    // Now we actually attempt to read the fragment:
-
-    // 1. Check if there's a cached value for this fragment
     var cachedValue = this._cache.get(fragmentIdentifier);
     if (cachedValue != null) {
       var _missingLiveResolverF;
@@ -228,13 +181,7 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         throw cachedValue.promise;
       }
       if (cachedValue.kind === 'done' && cachedValue.result.snapshot && !((_missingLiveResolverF = missingLiveResolverFields(cachedValue.result.snapshot)) !== null && _missingLiveResolverF !== void 0 && _missingLiveResolverF.length)) {
-        this._throwOrLogErrorsInSnapshot(
-        // $FlowFixMe[incompatible-call]
-        cachedValue.result.snapshot);
-
-        // This cache gets populated directly whenever the store notifies us of
-        // an update. That mechanism does not check for missing data, or
-        // in-flight requests.
+        this._throwOrLogErrorsInSnapshot(cachedValue.result.snapshot);
         if (cachedValue.result.isMissingData) {
           environment.__log({
             name: 'fragmentresource.missing_data',
@@ -247,15 +194,19 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         return cachedValue.result;
       }
     }
-
-    // 2. If not, try reading the fragment from the Relay store.
-    // If the snapshot has data, return it and save it in cache
     var fragmentSelector = getSelector(fragmentNode, fragmentRef);
     !(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, componentDisplayName, fragmentNode.name, fragmentKey == null ? 'a fragment reference' : "the `".concat(fragmentKey, "`"), componentDisplayName) : invariant(false) : void 0;
-    var snapshot = fragmentSelector.kind === 'PluralReaderSelector' ? fragmentSelector.selectors.map(function (s) {
-      return environment.lookup(s);
-    }) : environment.lookup(fragmentSelector);
-    var fragmentResult = getFragmentResult(fragmentIdentifier, snapshot, storeEpoch);
+    var fragmentResult = null;
+    var snapshot = null;
+    if (RelayFeatureFlags.ENABLE_RELAY_OPERATION_TRACKER_SUSPENSE && cachedValue != null && cachedValue.kind === 'missing') {
+      fragmentResult = cachedValue.result;
+      snapshot = cachedValue.snapshot;
+    } else {
+      snapshot = fragmentSelector.kind === 'PluralReaderSelector' ? fragmentSelector.selectors.map(function (s) {
+        return environment.lookup(s);
+      }) : environment.lookup(fragmentSelector);
+      fragmentResult = getFragmentResult(fragmentIdentifier, snapshot, storeEpoch);
+    }
     if (!fragmentResult.isMissingData) {
       this._throwOrLogErrorsInSnapshot(snapshot);
       this._cache.set(fragmentIdentifier, {
@@ -264,17 +215,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       });
       return fragmentResult;
     }
-
-    // 3. If we don't have data in the store, there's two cases where we should
-    // suspend to await the data: First if any client edges were traversed where
-    // the destination record was missing data; in that case we initiate a query
-    // here to fetch the missing data. Second, there may already be a request
-    // in flight for the fragment's parent query, or for another operation that
-    //  may affect the parent's query data, such as a mutation or subscription.
-    // For any of these cases we can get a promise, which we will cache and
-    // suspend on.
-
-    // First, initiate a query for any client edges that were missing data:
     var clientEdgeRequests = null;
     if (RelayFeatureFlags.ENABLE_CLIENT_EDGES && ((_fragmentNode$metadat2 = fragmentNode.metadata) === null || _fragmentNode$metadat2 === void 0 ? void 0 : _fragmentNode$metadat2.hasClientEdges) === true && hasMissingClientEdges(snapshot)) {
       clientEdgeRequests = [];
@@ -293,8 +233,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
           (_clientEdgeRequests = clientEdgeRequests) === null || _clientEdgeRequests === void 0 ? void 0 : _clientEdgeRequests.push(requestDescriptor);
         });
       });
-      // Store the query so that it can be retained when our own fragment is
-      // subscribed to. This merges with any existing query results:
       !(this._clientEdgeQueryResultsCache != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Client edge query result cache should exist when ENABLE_CLIENT_EDGES is on.') : invariant(false) : void 0;
       this._clientEdgeQueryResultsCache.recordQueryResults(fragmentIdentifier, queryResults);
     }
@@ -304,16 +242,12 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         return getPromiseForActiveRequest(_this3._environment, request);
       }).filter(Boolean);
     }
-
-    // Finally look for operations in flight for our parent query:
     var fragmentOwner = fragmentSelector.kind === 'PluralReaderSelector' ? fragmentSelector.selectors[0].owner : fragmentSelector.owner;
     var parentQueryPromiseResult = this._getAndSavePromiseForFragmentRequestInFlight(fragmentIdentifier, fragmentNode, fragmentOwner, fragmentResult);
-    var parentQueryPromiseResultPromise = parentQueryPromiseResult === null || parentQueryPromiseResult === void 0 ? void 0 : parentQueryPromiseResult.promise; // for refinement
+    var parentQueryPromiseResultPromise = parentQueryPromiseResult === null || parentQueryPromiseResult === void 0 ? void 0 : parentQueryPromiseResult.promise;
     var missingResolverFieldPromises = (_missingLiveResolverF2 = (_missingLiveResolverF3 = missingLiveResolverFields(snapshot)) === null || _missingLiveResolverF3 === void 0 ? void 0 : _missingLiveResolverF3.map(function (_ref2) {
       var liveStateID = _ref2.liveStateID;
       var store = environment.getStore();
-
-      // $FlowFixMe[prop-missing] This is expected to be a LiveResolverStore
       return store.getLiveResolverPromise(liveStateID);
     })) !== null && _missingLiveResolverF2 !== void 0 ? _missingLiveResolverF2 : [];
     if (clientEdgePromises.length || missingResolverFieldPromises.length || isPromise(parentQueryPromiseResultPromise)) {
@@ -325,7 +259,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         isRelayHooks: true,
         isPromiseCached: false,
         isMissingData: fragmentResult.isMissingData,
-        // TODO! Attach information here about missing live resolver fields
         pendingOperations: [].concat((0, _toConsumableArray2["default"])((_parentQueryPromiseRe = parentQueryPromiseResult === null || parentQueryPromiseResult === void 0 ? void 0 : parentQueryPromiseResult.pendingOperations) !== null && _parentQueryPromiseRe !== void 0 ? _parentQueryPromiseRe : []), (0, _toConsumableArray2["default"])((_clientEdgeRequests2 = clientEdgeRequests) !== null && _clientEdgeRequests2 !== void 0 ? _clientEdgeRequests2 : []))
       });
       var promises = [];
@@ -341,20 +274,17 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         }
         throw Promise.all(promises);
       }
-
-      // Note: we are re-throwing the `parentQueryPromiseResultPromise` here,
-      // because some of our suspense-related code is relying on the instance equality
-      // of thrown promises. See FragmentResource-test.js
       if (parentQueryPromiseResultPromise) {
         throw parentQueryPromiseResultPromise;
       }
     }
+    if (RelayFeatureFlags.ENABLE_RELAY_OPERATION_TRACKER_SUSPENSE && fragmentResult.isMissingData) {
+      this._cache.set(fragmentIdentifier, {
+        kind: 'done',
+        result: fragmentResult
+      });
+    }
     this._throwOrLogErrorsInSnapshot(snapshot);
-
-    // At this point, there's nothing we can do. We don't have all the expected
-    // data, but there's no indication the missing data will be fulfilled. So we
-    // choose to return potentially non-typesafe data. The data returned here
-    // might not match the generated types for this fragment/operation.
     environment.__log({
       name: 'fragmentresource.missing_data',
       data: fragmentResult.data,
@@ -367,17 +297,11 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
   _proto2._performClientEdgeQuery = function _performClientEdgeQuery(queryResource, fragmentNode, fragmentRef, request, clientEdgeDestinationID) {
     var originalVariables = getVariablesFromFragment(fragmentNode, fragmentRef);
     var variables = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, originalVariables), {}, {
-      id: clientEdgeDestinationID // TODO should be a reserved name
+      id: clientEdgeDestinationID
     });
-
-    var operation = createOperationDescriptor(request, variables, {} //  TODO cacheConfig should probably inherent from parent operation
-    );
-
+    var operation = createOperationDescriptor(request, variables, {});
     var fetchObservable = fetchQuery(this._environment, operation);
-    var queryResult = queryResource.prepare(operation, fetchObservable
-    // TODO should inherent render policy etc. from parent operation
-    );
-
+    var queryResult = queryResource.prepare(operation, fetchObservable);
     return {
       requestDescriptor: operation.request,
       queryResult: queryResult
@@ -410,20 +334,12 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         dispose: function dispose() {}
       };
     }
-
-    // 1. Check for any updates missed during render phase
-    // TODO(T44066760): More efficiently detect if we missed an update
     var _this$checkMissedUpda = this.checkMissedUpdates(fragmentResult),
       didMissUpdates = _this$checkMissedUpda[0],
       currentSnapshot = _this$checkMissedUpda[1];
-
-    // 2. If an update was missed, notify the component so it updates with
-    // the latest data.
     if (didMissUpdates) {
       callback();
     }
-
-    // 3. Establish subscriptions on the snapshot(s)
     var disposables = [];
     if (Array.isArray(renderedSnapshot)) {
       !Array.isArray(currentSnapshot) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected snapshots to be plural. ' + "If you're seeing this, this is likely a bug in Relay.") : invariant(false) : void 0;
@@ -438,10 +354,19 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       !(currentSnapshot != null && !Array.isArray(currentSnapshot)) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected snapshot to be singular. ' + "If you're seeing this, this is likely a bug in Relay.") : invariant(false) : void 0;
       disposables.push(environment.subscribe(currentSnapshot, function (latestSnapshot) {
         var storeEpoch = environment.getStore().getEpoch();
-        _this5._cache.set(cacheKey, {
-          kind: 'done',
-          result: getFragmentResult(cacheKey, latestSnapshot, storeEpoch)
-        });
+        var result = getFragmentResult(cacheKey, latestSnapshot, storeEpoch);
+        if (RelayFeatureFlags.ENABLE_RELAY_OPERATION_TRACKER_SUSPENSE && result.isMissingData) {
+          _this5._cache.set(cacheKey, {
+            kind: 'missing',
+            result: result,
+            snapshot: latestSnapshot
+          });
+        } else {
+          _this5._cache.set(cacheKey, {
+            kind: 'done',
+            result: getFragmentResult(cacheKey, latestSnapshot, storeEpoch)
+          });
+        }
         callback();
       }));
     }
@@ -484,7 +409,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       return [false, null];
     }
     var storeEpoch = null;
-    // Bail out if the store hasn't been written since last read
     storeEpoch = environment.getStore().getEpoch();
     if (fragmentResult.storeEpoch === storeEpoch) {
       return [false, fragmentResult.snapshot];
@@ -506,13 +430,20 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
         }
         currentSnapshots[idx] = currentSnapshot;
       });
-      // Only update the cache when the data is changed to avoid
-      // returning different `data` instances
       if (didMissUpdates) {
-        this._cache.set(cacheKey, {
-          kind: 'done',
-          result: getFragmentResult(cacheKey, currentSnapshots, storeEpoch)
-        });
+        var result = getFragmentResult(cacheKey, currentSnapshots, storeEpoch);
+        if (RelayFeatureFlags.ENABLE_RELAY_OPERATION_TRACKER_SUSPENSE && result.isMissingData) {
+          this._cache.set(cacheKey, {
+            kind: 'missing',
+            result: result,
+            snapshot: currentSnapshots
+          });
+        } else {
+          this._cache.set(cacheKey, {
+            kind: 'done',
+            result: result
+          });
+        }
       }
       return [didMissUpdates, currentSnapshots];
     }
@@ -531,10 +462,19 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       relayResolverErrors: currentSnapshot.relayResolverErrors
     };
     if (updatedData !== renderData) {
-      this._cache.set(cacheKey, {
-        kind: 'done',
-        result: getFragmentResult(cacheKey, updatedCurrentSnapshot, storeEpoch)
-      });
+      var _result = getFragmentResult(cacheKey, updatedCurrentSnapshot, storeEpoch);
+      if (RelayFeatureFlags.ENABLE_RELAY_OPERATION_TRACKER_SUSPENSE && _result.isMissingData) {
+        this._cache.set(cacheKey, {
+          kind: 'missing',
+          result: _result,
+          snapshot: updatedCurrentSnapshot
+        });
+      } else {
+        this._cache.set(cacheKey, {
+          kind: 'done',
+          result: _result
+        });
+      }
     }
     return [updatedData !== renderData, updatedCurrentSnapshot];
   };
@@ -550,10 +490,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
     if (pendingOperationsResult == null) {
       return null;
     }
-
-    // When the Promise for the request resolves, we need to make sure to
-    // update the cache with the latest data available in the store before
-    // resolving the Promise
     var networkPromise = pendingOperationsResult.promise;
     var pendingOperations = pendingOperationsResult.pendingOperations;
     var promise = networkPromise.then(function () {
@@ -561,7 +497,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
     })["catch"](function (error) {
       _this8._cache["delete"](cacheKey);
     });
-    // $FlowExpectedError[prop-missing] Expando to annotate Promises.
     promise.displayName = networkPromise.displayName;
     this._cache.set(cacheKey, {
       kind: 'pending',
@@ -588,10 +523,19 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
     }
     var nextSnapshots = currentSnapshot ? (0, _toConsumableArray2["default"])(currentSnapshot) : (0, _toConsumableArray2["default"])(baseSnapshots);
     nextSnapshots[idx] = latestSnapshot;
-    this._cache.set(cacheKey, {
-      kind: 'done',
-      result: getFragmentResult(cacheKey, nextSnapshots, storeEpoch)
-    });
+    var result = getFragmentResult(cacheKey, nextSnapshots, storeEpoch);
+    if (RelayFeatureFlags.ENABLE_RELAY_OPERATION_TRACKER_SUSPENSE && result.isMissingData) {
+      this._cache.set(cacheKey, {
+        kind: 'missing',
+        result: result,
+        snapshot: nextSnapshots
+      });
+    } else {
+      this._cache.set(cacheKey, {
+        kind: 'done',
+        result: result
+      });
+    }
   };
   return FragmentResourceImpl;
 }();

package/lib/relay-hooks/HooksImplementation.js

@@ -1,20 +1,9 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var warning = require("fbjs/lib/warning");
 var implementation = null;
 function inject(impl) {
-  process.env.NODE_ENV !== "production" ? warning(implementation !== null, 'Relay HooksImplementation was injected twice.') : void 0;
+  process.env.NODE_ENV !== "production" ? warning(implementation === null, 'Relay HooksImplementation was injected twice.') : void 0;
   implementation = impl;
 }
 function get() {

package/lib/relay-hooks/InternalLogger.js

@@ -1,14 +1,3 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var loggerImpl = function loggerImpl(eventData) {};

package/lib/relay-hooks/LRUCache.js

@@ -1,28 +1,6 @@
-/**
- * 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.
- *
- * 
- * @format
- * @oncall relay
- */
-
 'use strict';
 
 var invariant = require('invariant');
-/**
- * JS maps (both plain objects and Map) maintain key insertion
- * order, which means there is an easy way to simulate LRU behavior
- * that should also perform quite well:
- *
- * To insert a new value, first delete the key from the inner _map,
- * then _map.set(k, v). By deleting and reinserting, you ensure that the
- * map sees the key as the last inserted key.
- *
- * Get does the same: if the key is present, delete and reinsert it.
- */
 var LRUCache = /*#__PURE__*/function () {
   function LRUCache(capacity) {
     this._capacity = capacity;