relay-runtime 11.0.1 → 13.0.0-rc.1

package/lib/util/RelayProfiler.js

@@ -10,25 +10,9 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-function emptyFunction() {}
-
-var aggregateHandlersByName = {
-  '*': []
-};
-var profileHandlersByName = {
-  '*': []
-};
-var NOT_INVOKED = {};
+var profileHandlersByName = {};
 var defaultProfiler = {
-  stop: emptyFunction
-};
-
-var shouldInstrument = function shouldInstrument(name) {
-  if (process.env.NODE_ENV !== "production") {
-    return true;
-  }
-
-  return name.charAt(0) !== '@';
+  stop: function stop() {}
 };
 /**
  * @public
@@ -57,152 +41,9 @@ var shouldInstrument = function shouldInstrument(name) {
  *       console.log(`Duration (${name})`, performance.now() - start);
  *     }
  *   });
- *
- * In order to reduce the impact on performance in production, instrumented
- * methods and profilers with names that begin with `@` will only be measured
- * if `__DEV__` is true. This should be used for very hot functions.
  */
 
-
 var RelayProfiler = {
-  /**
-   * Instruments methods on a class or object. This re-assigns the method in
-   * order to preserve function names in stack traces (which are detected by
-   * modern debuggers via heuristics). Example usage:
-   *
-   *   const RelayStore = { primeCache: function() {...} };
-   *   RelayProfiler.instrumentMethods(RelayStore, {
-   *     primeCache: 'RelayStore.primeCache'
-   *   });
-   *
-   *   RelayStore.primeCache.attachHandler(...);
-   *
-   * As a result, the methods will be replaced by wrappers that provide the
-   * `attachHandler` and `detachHandler` methods.
-   */
-  instrumentMethods: function instrumentMethods(object, names) {
-    for (var _key in names) {
-      if (names.hasOwnProperty(_key)) {
-        if (typeof object[_key] === 'function') {
-          object[_key] = RelayProfiler.instrument(names[_key], object[_key]);
-        }
-      }
-    }
-  },
-
-  /**
-   * Wraps the supplied function with one that provides the `attachHandler` and
-   * `detachHandler` methods. Example usage:
-   *
-   *   const printRelayQuery =
-   *     RelayProfiler.instrument('printRelayQuery', printRelayQuery);
-   *
-   *   printRelayQuery.attachHandler(...);
-   *
-   * NOTE: The instrumentation assumes that no handlers are attached or detached
-   * in the course of executing another handler.
-   */
-  instrument: function instrument(name, originalFunction) {
-    if (!shouldInstrument(name)) {
-      originalFunction.attachHandler = emptyFunction;
-      originalFunction.detachHandler = emptyFunction;
-      return originalFunction;
-    }
-
-    if (!aggregateHandlersByName.hasOwnProperty(name)) {
-      aggregateHandlersByName[name] = [];
-    }
-
-    var catchallHandlers = aggregateHandlersByName['*'];
-    var aggregateHandlers = aggregateHandlersByName[name];
-    var handlers = [];
-    var contexts = [];
-
-    var invokeHandlers = function invokeHandlers() {
-      var context = contexts[contexts.length - 1];
-
-      if (context[0]) {
-        context[0]--;
-        catchallHandlers[context[0]](name, invokeHandlers);
-      } else if (context[1]) {
-        context[1]--;
-        aggregateHandlers[context[1]](name, invokeHandlers);
-      } else if (context[2]) {
-        context[2]--;
-        handlers[context[2]](name, invokeHandlers);
-      } else {
-        context[5] = originalFunction.apply(context[3], context[4]);
-      }
-    };
-
-    var instrumentedCallback = function instrumentedCallback() {
-      var returnValue;
-
-      if (aggregateHandlers.length === 0 && handlers.length === 0 && catchallHandlers.length === 0) {
-        returnValue = originalFunction.apply(this, arguments);
-      } else {
-        contexts.push([catchallHandlers.length, aggregateHandlers.length, handlers.length, this, arguments, NOT_INVOKED]);
-        invokeHandlers();
-        var context = contexts.pop();
-        returnValue = context[5];
-
-        if (returnValue === NOT_INVOKED) {
-          throw new Error('RelayProfiler: Handler did not invoke original function.');
-        }
-      }
-
-      return returnValue;
-    };
-
-    instrumentedCallback.attachHandler = function (handler) {
-      handlers.push(handler);
-    };
-
-    instrumentedCallback.detachHandler = function (handler) {
-      removeFromArray(handlers, handler);
-    };
-
-    instrumentedCallback.displayName = '(instrumented ' + name + ')';
-    return instrumentedCallback;
-  },
-
-  /**
-   * Attaches a handler to all methods instrumented with the supplied name.
-   *
-   *   function createRenderer() {
-   *     return RelayProfiler.instrument('render', function() {...});
-   *   }
-   *   const renderA = createRenderer();
-   *   const renderB = createRenderer();
-   *
-   *   // Only profiles `renderA`.
-   *   renderA.attachHandler(...);
-   *
-   *   // Profiles both `renderA` and `renderB`.
-   *   RelayProfiler.attachAggregateHandler('render', ...);
-   *
-   */
-  attachAggregateHandler: function attachAggregateHandler(name, handler) {
-    if (shouldInstrument(name)) {
-      if (!aggregateHandlersByName.hasOwnProperty(name)) {
-        aggregateHandlersByName[name] = [];
-      }
-
-      aggregateHandlersByName[name].push(handler);
-    }
-  },
-
-  /**
-   * Detaches a handler attached via `attachAggregateHandler`.
-   */
-  detachAggregateHandler: function detachAggregateHandler(name, handler) {
-    if (shouldInstrument(name)) {
-      if (aggregateHandlersByName.hasOwnProperty(name)) {
-        removeFromArray(aggregateHandlersByName[name], handler);
-      }
-    }
-  },
-
   /**
    * Instruments profiling for arbitrarily asynchronous code by a name.
    *
@@ -217,27 +58,21 @@ var RelayProfiler = {
    * attached profile handlers will receive this as the second argument.
    */
   profile: function profile(name, state) {
-    var hasCatchAllHandlers = profileHandlersByName['*'].length > 0;
-    var hasNamedHandlers = profileHandlersByName.hasOwnProperty(name);
+    var handlers = profileHandlersByName[name];
 
-    if (hasNamedHandlers || hasCatchAllHandlers) {
-      var profileHandlers = hasNamedHandlers && hasCatchAllHandlers ? profileHandlersByName[name].concat(profileHandlersByName['*']) : hasNamedHandlers ? profileHandlersByName[name] : profileHandlersByName['*'];
-      var stopHandlers;
+    if (handlers && handlers.length > 0) {
+      var stopHandlers = [];
 
-      for (var ii = profileHandlers.length - 1; ii >= 0; ii--) {
-        var profileHandler = profileHandlers[ii];
-        var stopHandler = profileHandler(name, state);
-        stopHandlers = stopHandlers || [];
+      for (var ii = handlers.length - 1; ii >= 0; ii--) {
+        var stopHandler = handlers[ii](name, state);
         stopHandlers.unshift(stopHandler);
       }
 
       return {
         stop: function stop(error) {
-          if (stopHandlers) {
-            stopHandlers.forEach(function (stopHandler) {
-              return stopHandler(error);
-            });
-          }
+          stopHandlers.forEach(function (stopHandler) {
+            return stopHandler(error);
+          });
         }
       };
     }
@@ -246,27 +81,22 @@ var RelayProfiler = {
   },
 
   /**
-   * Attaches a handler to profiles with the supplied name. You can also
-   * attach to the special name '*' which is a catch all.
+   * Attaches a handler to profiles with the supplied name.
    */
   attachProfileHandler: function attachProfileHandler(name, handler) {
-    if (shouldInstrument(name)) {
-      if (!profileHandlersByName.hasOwnProperty(name)) {
-        profileHandlersByName[name] = [];
-      }
-
-      profileHandlersByName[name].push(handler);
+    if (!profileHandlersByName.hasOwnProperty(name)) {
+      profileHandlersByName[name] = [];
     }
+
+    profileHandlersByName[name].push(handler);
   },
 
   /**
    * Detaches a handler attached via `attachProfileHandler`.
    */
   detachProfileHandler: function detachProfileHandler(name, handler) {
-    if (shouldInstrument(name)) {
-      if (profileHandlersByName.hasOwnProperty(name)) {
-        removeFromArray(profileHandlersByName[name], handler);
-      }
+    if (profileHandlersByName.hasOwnProperty(name)) {
+      removeFromArray(profileHandlersByName[name], handler);
     }
   }
 };

package/lib/util/RelayReplaySubject.js

@@ -12,11 +12,13 @@
 
 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');
 
-var invariant = require("fbjs/lib/invariant");
+var invariant = require('invariant');
 
 /**
  * An implementation of a `ReplaySubject` for Relay Observables.
@@ -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/RelayRuntimeTypes.js

@@ -11,10 +11,4 @@
 'use strict';
 /**
  * Basic types used throughout Relay.
- */
-
-/**
- * Represents any resource that must be explicitly disposed of. The most common
- * use-case is as a return value for subscriptions, where calling `dispose()`
- * would cancel the subscription.
  */

package/lib/util/StringInterner.js

@@ -0,0 +1,71 @@
+/**
+ * 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 internTable = new Map();
+var nextIndex = 1;
+var digits = initDigitTable(); // Character used as the prefix for interned strings. The specific character is
+// chosen to reduce the likelihood that non-interned input strings need to be
+// escaped (choosing eg a-Z would increase the likelihood we need to escape)
+
+var INTERN_PREFIX = '\t'; // Character used as the prefix of escaped strings. As above, this is also
+// chosen to be unlikely in normal input strings.
+
+var ESCAPE_PREFIX = '\v';
+
+function initDigitTable() {
+  // disable lint because digits isn't defined when this function is called
+  // eslint-disable-next-line no-shadow
+  var digits = new Set();
+
+  for (var i = 0; i < 10; ++i) {
+    digits.add(i.toString());
+  }
+
+  return digits;
+} // Escape a string so that it cannot conflict with an interned string
+
+
+function escape(str) {
+  if ( // "\t<digit>..." -> "\v\t<digit>..."
+  str[0] === INTERN_PREFIX && digits.has(str[1]) || // "\v..." -> "\v\v..."
+  str[0] === ESCAPE_PREFIX) {
+    return ESCAPE_PREFIX + str;
+  }
+
+  return str;
+} // Interns the input string if its length equals or exceeds the given `limit`,
+// returning a shorter replacement string that is uniquely associated with the
+// input: multiple calls to intern() for the equivalent input strings (and limit)
+// will always return the exact same string.
+// Strings shorter than the limit are not interned but are escaped if they
+// could conflict with interned strings.
+
+
+function intern(str, limit) {
+  if (limit == null || str.length < limit) {
+    return escape(str);
+  }
+
+  var internedString = internTable.get(str);
+
+  if (internedString != null) {
+    return internedString;
+  }
+
+  internedString = INTERN_PREFIX + nextIndex++;
+  internTable.set(str, internedString);
+  return internedString;
+}
+
+module.exports = {
+  intern: intern
+};

package/lib/util/getFragmentIdentifier.js

@@ -11,16 +11,19 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var RelayFeatureFlags = require('./RelayFeatureFlags');
+var _require = require('../store/RelayModernSelector'),
+    getDataIDsFromFragment = _require.getDataIDsFromFragment,
+    getSelector = _require.getSelector,
+    getVariablesFromFragment = _require.getVariablesFromFragment;
 
 var isEmptyObject = require('./isEmptyObject');
 
+var RelayFeatureFlags = require('./RelayFeatureFlags');
+
 var stableCopy = require('./stableCopy');
 
-var _require = require('../store/RelayModernSelector'),
-    getDataIDsFromFragment = _require.getDataIDsFromFragment,
-    getVariablesFromFragment = _require.getVariablesFromFragment,
-    getSelector = _require.getSelector;
+var _require2 = require('./StringInterner'),
+    intern = _require2.intern;
 
 function getFragmentIdentifier(fragmentNode, fragmentRef) {
   var selector = getSelector(fragmentNode, fragmentRef);
@@ -31,11 +34,16 @@ function getFragmentIdentifier(fragmentNode, fragmentRef) {
   var dataIDs = getDataIDsFromFragment(fragmentNode, fragmentRef);
 
   if (RelayFeatureFlags.ENABLE_GETFRAGMENTIDENTIFIER_OPTIMIZATION) {
-    return fragmentOwnerIdentifier + '/' + fragmentNode.name + '/' + (fragmentVariables == null || isEmptyObject(fragmentVariables) ? '{}' : JSON.stringify(stableCopy(fragmentVariables))) + '/' + (typeof dataIDs === 'undefined' ? 'missing' : dataIDs == null ? 'null' : Array.isArray(dataIDs) ? '[' + dataIDs.join(',') + ']' : dataIDs);
+    var ids = typeof dataIDs === 'undefined' ? 'missing' : dataIDs == null ? 'null' : Array.isArray(dataIDs) ? '[' + dataIDs.join(',') + ']' : dataIDs;
+    ids = RelayFeatureFlags.STRING_INTERN_LEVEL <= 1 ? ids : intern(ids, RelayFeatureFlags.MAX_DATA_ID_LENGTH);
+    return fragmentOwnerIdentifier + '/' + fragmentNode.name + '/' + (fragmentVariables == null || isEmptyObject(fragmentVariables) ? '{}' : JSON.stringify(stableCopy(fragmentVariables))) + '/' + ids;
   } else {
     var _JSON$stringify;
 
-    return fragmentOwnerIdentifier + '/' + fragmentNode.name + '/' + JSON.stringify(stableCopy(fragmentVariables)) + '/' + ((_JSON$stringify = JSON.stringify(dataIDs)) !== null && _JSON$stringify !== void 0 ? _JSON$stringify : 'missing');
+    var _ids = (_JSON$stringify = JSON.stringify(dataIDs)) !== null && _JSON$stringify !== void 0 ? _JSON$stringify : 'missing';
+
+    _ids = RelayFeatureFlags.STRING_INTERN_LEVEL <= 1 ? _ids : intern(_ids, RelayFeatureFlags.MAX_DATA_ID_LENGTH);
+    return fragmentOwnerIdentifier + '/' + fragmentNode.name + '/' + JSON.stringify(stableCopy(fragmentVariables)) + '/' + _ids;
   }
 }
 

package/lib/util/getOperation.js

@@ -14,11 +14,12 @@
 var _require = require('./RelayConcreteNode'),
     REQUEST = _require.REQUEST,
     SPLIT_OPERATION = _require.SPLIT_OPERATION;
-
 /**
  * OperationLoaders can return either a NormalizationSplitOperation or
  * ConcreteRequest.
  */
+
+
 function getOperation(node) {
   switch (node.kind) {
     case REQUEST:

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,66 @@
+/**
+ * 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;
+
+    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;
+  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/getRelayHandleKey.js

@@ -10,10 +10,10 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var invariant = require("fbjs/lib/invariant");
-
 var _require = require('./RelayDefaultHandleKey'),
     DEFAULT_HANDLE_KEY = _require.DEFAULT_HANDLE_KEY;
+
+var invariant = require('invariant');
 /**
  * @internal
  *