relay-runtime 11.0.0-rc.0 → 12.0.0

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/deepFreeze.js

@@ -19,6 +19,7 @@
 function deepFreeze(object) {
   Object.freeze(object);
   Object.getOwnPropertyNames(object).forEach(function (name) {
+    // $FlowFixMe[prop-missing]
     var property = object[name];
 
     if (property && typeof property === 'object' && !Object.isFrozen(property)) {

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/getRelayHandleKey.js

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

package/lib/util/getRequestIdentifier.js

@@ -10,7 +10,7 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var invariant = require("fbjs/lib/invariant");
+var invariant = require('invariant');
 
 var stableCopy = require('./stableCopy');
 

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;

package/lib/util/isEmptyObject.js

@@ -8,7 +8,7 @@
  * @format
  * @emails oncall+relay
  */
-'use strict';
+'use strict'; // $FlowFixMe[method-unbinding] added when improving typing for this parameters
 
 var hasOwnProperty = Object.prototype.hasOwnProperty;
 

package/lib/util/registerEnvironmentWithDevTools.js

@@ -0,0 +1,26 @@
+/**
+ * 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
+ * @emails oncall+relay
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+function registerEnvironmentWithDevTools(environment) {
+  // Register this Relay Environment with Relay DevTools if it exists.
+  // Note: this must always be the last step in the constructor.
+  var _global = typeof global !== 'undefined' ? global : typeof window !== 'undefined' ? window : undefined;
+
+  var devToolsHook = _global && _global.__RELAY_DEVTOOLS_HOOK__;
+
+  if (devToolsHook) {
+    devToolsHook.registerEnvironment(environment);
+  }
+}
+
+module.exports = registerEnvironmentWithDevTools;

package/lib/util/withDuration.js

@@ -0,0 +1,31 @@
+/**
+ * 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 _window, _window$performance;
+
+var isPerformanceNowAvailable = typeof window !== 'undefined' && typeof ((_window = window) === null || _window === void 0 ? void 0 : (_window$performance = _window.performance) === null || _window$performance === void 0 ? void 0 : _window$performance.now) === 'function';
+
+function currentTimestamp() {
+  if (isPerformanceNowAvailable) {
+    return window.performance.now();
+  }
+
+  return Date.now();
+}
+
+function withDuration(cb) {
+  var startTime = currentTimestamp();
+  var result = cb();
+  return [currentTimestamp() - startTime, result];
+}
+
+module.exports = withDuration;