react-relay 18.0.0 → 18.1.0

package/ReactRelayContext.js

@@ -1,5 +1,5 @@
 /**
- * Relay v18.0.0
+ * Relay v18.1.0
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/buildReactRelayContainer.js.flow

@@ -82,6 +82,7 @@ function buildReactRelayContainer<TBase: React.ComponentType<any>>(
     );
   }
   ForwardRef.displayName = containerName;
+  // $FlowFixMe[incompatible-call]
   const ForwardContainer = React.forwardRef(ForwardRef);
 
   if (__DEV__) {

package/hooks.js

@@ -1,5 +1,5 @@
 /**
- * Relay v18.0.0
+ * Relay v18.1.0
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/index.js

@@ -1,5 +1,5 @@
 /**
- * Relay v18.0.0
+ * Relay v18.1.0
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/legacy.js

@@ -1,5 +1,5 @@
 /**
- * Relay v18.0.0
+ * Relay v18.1.0
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/lib/relay-hooks/getConnectionState.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var invariant = require('invariant');
+var _require = require('relay-runtime'),
+  ConnectionInterface = _require.ConnectionInterface,
+  getValueAtPath = _require.getValueAtPath;
+function getConnectionState(direction, fragmentNode, fragmentData, connectionPathInFragmentData) {
+  var _pageInfo$END_CURSOR, _pageInfo$START_CURSO;
+  var _ConnectionInterface$ = ConnectionInterface.get(),
+    EDGES = _ConnectionInterface$.EDGES,
+    PAGE_INFO = _ConnectionInterface$.PAGE_INFO,
+    HAS_NEXT_PAGE = _ConnectionInterface$.HAS_NEXT_PAGE,
+    HAS_PREV_PAGE = _ConnectionInterface$.HAS_PREV_PAGE,
+    END_CURSOR = _ConnectionInterface$.END_CURSOR,
+    START_CURSOR = _ConnectionInterface$.START_CURSOR;
+  var connection = getValueAtPath(fragmentData, connectionPathInFragmentData);
+  if (connection == null) {
+    return {
+      cursor: null,
+      hasMore: false
+    };
+  }
+  !(typeof connection === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected connection in fragment `%s` to have been `null`, or ' + 'a plain object with %s and %s properties. Instead got `%s`.', fragmentNode.name, EDGES, PAGE_INFO, connection) : invariant(false) : void 0;
+  var edges = connection[EDGES];
+  var pageInfo = connection[PAGE_INFO];
+  if (edges == null || pageInfo == null) {
+    return {
+      cursor: null,
+      hasMore: false
+    };
+  }
+  !Array.isArray(edges) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected connection in fragment `%s` to have a plural `%s` field. ' + 'Instead got `%s`.', fragmentNode.name, EDGES, edges) : invariant(false) : void 0;
+  !(typeof pageInfo === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected connection in fragment `%s` to have a `%s` field. ' + 'Instead got `%s`.', fragmentNode.name, PAGE_INFO, pageInfo) : invariant(false) : void 0;
+  var cursor = direction === 'forward' ? (_pageInfo$END_CURSOR = pageInfo[END_CURSOR]) !== null && _pageInfo$END_CURSOR !== void 0 ? _pageInfo$END_CURSOR : null : (_pageInfo$START_CURSO = pageInfo[START_CURSOR]) !== null && _pageInfo$START_CURSO !== void 0 ? _pageInfo$START_CURSO : null;
+  !(cursor === null || typeof cursor === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected page info for connection in fragment `%s` to have a ' + 'valid `%s`. Instead got `%s`.', fragmentNode.name, START_CURSOR, cursor) : invariant(false) : void 0;
+  var hasMore;
+  if (direction === 'forward') {
+    hasMore = cursor != null && pageInfo[HAS_NEXT_PAGE] === true;
+  } else {
+    hasMore = cursor != null && pageInfo[HAS_PREV_PAGE] === true;
+  }
+  return {
+    cursor: cursor,
+    hasMore: hasMore
+  };
+}
+module.exports = getConnectionState;

package/lib/relay-hooks/legacy/FragmentResource.js

@@ -309,12 +309,10 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
     var _this4 = this;
     if (Array.isArray(snapshot)) {
       snapshot.forEach(function (s) {
-        var _s$selector$node$meta, _s$selector$node$meta2;
-        handlePotentialSnapshotErrors(_this4._environment, s.missingRequiredFields, s.relayResolverErrors, s.errorResponseFields, (_s$selector$node$meta = (_s$selector$node$meta2 = s.selector.node.metadata) === null || _s$selector$node$meta2 === void 0 ? void 0 : _s$selector$node$meta2.throwOnFieldError) !== null && _s$selector$node$meta !== void 0 ? _s$selector$node$meta : false);
+        handlePotentialSnapshotErrors(_this4._environment, s.errorResponseFields);
       });
     } else {
-      var _snapshot$selector$no, _snapshot$selector$no2;
-      handlePotentialSnapshotErrors(this._environment, snapshot.missingRequiredFields, snapshot.relayResolverErrors, snapshot.errorResponseFields, (_snapshot$selector$no = (_snapshot$selector$no2 = snapshot.selector.node.metadata) === null || _snapshot$selector$no2 === void 0 ? void 0 : _snapshot$selector$no2.throwOnFieldError) !== null && _snapshot$selector$no !== void 0 ? _snapshot$selector$no : false);
+      handlePotentialSnapshotErrors(this._environment, snapshot.errorResponseFields);
     }
   };
   _proto2.readSpec = function readSpec(fragmentNodes, fragmentRefs, componentDisplayName) {
@@ -456,8 +454,6 @@ var FragmentResourceImpl = /*#__PURE__*/function () {
       missingLiveResolverFields: currentSnapshot.missingLiveResolverFields,
       seenRecords: currentSnapshot.seenRecords,
       selector: currentSnapshot.selector,
-      missingRequiredFields: currentSnapshot.missingRequiredFields,
-      relayResolverErrors: currentSnapshot.relayResolverErrors,
       errorResponseFields: currentSnapshot.errorResponseFields
     };
     if (updatedData !== renderData) {

package/lib/relay-hooks/readFragmentInternal.js

@@ -66,16 +66,14 @@ function getMissingClientEdges(state) {
 }
 function handlePotentialSnapshotErrorsForState(environment, state) {
   if (state.kind === 'singular') {
-    var _state$snapshot$selec, _state$snapshot$selec2;
-    handlePotentialSnapshotErrors(environment, state.snapshot.missingRequiredFields, state.snapshot.relayResolverErrors, state.snapshot.errorResponseFields, (_state$snapshot$selec = (_state$snapshot$selec2 = state.snapshot.selector.node.metadata) === null || _state$snapshot$selec2 === void 0 ? void 0 : _state$snapshot$selec2.throwOnFieldError) !== null && _state$snapshot$selec !== void 0 ? _state$snapshot$selec : false);
+    handlePotentialSnapshotErrors(environment, state.snapshot.errorResponseFields);
   } else if (state.kind === 'plural') {
     var _iterator3 = (0, _createForOfIteratorHelper2["default"])(state.snapshots),
       _step3;
     try {
       for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-        var _snapshot$selector$no, _snapshot$selector$no2;
         var snapshot = _step3.value;
-        handlePotentialSnapshotErrors(environment, snapshot.missingRequiredFields, snapshot.relayResolverErrors, snapshot.errorResponseFields, (_snapshot$selector$no = (_snapshot$selector$no2 = snapshot.selector.node.metadata) === null || _snapshot$selector$no2 === void 0 ? void 0 : _snapshot$selector$no2.throwOnFieldError) !== null && _snapshot$selector$no !== void 0 ? _snapshot$selector$no : false);
+        handlePotentialSnapshotErrors(environment, snapshot.errorResponseFields);
       }
     } catch (err) {
       _iterator3.e(err);

package/lib/relay-hooks/useFragmentInternal.js

@@ -5,7 +5,7 @@ var _useFragmentInternal_CURRENT = _interopRequireDefault(require("./useFragment
 var _useFragmentInternal_EXPERIMENTAL = _interopRequireDefault(require("./useFragmentInternal_EXPERIMENTAL"));
 var _relayRuntime = require("relay-runtime");
 function useFragmentInternal(fragmentNode, fragmentRef, hookDisplayName, queryOptions) {
-  if (_relayRuntime.RelayFeatureFlags.ENABLE_USE_FRAGMENT_EXPERIMENTAL) {
+  if (_relayRuntime.RelayFeatureFlags.ENABLE_ACTIVITY_COMPATIBILITY) {
     return (0, _useFragmentInternal_EXPERIMENTAL["default"])(fragmentNode, fragmentRef, hookDisplayName, queryOptions);
   }
   return (0, _useFragmentInternal_CURRENT["default"])(fragmentNode, fragmentRef, hookDisplayName, queryOptions);

package/lib/relay-hooks/useFragmentInternal_CURRENT.js

@@ -116,16 +116,14 @@ function getSuspendingLiveResolver(state) {
 }
 function handlePotentialSnapshotErrorsForState(environment, state) {
   if (state.kind === 'singular') {
-    var _state$snapshot$selec, _state$snapshot$selec2;
-    handlePotentialSnapshotErrors(environment, state.snapshot.missingRequiredFields, state.snapshot.relayResolverErrors, state.snapshot.errorResponseFields, (_state$snapshot$selec = (_state$snapshot$selec2 = state.snapshot.selector.node.metadata) === null || _state$snapshot$selec2 === void 0 ? void 0 : _state$snapshot$selec2.throwOnFieldError) !== null && _state$snapshot$selec !== void 0 ? _state$snapshot$selec : false);
+    handlePotentialSnapshotErrors(environment, state.snapshot.errorResponseFields);
   } else if (state.kind === 'plural') {
     var _iterator5 = (0, _createForOfIteratorHelper2["default"])(state.snapshots),
       _step5;
     try {
       for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-        var _snapshot$selector$no, _snapshot$selector$no2;
         var snapshot = _step5.value;
-        handlePotentialSnapshotErrors(environment, snapshot.missingRequiredFields, snapshot.relayResolverErrors, snapshot.errorResponseFields, (_snapshot$selector$no = (_snapshot$selector$no2 = snapshot.selector.node.metadata) === null || _snapshot$selector$no2 === void 0 ? void 0 : _snapshot$selector$no2.throwOnFieldError) !== null && _snapshot$selector$no !== void 0 ? _snapshot$selector$no : false);
+        handlePotentialSnapshotErrors(environment, snapshot.errorResponseFields);
       }
     } catch (err) {
       _iterator5.e(err);
@@ -152,8 +150,6 @@ function handleMissedUpdates(environment, state) {
       missingLiveResolverFields: currentSnapshot.missingLiveResolverFields,
       seenRecords: currentSnapshot.seenRecords,
       selector: currentSnapshot.selector,
-      missingRequiredFields: currentSnapshot.missingRequiredFields,
-      relayResolverErrors: currentSnapshot.relayResolverErrors,
       errorResponseFields: currentSnapshot.errorResponseFields
     };
     return [updatedData !== state.snapshot.data, {
@@ -175,8 +171,6 @@ function handleMissedUpdates(environment, state) {
         missingLiveResolverFields: _currentSnapshot.missingLiveResolverFields,
         seenRecords: _currentSnapshot.seenRecords,
         selector: _currentSnapshot.selector,
-        missingRequiredFields: _currentSnapshot.missingRequiredFields,
-        relayResolverErrors: _currentSnapshot.relayResolverErrors,
         errorResponseFields: _currentSnapshot.errorResponseFields
       };
       if (_updatedData !== snapshot.data) {

package/lib/relay-hooks/useFragmentInternal_EXPERIMENTAL.js

@@ -116,16 +116,14 @@ function getSuspendingLiveResolver(state) {
 }
 function handlePotentialSnapshotErrorsForState(environment, state) {
   if (state.kind === 'singular') {
-    var _state$snapshot$selec, _state$snapshot$selec2;
-    handlePotentialSnapshotErrors(environment, state.snapshot.missingRequiredFields, state.snapshot.relayResolverErrors, state.snapshot.errorResponseFields, (_state$snapshot$selec = (_state$snapshot$selec2 = state.snapshot.selector.node.metadata) === null || _state$snapshot$selec2 === void 0 ? void 0 : _state$snapshot$selec2.throwOnFieldError) !== null && _state$snapshot$selec !== void 0 ? _state$snapshot$selec : false);
+    handlePotentialSnapshotErrors(environment, state.snapshot.errorResponseFields);
   } else if (state.kind === 'plural') {
     var _iterator5 = (0, _createForOfIteratorHelper2["default"])(state.snapshots),
       _step5;
     try {
       for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-        var _snapshot$selector$no, _snapshot$selector$no2;
         var snapshot = _step5.value;
-        handlePotentialSnapshotErrors(environment, snapshot.missingRequiredFields, snapshot.relayResolverErrors, snapshot.errorResponseFields, (_snapshot$selector$no = (_snapshot$selector$no2 = snapshot.selector.node.metadata) === null || _snapshot$selector$no2 === void 0 ? void 0 : _snapshot$selector$no2.throwOnFieldError) !== null && _snapshot$selector$no !== void 0 ? _snapshot$selector$no : false);
+        handlePotentialSnapshotErrors(environment, snapshot.errorResponseFields);
       }
     } catch (err) {
       _iterator5.e(err);
@@ -152,8 +150,6 @@ function handleMissedUpdates(environment, state) {
       missingLiveResolverFields: currentSnapshot.missingLiveResolverFields,
       seenRecords: currentSnapshot.seenRecords,
       selector: currentSnapshot.selector,
-      missingRequiredFields: currentSnapshot.missingRequiredFields,
-      relayResolverErrors: currentSnapshot.relayResolverErrors,
       errorResponseFields: currentSnapshot.errorResponseFields
     };
     return [updatedData !== state.snapshot.data, {
@@ -177,8 +173,6 @@ function handleMissedUpdates(environment, state) {
         missingLiveResolverFields: _currentSnapshot.missingLiveResolverFields,
         seenRecords: _currentSnapshot.seenRecords,
         selector: _currentSnapshot.selector,
-        missingRequiredFields: _currentSnapshot.missingRequiredFields,
-        relayResolverErrors: _currentSnapshot.relayResolverErrors,
         errorResponseFields: _currentSnapshot.errorResponseFields
       };
       if (_updatedData !== snapshot.data) {
@@ -206,7 +200,7 @@ function handleMissingClientEdge(environment, parentFragmentNode, parentFragment
   var queryResult = QueryResource.prepare(queryOperationDescriptor, fetchQueryInternal(environment, queryOperationDescriptor), queryOptions === null || queryOptions === void 0 ? void 0 : queryOptions.fetchPolicy);
   return [queryResult, getPromiseForActiveRequest(environment, queryOperationDescriptor.request)];
 }
-function subscribeToSnapshot(environment, state, setState, pendingStateRef) {
+function subscribeToSnapshot(environment, state, setState) {
   if (state.kind === 'bailout') {
     return function () {};
   } else if (state.kind === 'singular') {
@@ -235,7 +229,6 @@ function subscribeToSnapshot(environment, state, setState, pendingStateRef) {
             environment: state.environment
           };
         }
-        pendingStateRef.current = nextState.kind === 'singular' ? nextState.epoch : null;
         return nextState;
       });
     });
@@ -272,7 +265,6 @@ function subscribeToSnapshot(environment, state, setState, pendingStateRef) {
               environment: state.environment
             };
           }
-          pendingStateRef.current = nextState.kind === 'plural' ? nextState.epoch : null;
           return nextState;
         });
       });
@@ -424,7 +416,6 @@ function useFragmentInternal_EXPERIMENTAL(fragmentNode, fragmentRef, hookDisplay
     }
   }
   handlePotentialSnapshotErrorsForState(environment, state);
-  var pendingStateEpochRef = useRef(null);
   var storeSubscriptionRef = useRef(null);
   useEffect(function () {
     var storeSubscription = storeSubscriptionRef.current;
@@ -449,7 +440,7 @@ function useFragmentInternal_EXPERIMENTAL(fragmentNode, fragmentRef, hookDisplay
       }
       stateForSubscription = updatedState;
     }
-    var dispose = subscribeToSnapshot(state.environment, stateForSubscription, setState, pendingStateEpochRef);
+    var dispose = subscribeToSnapshot(state.environment, stateForSubscription, setState);
     storeSubscriptionRef.current = {
       dispose: dispose,
       selector: state.selector,
@@ -458,7 +449,7 @@ function useFragmentInternal_EXPERIMENTAL(fragmentNode, fragmentRef, hookDisplay
   }, [state]);
   useEffect(function () {
     if (storeSubscriptionRef.current == null && state.kind !== 'bailout') {
-      var dispose = subscribeToSnapshot(state.environment, state, setState, pendingStateEpochRef);
+      var dispose = subscribeToSnapshot(state.environment, state, setState);
       storeSubscriptionRef.current = {
         dispose: dispose,
         selector: state.selector,
@@ -471,18 +462,6 @@ function useFragmentInternal_EXPERIMENTAL(fragmentNode, fragmentRef, hookDisplay
       storeSubscriptionRef.current = null;
     };
   }, []);
-  if (pendingStateEpochRef.current !== null && pendingStateEpochRef.current !== state.epoch) {
-    var updates = handleMissedUpdates(environment, state);
-    if (updates != null) {
-      var hasStateUpdates = updates[0],
-        updatedState = updates[1];
-      if (hasStateUpdates) {
-        setState(updatedState);
-        state = updatedState;
-      }
-    }
-  }
-  pendingStateEpochRef.current = null;
   var data;
   if (isPlural) {
     var fragmentRefIsNullish = fragmentRef == null;

package/lib/relay-hooks/useLoadMoreFunction.js

@@ -2,9 +2,11 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var getConnectionState = require('./getConnectionState');
 var useFetchTrackingRef = require('./useFetchTrackingRef');
 var useIsMountedRef = require('./useIsMountedRef');
 var useIsOperationNodeActive = require('./useIsOperationNodeActive');
+var useLoadMoreFunction_EXPERIMENTAL = require('./useLoadMoreFunction_EXPERIMENTAL');
 var useRelayEnvironment = require('./useRelayEnvironment');
 var invariant = require('invariant');
 var _require = require('react'),
@@ -13,14 +15,19 @@ var _require = require('react'),
   useState = _require.useState;
 var _require2 = require('relay-runtime'),
   fetchQuery = _require2.__internal.fetchQuery,
-  ConnectionInterface = _require2.ConnectionInterface,
+  RelayFeatureFlags = _require2.RelayFeatureFlags,
   createOperationDescriptor = _require2.createOperationDescriptor,
   getPaginationVariables = _require2.getPaginationVariables,
   getRefetchMetadata = _require2.getRefetchMetadata,
-  getSelector = _require2.getSelector,
-  getValueAtPath = _require2.getValueAtPath;
+  getSelector = _require2.getSelector;
 var warning = require("fbjs/lib/warning");
 function useLoadMoreFunction(args) {
+  if (RelayFeatureFlags.ENABLE_ACTIVITY_COMPATIBILITY) {
+    return useLoadMoreFunction_EXPERIMENTAL(args);
+  }
+  return useLoadMoreFunction_CURRENT(args);
+}
+function useLoadMoreFunction_CURRENT(args) {
   var direction = args.direction,
     fragmentNode = args.fragmentNode,
     fragmentRef = args.fragmentRef,
@@ -121,44 +128,4 @@ function useLoadMoreFunction(args) {
   }, [environment, identifierValue, direction, cursor, startFetch, disposeFetch, completeFetch, isFetchingRef, isParentQueryActive, fragmentData, fragmentNode.name, fragmentRef, componentDisplayName]);
   return [loadMore, hasMore, disposeFetch];
 }
-function getConnectionState(direction, fragmentNode, fragmentData, connectionPathInFragmentData) {
-  var _pageInfo$END_CURSOR, _pageInfo$START_CURSO;
-  var _ConnectionInterface$ = ConnectionInterface.get(),
-    EDGES = _ConnectionInterface$.EDGES,
-    PAGE_INFO = _ConnectionInterface$.PAGE_INFO,
-    HAS_NEXT_PAGE = _ConnectionInterface$.HAS_NEXT_PAGE,
-    HAS_PREV_PAGE = _ConnectionInterface$.HAS_PREV_PAGE,
-    END_CURSOR = _ConnectionInterface$.END_CURSOR,
-    START_CURSOR = _ConnectionInterface$.START_CURSOR;
-  var connection = getValueAtPath(fragmentData, connectionPathInFragmentData);
-  if (connection == null) {
-    return {
-      cursor: null,
-      hasMore: false
-    };
-  }
-  !(typeof connection === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected connection in fragment `%s` to have been `null`, or ' + 'a plain object with %s and %s properties. Instead got `%s`.', fragmentNode.name, EDGES, PAGE_INFO, connection) : invariant(false) : void 0;
-  var edges = connection[EDGES];
-  var pageInfo = connection[PAGE_INFO];
-  if (edges == null || pageInfo == null) {
-    return {
-      cursor: null,
-      hasMore: false
-    };
-  }
-  !Array.isArray(edges) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected connection in fragment `%s` to have a plural `%s` field. ' + 'Instead got `%s`.', fragmentNode.name, EDGES, edges) : invariant(false) : void 0;
-  !(typeof pageInfo === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected connection in fragment `%s` to have a `%s` field. ' + 'Instead got `%s`.', fragmentNode.name, PAGE_INFO, pageInfo) : invariant(false) : void 0;
-  var cursor = direction === 'forward' ? (_pageInfo$END_CURSOR = pageInfo[END_CURSOR]) !== null && _pageInfo$END_CURSOR !== void 0 ? _pageInfo$END_CURSOR : null : (_pageInfo$START_CURSO = pageInfo[START_CURSOR]) !== null && _pageInfo$START_CURSO !== void 0 ? _pageInfo$START_CURSO : null;
-  !(cursor === null || typeof cursor === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected page info for connection in fragment `%s` to have a ' + 'valid `%s`. Instead got `%s`.', fragmentNode.name, START_CURSOR, cursor) : invariant(false) : void 0;
-  var hasMore;
-  if (direction === 'forward') {
-    hasMore = cursor != null && pageInfo[HAS_NEXT_PAGE] === true;
-  } else {
-    hasMore = cursor != null && pageInfo[HAS_PREV_PAGE] === true;
-  }
-  return {
-    cursor: cursor,
-    hasMore: hasMore
-  };
-}
 module.exports = useLoadMoreFunction;

package/lib/relay-hooks/useLoadMoreFunction_EXPERIMENTAL.js

@@ -0,0 +1,130 @@
+'use strict';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var getConnectionState = require('./getConnectionState');
+var useIsMountedRef = require('./useIsMountedRef');
+var useIsOperationNodeActive = require('./useIsOperationNodeActive');
+var useRelayEnvironment = require('./useRelayEnvironment');
+var invariant = require('invariant');
+var _require = require('react'),
+  useCallback = _require.useCallback,
+  useRef = _require.useRef,
+  useState = _require.useState;
+var _require2 = require('relay-runtime'),
+  fetchQuery = _require2.__internal.fetchQuery,
+  createOperationDescriptor = _require2.createOperationDescriptor,
+  getPaginationVariables = _require2.getPaginationVariables,
+  getRefetchMetadata = _require2.getRefetchMetadata,
+  getSelector = _require2.getSelector;
+var warning = require("fbjs/lib/warning");
+function useLoadMoreFunction_EXPERIMENTAL(args) {
+  var direction = args.direction,
+    fragmentNode = args.fragmentNode,
+    fragmentRef = args.fragmentRef,
+    fragmentIdentifier = args.fragmentIdentifier,
+    fragmentData = args.fragmentData,
+    connectionPathInFragmentData = args.connectionPathInFragmentData,
+    paginationRequest = args.paginationRequest,
+    paginationMetadata = args.paginationMetadata,
+    componentDisplayName = args.componentDisplayName,
+    observer = args.observer,
+    onReset = args.onReset;
+  var environment = useRelayEnvironment();
+  var _getRefetchMetadata = getRefetchMetadata(fragmentNode, componentDisplayName),
+    identifierInfo = _getRefetchMetadata.identifierInfo;
+  var identifierValue = (identifierInfo === null || identifierInfo === void 0 ? void 0 : identifierInfo.identifierField) != null && fragmentData != null && typeof fragmentData === 'object' ? fragmentData[identifierInfo.identifierField] : null;
+  var fetchStatusRef = useRef({
+    kind: 'none'
+  });
+  var _useState = useState(environment),
+    mirroredEnvironment = _useState[0],
+    setMirroredEnvironment = _useState[1];
+  var _useState2 = useState(fragmentIdentifier),
+    mirroredFragmentIdentifier = _useState2[0],
+    setMirroredFragmentIdentifier = _useState2[1];
+  var isParentQueryActive = useIsOperationNodeActive(fragmentNode, fragmentRef);
+  var forceDisposeFn = useCallback(function () {
+    if (fetchStatusRef.current.kind === 'fetching') {
+      fetchStatusRef.current.subscription.unsubscribe();
+    }
+    fetchStatusRef.current = {
+      kind: 'none'
+    };
+  }, []);
+  var shouldReset = environment !== mirroredEnvironment || fragmentIdentifier !== mirroredFragmentIdentifier;
+  if (shouldReset) {
+    forceDisposeFn();
+    onReset();
+    setMirroredEnvironment(environment);
+    setMirroredFragmentIdentifier(fragmentIdentifier);
+  }
+  var _getConnectionState = getConnectionState(direction, fragmentNode, fragmentData, connectionPathInFragmentData),
+    cursor = _getConnectionState.cursor,
+    hasMore = _getConnectionState.hasMore;
+  var isMountedRef = useIsMountedRef();
+  var loadMore = useCallback(function (count, options) {
+    var onComplete = options === null || options === void 0 ? void 0 : options.onComplete;
+    if (isMountedRef.current !== true) {
+      process.env.NODE_ENV !== "production" ? warning(false, 'Relay: Unexpected fetch on unmounted component for fragment ' + '`%s` in `%s`. It looks like some instances of your component are ' + 'still trying to fetch data but they already unmounted. ' + 'Please make sure you clear all timers, intervals, ' + 'async calls, etc that may trigger a fetch.', fragmentNode.name, componentDisplayName) : void 0;
+      return {
+        dispose: function dispose() {}
+      };
+    }
+    var fragmentSelector = getSelector(fragmentNode, fragmentRef);
+    if (fetchStatusRef.current.kind === 'fetching' || fragmentData == null || isParentQueryActive) {
+      if (fragmentSelector == null) {
+        process.env.NODE_ENV !== "production" ? warning(false, 'Relay: Unexpected fetch while using a null fragment ref ' + 'for fragment `%s` in `%s`. When fetching more items, we expect ' + "initial fragment data to be non-null. Please make sure you're " + 'passing a valid fragment ref to `%s` before paginating.', fragmentNode.name, componentDisplayName, componentDisplayName) : void 0;
+      }
+      if (onComplete) {
+        onComplete(null);
+      }
+      return {
+        dispose: function dispose() {}
+      };
+    }
+    !(fragmentSelector != null && fragmentSelector.kind !== 'PluralReaderSelector') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected to be able to find a non-plural fragment owner for ' + "fragment `%s` when using `%s`. If you're seeing this, " + 'this is likely a bug in Relay.', fragmentNode.name, componentDisplayName) : invariant(false) : void 0;
+    var parentVariables = fragmentSelector.owner.variables;
+    var fragmentVariables = fragmentSelector.variables;
+    var extraVariables = options === null || options === void 0 ? void 0 : options.UNSTABLE_extraVariables;
+    var baseVariables = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, parentVariables), fragmentVariables);
+    var paginationVariables = getPaginationVariables(direction, count, cursor, baseVariables, (0, _objectSpread2["default"])({}, extraVariables), paginationMetadata);
+    if (identifierInfo != null) {
+      if (typeof identifierValue !== 'string') {
+        process.env.NODE_ENV !== "production" ? warning(false, 'Relay: Expected result to have a string  ' + '`%s` in order to refetch, got `%s`.', identifierInfo.identifierField, identifierValue) : void 0;
+      }
+      paginationVariables[identifierInfo.identifierQueryVariableName] = identifierValue;
+    }
+    var paginationQuery = createOperationDescriptor(paginationRequest, paginationVariables, {
+      force: true
+    });
+    fetchQuery(environment, paginationQuery).subscribe((0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, observer), {}, {
+      start: function start(subscription) {
+        fetchStatusRef.current = {
+          kind: 'fetching',
+          subscription: subscription
+        };
+        observer.start && observer.start(subscription);
+      },
+      complete: function complete() {
+        fetchStatusRef.current = {
+          kind: 'none'
+        };
+        observer.complete && observer.complete();
+        onComplete && onComplete(null);
+      },
+      error: function error(_error) {
+        fetchStatusRef.current = {
+          kind: 'none'
+        };
+        observer.complete && observer.complete();
+        onComplete && onComplete(_error);
+      }
+    }));
+    return {
+      dispose: function dispose() {}
+    };
+  }, [environment, identifierValue, direction, cursor, isParentQueryActive, fragmentData, fragmentNode.name, fragmentRef, componentDisplayName]);
+  return [loadMore, hasMore, forceDisposeFn];
+}
+module.exports = useLoadMoreFunction_EXPERIMENTAL;

package/lib/relay-hooks/useQueryLoader.js

@@ -5,6 +5,7 @@ var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime
 var _require = require('./loadQuery'),
   loadQuery = _require.loadQuery;
 var useIsMountedRef = require('./useIsMountedRef');
+var useQueryLoader_EXPERIMENTAL = require('./useQueryLoader_EXPERIMENTAL');
 var useRelayEnvironment = require('./useRelayEnvironment');
 var _require2 = require('react'),
   useCallback = _require2.useCallback,
@@ -12,6 +13,7 @@ var _require2 = require('react'),
   useRef = _require2.useRef,
   useState = _require2.useState;
 var _require3 = require('relay-runtime'),
+  RelayFeatureFlags = _require3.RelayFeatureFlags,
   getRequest = _require3.getRequest;
 var initialNullQueryReferenceState = {
   kind: 'NullQueryReference'
@@ -24,6 +26,12 @@ function requestIsLiveQuery(preloadableRequest) {
   return request.params.metadata.live !== undefined;
 }
 function useQueryLoader(preloadableRequest, initialQueryReference) {
+  if (RelayFeatureFlags.ENABLE_ACTIVITY_COMPATIBILITY) {
+    return useQueryLoader_EXPERIMENTAL(preloadableRequest, initialQueryReference);
+  }
+  return useQueryLoader_CURRENT(preloadableRequest, initialQueryReference);
+}
+function useQueryLoader_CURRENT(preloadableRequest, initialQueryReference) {
   var initialQueryReferenceInternal = initialQueryReference !== null && initialQueryReference !== void 0 ? initialQueryReference : initialNullQueryReferenceState;
   var environment = useRelayEnvironment();
   var isMountedRef = useIsMountedRef();

package/lib/relay-hooks/useQueryLoader_EXPERIMENTAL.js

@@ -0,0 +1,120 @@
+'use strict';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
+var _require = require('./loadQuery'),
+  loadQuery = _require.loadQuery;
+var useIsMountedRef = require('./useIsMountedRef');
+var useRelayEnvironment = require('./useRelayEnvironment');
+var _require2 = require('react'),
+  useCallback = _require2.useCallback,
+  useEffect = _require2.useEffect,
+  useInsertionEffect = _require2.useInsertionEffect,
+  useRef = _require2.useRef,
+  useState = _require2.useState;
+var _require3 = require('relay-runtime'),
+  getRequest = _require3.getRequest;
+var initialNullQueryReferenceState = {
+  kind: 'NullQueryReference'
+};
+function requestIsLiveQuery(preloadableRequest) {
+  if (preloadableRequest.kind === 'PreloadableConcreteRequest') {
+    return preloadableRequest.params.metadata.live !== undefined;
+  }
+  var request = getRequest(preloadableRequest);
+  return request.params.metadata.live !== undefined;
+}
+var CLEANUP_TIMEOUT = 1000 * 60 * 5;
+function useQueryLoader_EXPERIMENTAL(preloadableRequest, initialQueryReference) {
+  var initialQueryReferenceInternal = initialQueryReference !== null && initialQueryReference !== void 0 ? initialQueryReference : initialNullQueryReferenceState;
+  var environment = useRelayEnvironment();
+  var isMountedRef = useIsMountedRef();
+  var undisposedQueryReferencesRef = useRef(null);
+  if (undisposedQueryReferencesRef.current == null) {
+    undisposedQueryReferencesRef.current = new Set([initialQueryReferenceInternal]);
+  }
+  var _useState = useState(function () {
+      return initialQueryReferenceInternal;
+    }),
+    queryReference = _useState[0],
+    setQueryReference = _useState[1];
+  var _useState2 = useState(function () {
+      return initialQueryReferenceInternal;
+    }),
+    previousInitialQueryReference = _useState2[0],
+    setPreviousInitialQueryReference = _useState2[1];
+  if (initialQueryReferenceInternal !== previousInitialQueryReference) {
+    var _undisposedQueryRefer;
+    (_undisposedQueryRefer = undisposedQueryReferencesRef.current) === null || _undisposedQueryRefer === void 0 ? void 0 : _undisposedQueryRefer.add(initialQueryReferenceInternal);
+    setPreviousInitialQueryReference(initialQueryReferenceInternal);
+    setQueryReference(initialQueryReferenceInternal);
+  }
+  var disposeQuery = useCallback(function () {
+    if (isMountedRef.current) {
+      var _undisposedQueryRefer2;
+      (_undisposedQueryRefer2 = undisposedQueryReferencesRef.current) === null || _undisposedQueryRefer2 === void 0 ? void 0 : _undisposedQueryRefer2.add(initialNullQueryReferenceState);
+      setQueryReference(initialNullQueryReferenceState);
+    }
+  }, [isMountedRef]);
+  var queryLoaderCallback = useCallback(function (variables, options) {
+    var _options$__environmen, _undisposedQueryRefer3;
+    if (!isMountedRef.current) {
+      return;
+    }
+    var mergedOptions = options != null && options.hasOwnProperty('__environment') ? {
+      fetchPolicy: options.fetchPolicy,
+      networkCacheConfig: options.networkCacheConfig,
+      __nameForWarning: options.__nameForWarning
+    } : options;
+    var updatedQueryReference = loadQuery((_options$__environmen = options === null || options === void 0 ? void 0 : options.__environment) !== null && _options$__environmen !== void 0 ? _options$__environmen : environment, preloadableRequest, variables, mergedOptions);
+    (_undisposedQueryRefer3 = undisposedQueryReferencesRef.current) === null || _undisposedQueryRefer3 === void 0 ? void 0 : _undisposedQueryRefer3.add(updatedQueryReference);
+    setQueryReference(updatedQueryReference);
+  }, [environment, preloadableRequest, setQueryReference, isMountedRef]);
+  var disposeAllRemainingQueryReferences = useCallback(function disposeAllRemainingQueryReferences(preloadableRequest, currentQueryReference) {
+    var _undisposedQueryRefer4;
+    var undisposedQueryReferences = (_undisposedQueryRefer4 = undisposedQueryReferencesRef.current) !== null && _undisposedQueryRefer4 !== void 0 ? _undisposedQueryRefer4 : new Set();
+    var _iterator = (0, _createForOfIteratorHelper2["default"])(undisposedQueryReferences),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var undisposedQueryReference = _step.value;
+        if (undisposedQueryReference === currentQueryReference) {
+          continue;
+        }
+        if (undisposedQueryReference.kind !== 'NullQueryReference') {
+          if (requestIsLiveQuery(preloadableRequest)) {
+            undisposedQueryReference.dispose && undisposedQueryReference.dispose();
+          } else {
+            undisposedQueryReference.releaseQuery && undisposedQueryReference.releaseQuery();
+          }
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  }, []);
+  var cleanupTimerRef = useRef(null);
+  useEffect(function () {
+    disposeAllRemainingQueryReferences(preloadableRequest, queryReference);
+    if (cleanupTimerRef.current != null) {
+      clearTimeout(cleanupTimerRef.current);
+      cleanupTimerRef.current = null;
+    }
+    return function () {
+      cleanupTimerRef.current = setTimeout(function () {
+        disposeAllRemainingQueryReferences(preloadableRequest, null);
+      }, CLEANUP_TIMEOUT);
+    };
+  }, [preloadableRequest, queryReference]);
+  useInsertionEffect(function () {
+    return function () {
+      cleanupTimerRef.current && clearTimeout(cleanupTimerRef.current);
+      cleanupTimerRef.current = null;
+      disposeAllRemainingQueryReferences(preloadableRequest, null);
+    };
+  }, [preloadableRequest]);
+  return [queryReference.kind === 'NullQueryReference' ? null : queryReference, queryLoaderCallback, disposeQuery];
+}
+module.exports = useQueryLoader_EXPERIMENTAL;