relay-runtime 11.0.2 → 12.0.0

package/lib/store/ResolverCache.js

@@ -0,0 +1,213 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * 
+ * @format
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
+
+var RelayModernRecord = require('./RelayModernRecord');
+
+var recycleNodesInto = require('../util/recycleNodesInto');
+
+var warning = require("fbjs/lib/warning");
+
+var _require = require('./ClientID'),
+    generateClientID = _require.generateClientID;
+
+var _require2 = require('./RelayStoreUtils'),
+    RELAY_RESOLVER_VALUE_KEY = _require2.RELAY_RESOLVER_VALUE_KEY,
+    RELAY_RESOLVER_INVALIDATION_KEY = _require2.RELAY_RESOLVER_INVALIDATION_KEY,
+    RELAY_RESOLVER_INPUTS_KEY = _require2.RELAY_RESOLVER_INPUTS_KEY,
+    RELAY_RESOLVER_READER_SELECTOR_KEY = _require2.RELAY_RESOLVER_READER_SELECTOR_KEY,
+    getStorageKey = _require2.getStorageKey;
+
+// $FlowFixMe[unclear-type] - will always be empty
+var emptySet = new Set();
+
+var NoopResolverCache = /*#__PURE__*/function () {
+  function NoopResolverCache() {}
+
+  var _proto = NoopResolverCache.prototype;
+
+  _proto.readFromCacheOrEvaluate = function readFromCacheOrEvaluate(record, field, variables, evaluate, getDataForResolverFragment) {
+    return [evaluate().resolverResult, undefined];
+  };
+
+  _proto.invalidateDataIDs = function invalidateDataIDs(updatedDataIDs) {};
+
+  return NoopResolverCache;
+}();
+
+function addDependencyEdge(edges, from, to) {
+  var set = edges.get(from);
+
+  if (!set) {
+    set = new Set();
+    edges.set(from, set);
+  }
+
+  set.add(to);
+}
+
+var RecordResolverCache = /*#__PURE__*/function () {
+  function RecordResolverCache(getRecordSource) {
+    this._resolverIDToRecordIDs = new Map();
+    this._recordIDToResolverIDs = new Map();
+    this._getRecordSource = getRecordSource;
+  }
+
+  var _proto2 = RecordResolverCache.prototype;
+
+  _proto2.readFromCacheOrEvaluate = function readFromCacheOrEvaluate(record, field, variables, evaluate, getDataForResolverFragment) {
+    var recordSource = this._getRecordSource();
+
+    var recordID = RelayModernRecord.getDataID(record);
+    var storageKey = getStorageKey(field, variables);
+    var linkedID = RelayModernRecord.getLinkedRecordID(record, storageKey);
+    var linkedRecord = linkedID == null ? null : recordSource.get(linkedID);
+
+    if (linkedRecord == null || this._isInvalid(linkedRecord, getDataForResolverFragment)) {
+      var _linkedID;
+
+      // Cache miss; evaluate the selector and store the result in a new record:
+      linkedID = (_linkedID = linkedID) !== null && _linkedID !== void 0 ? _linkedID : generateClientID(recordID, storageKey);
+      linkedRecord = RelayModernRecord.create(linkedID, '__RELAY_RESOLVER__');
+      var evaluationResult = evaluate();
+      RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_VALUE_KEY, evaluationResult.resolverResult);
+      RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_INPUTS_KEY, evaluationResult.fragmentValue);
+      RelayModernRecord.setValue(linkedRecord, RELAY_RESOLVER_READER_SELECTOR_KEY, evaluationResult.readerSelector);
+      recordSource.set(linkedID, linkedRecord); // Link the resolver value record to the resolver field of the record being read:
+
+      var nextRecord = RelayModernRecord.clone(record);
+      RelayModernRecord.setLinkedRecordID(nextRecord, storageKey, linkedID);
+      recordSource.set(RelayModernRecord.getDataID(nextRecord), nextRecord); // Put records observed by the resolver into the dependency graph:
+
+      var resolverID = evaluationResult.resolverID;
+      addDependencyEdge(this._resolverIDToRecordIDs, resolverID, linkedID);
+      addDependencyEdge(this._recordIDToResolverIDs, recordID, resolverID);
+
+      var _iterator = (0, _createForOfIteratorHelper2["default"])(evaluationResult.seenRecordIDs),
+          _step;
+
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var seenRecordID = _step.value;
+          addDependencyEdge(this._recordIDToResolverIDs, seenRecordID, resolverID);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    } // $FlowFixMe[incompatible-type] - will always be empty
+
+
+    var answer = linkedRecord[RELAY_RESOLVER_VALUE_KEY];
+    return [answer, linkedID];
+  };
+
+  _proto2.invalidateDataIDs = function invalidateDataIDs(updatedDataIDs) {
+    var recordSource = this._getRecordSource();
+
+    var visited = new Set();
+    var recordsToVisit = Array.from(updatedDataIDs);
+
+    while (recordsToVisit.length) {
+      var recordID = recordsToVisit.pop();
+      updatedDataIDs.add(recordID);
+
+      var _iterator2 = (0, _createForOfIteratorHelper2["default"])((_this$_recordIDToReso = this._recordIDToResolverIDs.get(recordID)) !== null && _this$_recordIDToReso !== void 0 ? _this$_recordIDToReso : emptySet),
+          _step2;
+
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _this$_recordIDToReso;
+
+          var fragment = _step2.value;
+
+          if (!visited.has(fragment)) {
+            var _iterator3 = (0, _createForOfIteratorHelper2["default"])((_this$_resolverIDToRe = this._resolverIDToRecordIDs.get(fragment)) !== null && _this$_resolverIDToRe !== void 0 ? _this$_resolverIDToRe : emptySet),
+                _step3;
+
+            try {
+              for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+                var _this$_resolverIDToRe;
+
+                var anotherRecordID = _step3.value;
+
+                this._markInvalidatedResolverRecord(anotherRecordID, recordSource, updatedDataIDs);
+
+                if (!visited.has(anotherRecordID)) {
+                  recordsToVisit.push(anotherRecordID);
+                }
+              }
+            } catch (err) {
+              _iterator3.e(err);
+            } finally {
+              _iterator3.f();
+            }
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+  };
+
+  _proto2._markInvalidatedResolverRecord = function _markInvalidatedResolverRecord(dataID, recordSource, // Written to
+  updatedDataIDs) // Mutated in place
+  {
+    var record = recordSource.get(dataID);
+
+    if (!record) {
+      process.env.NODE_ENV !== "production" ? warning(false, 'Expected a resolver record with ID %s, but it was missing.', dataID) : void 0;
+      return;
+    }
+
+    var nextRecord = RelayModernRecord.clone(record);
+    RelayModernRecord.setValue(nextRecord, RELAY_RESOLVER_INVALIDATION_KEY, true);
+    recordSource.set(dataID, nextRecord);
+  };
+
+  _proto2._isInvalid = function _isInvalid(record, getDataForResolverFragment) {
+    if (!RelayModernRecord.getValue(record, RELAY_RESOLVER_INVALIDATION_KEY)) {
+      return false;
+    }
+
+    var originalInputs = RelayModernRecord.getValue(record, RELAY_RESOLVER_INPUTS_KEY); // $FlowFixMe[incompatible-type] - storing values in records is not typed
+
+    var readerSelector = RelayModernRecord.getValue(record, RELAY_RESOLVER_READER_SELECTOR_KEY);
+
+    if (originalInputs == null || readerSelector == null) {
+      process.env.NODE_ENV !== "production" ? warning(false, 'Expected previous inputs and reader selector on resolver record with ID %s, but they were missing.', RelayModernRecord.getDataID(record)) : void 0;
+      return true;
+    }
+
+    var latestValues = getDataForResolverFragment(readerSelector);
+    var recycled = recycleNodesInto(originalInputs, latestValues);
+
+    if (recycled !== originalInputs) {
+      return true;
+    }
+
+    return false;
+  };
+
+  return RecordResolverCache;
+}();
+
+module.exports = {
+  NoopResolverCache: NoopResolverCache,
+  RecordResolverCache: RecordResolverCache
+};

package/lib/store/ResolverFragments.js

@@ -48,7 +48,7 @@ function readFragment(fragmentInput, fragmentRef) {
   var fragmentSelector = getSelector(fragmentNode, fragmentRef);
   !(fragmentSelector != null) ? process.env.NODE_ENV !== "production" ? invariant(false, "Expected a selector for the fragment of the resolver ".concat(fragmentNode.name, ", but got null.")) : invariant(false) : void 0;
   !(fragmentSelector.kind === 'SingularReaderSelector') ? process.env.NODE_ENV !== "production" ? invariant(false, "Expected a singular reader selector for the fragment of the resolver ".concat(fragmentNode.name, ", but it was plural.")) : invariant(false) : void 0;
-  return context.getDataForResolverFragment(fragmentSelector);
+  return context.getDataForResolverFragment(fragmentSelector, fragmentRef);
 }
 
 module.exports = {

package/lib/store/createRelayContext.js

@@ -26,7 +26,7 @@ function createRelayContext(react) {
     firstReact = react;
   }
 
-  !(react === firstReact) ? process.env.NODE_ENV !== "production" ? invariant(false, '[createRelayContext]: You passing a different instance of React', react.version) : invariant(false) : void 0;
+  !(react === firstReact) ? process.env.NODE_ENV !== "production" ? invariant(false, '[createRelayContext]: You are passing a different instance of React', react.version) : invariant(false) : void 0;
   return relayContext;
 }
 

package/lib/subscription/requestSubscription.js

@@ -19,14 +19,11 @@ var warning = require("fbjs/lib/warning");
 var _require = require('../query/GraphQLTag'),
     getRequest = _require.getRequest;
 
-var _require2 = require('../store/ClientID'),
-    generateUniqueClientID = _require2.generateUniqueClientID;
+var _require2 = require('../store/RelayModernOperationDescriptor'),
+    createOperationDescriptor = _require2.createOperationDescriptor;
 
-var _require3 = require('../store/RelayModernOperationDescriptor'),
-    createOperationDescriptor = _require3.createOperationDescriptor;
-
-var _require4 = require('../store/RelayModernSelector'),
-    createReaderSelector = _require4.createReaderSelector;
+var _require3 = require('../store/RelayModernSelector'),
+    createReaderSelector = _require3.createReaderSelector;
 
 function requestSubscription(environment, config) {
   var subscription = getRequest(config.subscription);
@@ -41,43 +38,44 @@ function requestSubscription(environment, config) {
       onNext = config.onNext,
       variables = config.variables,
       cacheConfig = config.cacheConfig;
-  var operation = createOperationDescriptor(subscription, variables, cacheConfig, RelayFeatureFlags.ENABLE_UNIQUE_SUBSCRIPTION_ROOT ? generateUniqueClientID() : undefined);
+  var operation = createOperationDescriptor(subscription, variables, cacheConfig);
   process.env.NODE_ENV !== "production" ? warning(!(config.updater && configs), 'requestSubscription: Expected only one of `updater` and `configs` to be provided') : void 0;
 
   var _ref = configs ? RelayDeclarativeMutationConfig.convert(configs, subscription, null
   /* optimisticUpdater */
-  , config.updater) : config,
+  ,
+  /* optimisticUpdater */
+  config.updater) : config,
       updater = _ref.updater;
 
   var sub = environment.execute({
     operation: operation,
     updater: updater
-  }).map(function (responses) {
-    var selector = operation.fragment;
-
-    if (RelayFeatureFlags.ENABLE_UNIQUE_SUBSCRIPTION_ROOT) {
-      var nextID;
+  }).subscribe({
+    next: function next(responses) {
+      if (onNext != null) {
+        var selector = operation.fragment;
+        var nextID;
 
-      if (Array.isArray(responses)) {
-        var _responses$, _responses$$extension;
+        if (Array.isArray(responses)) {
+          var _responses$, _responses$$extension;
 
-        nextID = (_responses$ = responses[0]) === null || _responses$ === void 0 ? void 0 : (_responses$$extension = _responses$.extensions) === null || _responses$$extension === void 0 ? void 0 : _responses$$extension.__relay_subscription_root_id;
-      } else {
-        var _responses$extensions;
+          nextID = (_responses$ = responses[0]) === null || _responses$ === void 0 ? void 0 : (_responses$$extension = _responses$.extensions) === null || _responses$$extension === void 0 ? void 0 : _responses$$extension.__relay_subscription_root_id;
+        } else {
+          var _responses$extensions;
 
-        nextID = (_responses$extensions = responses.extensions) === null || _responses$extensions === void 0 ? void 0 : _responses$extensions.__relay_subscription_root_id;
-      }
+          nextID = (_responses$extensions = responses.extensions) === null || _responses$extensions === void 0 ? void 0 : _responses$extensions.__relay_subscription_root_id;
+        }
 
-      if (typeof nextID === 'string') {
-        selector = createReaderSelector(selector.node, nextID, selector.variables, selector.owner);
-      }
-    }
+        if (typeof nextID === 'string') {
+          selector = createReaderSelector(selector.node, nextID, selector.variables, selector.owner);
+        }
 
-    var data = environment.lookup(selector).data; // $FlowFixMe[incompatible-cast]
+        var data = environment.lookup(selector).data; // $FlowFixMe[incompatible-cast]
 
-    return data;
-  }).subscribe({
-    next: onNext,
+        onNext(data);
+      }
+    },
     error: onError,
     complete: onCompleted
   });

package/lib/util/RelayConcreteNode.js

@@ -24,6 +24,7 @@
  * for local caching.
  */
 var RelayConcreteNode = {
+  ACTOR_CHANGE: 'ActorChange',
   CONDITION: 'Condition',
   CLIENT_COMPONENT: 'ClientComponent',
   CLIENT_EXTENSION: 'ClientExtension',

package/lib/util/RelayFeatureFlags.js

@@ -13,18 +13,16 @@
 var RelayFeatureFlags = {
   ENABLE_VARIABLE_CONNECTION_KEY: false,
   ENABLE_PARTIAL_RENDERING_DEFAULT: true,
-  ENABLE_RELAY_CONTAINERS_SUSPENSE: true,
-  ENABLE_PRECISE_TYPE_REFINEMENT: false,
   ENABLE_REACT_FLIGHT_COMPONENT_FIELD: false,
   ENABLE_REQUIRED_DIRECTIVES: false,
   ENABLE_RELAY_RESOLVERS: false,
   ENABLE_GETFRAGMENTIDENTIFIER_OPTIMIZATION: false,
   ENABLE_FRIENDLY_QUERY_NAME_GQL_URL: false,
-  ENABLE_STORE_SUBSCRIPTIONS_REFACTOR: false,
   ENABLE_LOAD_QUERY_REQUEST_DEDUPING: true,
   ENABLE_DO_NOT_WRAP_LIVE_QUERY: false,
   ENABLE_NOTIFY_SUBSCRIPTION: false,
-  ENABLE_UNIQUE_SUBSCRIPTION_ROOT: false,
-  ENABLE_BATCHED_STORE_UPDATES: false
+  BATCH_ASYNC_MODULE_UPDATES_FN: null,
+  ENABLE_CONTAINERS_SUBSCRIBE_ON_COMMIT: false,
+  ENABLE_QUERY_RENDERER_OFFSCREEN_SUPPORT: false
 };
 module.exports = RelayFeatureFlags;

package/lib/util/RelayReplaySubject.js

@@ -12,6 +12,8 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
+
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
 var RelayObservable = require('../network/RelayObservable');
@@ -31,7 +33,7 @@ var RelayReplaySubject = /*#__PURE__*/function () {
     (0, _defineProperty2["default"])(this, "_complete", false);
     (0, _defineProperty2["default"])(this, "_events", []);
     (0, _defineProperty2["default"])(this, "_sinks", new Set());
-    (0, _defineProperty2["default"])(this, "_subscription", null);
+    (0, _defineProperty2["default"])(this, "_subscription", []);
     this._observable = RelayObservable.create(function (sink) {
       _this._sinks.add(sink);
 
@@ -121,16 +123,29 @@ var RelayReplaySubject = /*#__PURE__*/function () {
   };
 
   _proto.subscribe = function subscribe(observer) {
-    this._subscription = this._observable.subscribe(observer);
-    return this._subscription;
+    var subscription = this._observable.subscribe(observer);
+
+    this._subscription.push(subscription);
+
+    return subscription;
   };
 
   _proto.unsubscribe = function unsubscribe() {
-    if (this._subscription) {
-      this._subscription.unsubscribe();
+    var _iterator = (0, _createForOfIteratorHelper2["default"])(this._subscription),
+        _step;
 
-      this._subscription = null;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var subscription = _step.value;
+        subscription.unsubscribe();
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
     }
+
+    this._subscription = [];
   };
 
   _proto.getObserverCount = function getObserverCount() {

package/lib/util/getPaginationMetadata.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) Facebook, Inc. and its 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
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var getRefetchMetadata = require('./getRefetchMetadata');
+
+var invariant = require('invariant');
+
+function getPaginationMetadata(fragmentNode, componentDisplayName) {
+  var _fragmentNode$metadat, _fragmentNode$metadat2;
+
+  var _getRefetchMetadata = getRefetchMetadata(fragmentNode, componentDisplayName),
+      paginationRequest = _getRefetchMetadata.refetchableRequest,
+      refetchMetadata = _getRefetchMetadata.refetchMetadata;
+
+  var paginationMetadata = refetchMetadata.connection;
+  !(paginationMetadata != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getPaginationMetadata(): Expected fragment `%s` to include a ' + 'connection when using `%s`. Did you forget to add a @connection ' + 'directive to the connection field in the fragment?', componentDisplayName, fragmentNode.name) : invariant(false) : void 0;
+  var connectionPathInFragmentData = paginationMetadata.path;
+  var connectionMetadata = ((_fragmentNode$metadat = (_fragmentNode$metadat2 = fragmentNode.metadata) === null || _fragmentNode$metadat2 === void 0 ? void 0 : _fragmentNode$metadat2.connection) !== null && _fragmentNode$metadat !== void 0 ? _fragmentNode$metadat : [])[0];
+  !(connectionMetadata != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getPaginationMetadata(): Expected fragment `%s` to include a ' + 'connection when using `%s`. Did you forget to add a @connection ' + 'directive to the connection field in the fragment?', componentDisplayName, fragmentNode.name) : invariant(false) : void 0;
+  var identifierField = refetchMetadata.identifierField;
+  !(identifierField == null || typeof identifierField === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getRefetchMetadata(): Expected `identifierField` to be a string.') : invariant(false) : void 0;
+  return {
+    connectionPathInFragmentData: connectionPathInFragmentData,
+    identifierField: identifierField,
+    paginationRequest: paginationRequest,
+    paginationMetadata: paginationMetadata,
+    stream: connectionMetadata.stream === true
+  };
+}
+
+module.exports = getPaginationMetadata;

package/lib/util/getPaginationVariables.js

@@ -0,0 +1,67 @@
+/**
+ * Copyright (c) Facebook, Inc. and its 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
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _objectSpread4 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+
+var invariant = require('invariant');
+
+var warning = require("fbjs/lib/warning");
+
+function getPaginationVariables(direction, count, cursor, baseVariables, extraVariables, paginationMetadata) {
+  var _objectSpread3;
+
+  var backwardMetadata = paginationMetadata.backward,
+      forwardMetadata = paginationMetadata.forward;
+
+  if (direction === 'backward') {
+    var _objectSpread2;
+
+    !(backwardMetadata != null && backwardMetadata.count != null && backwardMetadata.cursor != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected backward pagination metadata to be available. ' + "If you're seeing this, this is likely a bug in Relay.") : invariant(false) : void 0;
+    process.env.NODE_ENV !== "production" ? warning(!extraVariables.hasOwnProperty(backwardMetadata.cursor), 'Relay: `UNSTABLE_extraVariables` provided by caller should not ' + 'contain cursor variable `%s`. This variable is automatically ' + 'determined by Relay.', backwardMetadata.cursor) : void 0;
+    process.env.NODE_ENV !== "production" ? warning(!extraVariables.hasOwnProperty(backwardMetadata.count), 'Relay: `UNSTABLE_extraVariables` provided by caller should not ' + 'contain count variable `%s`. This variable is automatically ' + 'determined by Relay.', backwardMetadata.count) : void 0; // $FlowFixMe[cannot-spread-interface]
+
+    var _paginationVariables = (0, _objectSpread4["default"])((0, _objectSpread4["default"])((0, _objectSpread4["default"])({}, baseVariables), extraVariables), {}, (_objectSpread2 = {}, (0, _defineProperty2["default"])(_objectSpread2, backwardMetadata.cursor, cursor), (0, _defineProperty2["default"])(_objectSpread2, backwardMetadata.count, count), _objectSpread2));
+
+    if (forwardMetadata && forwardMetadata.cursor) {
+      _paginationVariables[forwardMetadata.cursor] = null;
+    }
+
+    if (forwardMetadata && forwardMetadata.count) {
+      _paginationVariables[forwardMetadata.count] = null;
+    }
+
+    return _paginationVariables;
+  }
+
+  !(forwardMetadata != null && forwardMetadata.count != null && forwardMetadata.cursor != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected forward pagination metadata to be available. ' + "If you're seeing this, this is likely a bug in Relay.") : invariant(false) : void 0;
+  process.env.NODE_ENV !== "production" ? warning(!extraVariables.hasOwnProperty(forwardMetadata.cursor), 'Relay: `UNSTABLE_extraVariables` provided by caller should not ' + 'contain cursor variable `%s`. This variable is automatically ' + 'determined by Relay.', forwardMetadata.cursor) : void 0;
+  process.env.NODE_ENV !== "production" ? warning(!extraVariables.hasOwnProperty(forwardMetadata.count), 'Relay: `UNSTABLE_extraVariables` provided by caller should not ' + 'contain count variable `%s`. This variable is automatically ' + 'determined by Relay.', forwardMetadata.count) : void 0; // $FlowFixMe[cannot-spread-interface]
+
+  var paginationVariables = (0, _objectSpread4["default"])((0, _objectSpread4["default"])((0, _objectSpread4["default"])({}, baseVariables), extraVariables), {}, (_objectSpread3 = {}, (0, _defineProperty2["default"])(_objectSpread3, forwardMetadata.cursor, cursor), (0, _defineProperty2["default"])(_objectSpread3, forwardMetadata.count, count), _objectSpread3));
+
+  if (backwardMetadata && backwardMetadata.cursor) {
+    paginationVariables[backwardMetadata.cursor] = null;
+  }
+
+  if (backwardMetadata && backwardMetadata.count) {
+    paginationVariables[backwardMetadata.count] = null;
+  }
+
+  return paginationVariables;
+}
+
+module.exports = getPaginationVariables;

package/lib/util/getPendingOperationsForFragment.js

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) Facebook, Inc. and its 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
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var _require = require('../query/fetchQueryInternal'),
+    getPromiseForActiveRequest = _require.getPromiseForActiveRequest;
+
+function getPendingOperationsForFragment(environment, fragmentNode, fragmentOwner) {
+  var _pendingOperations$ma, _pendingOperations;
+
+  var pendingOperations = [];
+  var promise = getPromiseForActiveRequest(environment, fragmentOwner);
+
+  if (promise != null) {
+    pendingOperations = [fragmentOwner];
+  } else {
+    var _result$pendingOperat, _result$promise;
+
+    var result = environment.getOperationTracker().getPendingOperationsAffectingOwner(fragmentOwner);
+    pendingOperations = (_result$pendingOperat = result === null || result === void 0 ? void 0 : result.pendingOperations) !== null && _result$pendingOperat !== void 0 ? _result$pendingOperat : [];
+    promise = (_result$promise = result === null || result === void 0 ? void 0 : result.promise) !== null && _result$promise !== void 0 ? _result$promise : null;
+  }
+
+  if (!promise) {
+    return null;
+  }
+
+  var pendingOperationName = (_pendingOperations$ma = (_pendingOperations = pendingOperations) === null || _pendingOperations === void 0 ? void 0 : _pendingOperations.map(function (op) {
+    return op.node.params.name;
+  }).join(',')) !== null && _pendingOperations$ma !== void 0 ? _pendingOperations$ma : null;
+
+  if (pendingOperationName == null || pendingOperationName.length === 0) {
+    pendingOperationName = 'Unknown pending operation';
+  }
+
+  var fragmentName = fragmentNode.name;
+  var promiseDisplayName = pendingOperationName === fragmentName ? "Relay(".concat(pendingOperationName, ")") : "Relay(".concat(pendingOperationName, ":").concat(fragmentName, ")"); // $FlowExpectedError[prop-missing] Expando to annotate Promises.
+
+  promise.displayName = promiseDisplayName;
+  return {
+    promise: promise,
+    pendingOperations: pendingOperations
+  };
+}
+
+module.exports = getPendingOperationsForFragment;

package/lib/util/getRefetchMetadata.js

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) Facebook, Inc. and its 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
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var invariant = require('invariant');
+
+function getRefetchMetadata(fragmentNode, componentDisplayName) {
+  var _fragmentNode$metadat, _fragmentNode$metadat2;
+
+  !(((_fragmentNode$metadat = fragmentNode.metadata) === null || _fragmentNode$metadat === void 0 ? void 0 : _fragmentNode$metadat.plural) !== true) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getRefetchMetadata(): Expected fragment `%s` not to be plural when using ' + '`%s`. Remove `@relay(plural: true)` from fragment `%s` ' + 'in order to use it with `%s`.', fragmentNode.name, componentDisplayName, fragmentNode.name, componentDisplayName) : invariant(false) : void 0;
+  var refetchMetadata = (_fragmentNode$metadat2 = fragmentNode.metadata) === null || _fragmentNode$metadat2 === void 0 ? void 0 : _fragmentNode$metadat2.refetch;
+  !(refetchMetadata != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getRefetchMetadata(): Expected fragment `%s` to be refetchable when using `%s`. ' + 'Did you forget to add a @refetchable directive to the fragment?', componentDisplayName, fragmentNode.name) : invariant(false) : void 0; // handle both commonjs and es modules
+
+  var refetchableRequest = refetchMetadata.operation["default"] ? refetchMetadata.operation["default"] : refetchMetadata.operation;
+  var fragmentRefPathInResponse = refetchMetadata.fragmentPathInResult;
+  !(typeof refetchableRequest !== 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getRefetchMetadata(): Expected refetch query to be an ' + "operation and not a string when using `%s`. If you're seeing this, " + 'this is likely a bug in Relay.', componentDisplayName) : invariant(false) : void 0;
+  var identifierField = refetchMetadata.identifierField;
+  !(identifierField == null || typeof identifierField === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: getRefetchMetadata(): Expected `identifierField` to be a string.') : invariant(false) : void 0;
+  return {
+    fragmentRefPathInResponse: fragmentRefPathInResponse,
+    identifierField: identifierField,
+    refetchableRequest: refetchableRequest,
+    refetchMetadata: refetchMetadata
+  };
+}
+
+module.exports = getRefetchMetadata;

package/lib/util/getValueAtPath.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) Facebook, Inc. and its 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
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
+
+var invariant = require('invariant');
+
+function getValueAtPath(data, path) {
+  var result = data;
+
+  var _iterator = (0, _createForOfIteratorHelper2["default"])(path),
+      _step;
+
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+
+      if (result == null) {
+        return null;
+      }
+
+      if (typeof key === 'number') {
+        !Array.isArray(result) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected an array when extracting value at path. ' + "If you're seeing this, this is likely a bug in Relay.") : invariant(false) : void 0;
+        result = result[key];
+      } else {
+        !(typeof result === 'object' && !Array.isArray(result)) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Relay: Expected an object when extracting value at path. ' + "If you're seeing this, this is likely a bug in Relay.") : invariant(false) : void 0;
+        result = result[key];
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+
+  return result;
+}
+
+module.exports = getValueAtPath;