relay-runtime 1.3.0 → 1.5.0

package/LICENSE

@@ -1,31 +1,21 @@
-BSD License
-
-For Relay software
+MIT License
 
 Copyright (c) 2013-present, Facebook, Inc.
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
- * Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
 
- * Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
- * Neither the name Facebook nor the names of its contributors may be used to
-   endorse or promote products derived from this software without specific
-   prior written permission.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/index.js

@@ -1,13 +1,10 @@
 /**
- * Relay v1.3.0
+ * Relay v1.5.0
  *
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
- *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
  *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  */
 
 module.exports = require('./lib/RelayRuntime.js');

package/lib/ConvertToExecuteFunction.js

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2013-present, Facebook, Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @providesModule ConvertToExecuteFunction
+ * 
+ * @format
+ */
+
+'use strict';
+
+/**
+ * Converts a FetchFunction into an ExecuteFunction for use by RelayNetwork.
+ */
+function convertFetch(fn) {
+  return function fetch(request, variables, cacheConfig, uploadables) {
+    var result = fn(request, variables, cacheConfig, uploadables);
+    // Note: We allow FetchFunction to directly return Error to indicate
+    // a failure to fetch. To avoid handling this special case throughout the
+    // Relay codebase, it is explicitly handled here.
+    if (result instanceof Error) {
+      return require('./RelayObservable').create(function (sink) {
+        return sink.error(result);
+      });
+    }
+    return require('./RelayObservable').from(result).map(function (value) {
+      return convertToExecutePayload(request, variables, value);
+    });
+  };
+}
+
+/**
+ * Converts a SubscribeFunction into an ExecuteFunction for use by RelayNetwork.
+ */
+function convertSubscribe(fn) {
+  return function subscribe(operation, variables, cacheConfig) {
+    return require('./RelayObservable').fromLegacy(function (observer) {
+      return fn(operation, variables, cacheConfig, observer);
+    }).map(function (value) {
+      return convertToExecutePayload(operation, variables, value);
+    });
+  };
+}
+
+/**
+ * Given a value which might be a plain GraphQLResponse, coerce to always return
+ * an ExecutePayload. A GraphQLResponse may be returned directly from older or
+ * simpler Relay Network implementations.
+ */
+function convertToExecutePayload(request, variables, value) {
+  if (!value.data && !value.errors && value.response) {
+    if (!value.operation) {
+      require('fbjs/lib/warning')(false, 'ConvertToExecuteFunction: execute payload contains response but ' + 'is missing operation.');
+      return createExecutePayload(request, variables, value.response);
+    }
+    return value;
+  }
+  return createExecutePayload(request, variables, value);
+}
+
+function createExecutePayload(request, variables, response) {
+  if (request.kind === require('./RelayConcreteNode').BATCH_REQUEST) {
+    throw new Error('ConvertToExecuteFunction: Batch request must return ExecutePayload.');
+  }
+  return { operation: request.operation, variables: variables, response: response };
+}
+
+module.exports = {
+  convertFetch: convertFetch,
+  convertSubscribe: convertSubscribe
+};

package/lib/RelayConcreteNode.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayConcreteNode
  * 
@@ -14,19 +12,27 @@
 'use strict';
 
 /**
- * Represents a single ConcreteRoot along with metadata for processing it at
- * runtime. The persisted `id` (or `text`) can be used to fetch the query,
- * the `fragment` can be used to read the root data (masking data from child
- * fragments), and the `query` can be used to normalize server responses.
+ * Represents a common GraphQL request with `text` (or persisted `id`) can be
+ * used to execute it, an `operation` containing information to normalize the
+ * results, and a `fragment` derived from that operation to read the response
+ * data (masking data from child fragments).
+ */
+
+/**
+ * An experimental wrapper around many operations to request in a batched
+ * network request. The composed indivual GraphQL requests should be submitted
+ * as a single networked request, e.g. in the case of deferred nodes or
+ * for streaming connections that are represented as distinct compiled concrete
+ * operations but are still conceptually tied to one source operation.
  *
- * NOTE: The use of "batch" in the name is intentional, as this wrapper around
- * the ConcreteRoot will provide a place to store multiple concrete nodes that
- * are part of the same batch, e.g. in the case of deferred nodes or
- * for streaming connections that are represented as distinct concrete roots but
- * are still conceptually tied to one source query.
+ * Individual requests within the batch may contain data describing their
+ * dependencies on other requests or themselves.
  */
 var RelayConcreteNode = {
+  BATCH_REQUEST: 'BatchRequest',
   CONDITION: 'Condition',
+  DEFERRABLE_FRAGMENT_SPREAD: 'DeferrableFragmentSpread',
+  DEFERRABLE_OPERATION: 'DeferrableOperation',
   FRAGMENT: 'Fragment',
   FRAGMENT_SPREAD: 'FragmentSpread',
   INLINE_FRAGMENT: 'InlineFragment',
@@ -34,11 +40,22 @@ var RelayConcreteNode = {
   LINKED_HANDLE: 'LinkedHandle',
   LITERAL: 'Literal',
   LOCAL_ARGUMENT: 'LocalArgument',
-  ROOT: 'Root',
+  OPERATION: 'Operation',
   ROOT_ARGUMENT: 'RootArgument',
+  REQUEST: 'Request',
   SCALAR_FIELD: 'ScalarField',
   SCALAR_HANDLE: 'ScalarHandle',
   VARIABLE: 'Variable'
 };
+/**
+ * Represents a single operation used to processing and normalize runtime
+ * request results.
+ */
+
+/**
+ * Argument in the provided operation to be derived via the results of
+ * other requests in the batch.
+ */
+
 
 module.exports = RelayConcreteNode;

package/lib/RelayConcreteVariables.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * 
  * @providesModule RelayConcreteVariables
@@ -36,7 +34,14 @@ function getFragmentVariables(fragment, rootVariables, argumentVariables) {
         variables[definition.name] = definition.defaultValue;
         break;
       case 'RootArgument':
-        require('fbjs/lib/invariant')(rootVariables.hasOwnProperty(definition.name), 'RelayConcreteVariables: Expected a defined query variable for `$%s` ' + 'in fragment `%s`.', definition.name, fragment.name);
+        if (!rootVariables.hasOwnProperty(definition.name)) {
+          /*
+           * A temporary fix to mute false alarm in cases where the root argument is stripped
+           * off by the compiler due to a conditional directive, we do not need this argument
+           * when tryiny to read the data from the store.
+           */
+          break;
+        }
         variables[definition.name] = rootVariables[definition.name];
         break;
       default:
@@ -54,7 +59,7 @@ function getFragmentVariables(fragment, rootVariables, argumentVariables) {
  */
 function getOperationVariables(operation, variables) {
   var operationVariables = {};
-  operation.query.argumentDefinitions.forEach(function (def) {
+  operation.argumentDefinitions.forEach(function (def) {
     var value = def.defaultValue;
     if (variables[def.name] != null) {
       value = variables[def.name];

package/lib/RelayConnectionHandler.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayConnectionHandler
  * 

package/lib/RelayConnectionInterface.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayConnectionInterface
  * 
@@ -90,7 +88,7 @@ var RelayConnectionInterface = {
   getDefaultPageInfo: function getDefaultPageInfo() {
     var _ref;
 
-    return _ref = {}, (0, _defineProperty3['default'])(_ref, config.END_CURSOR, undefined), (0, _defineProperty3['default'])(_ref, config.HAS_NEXT_PAGE, false), (0, _defineProperty3['default'])(_ref, config.HAS_PREV_PAGE, false), (0, _defineProperty3['default'])(_ref, config.START_CURSOR, undefined), _ref;
+    return _ref = {}, (0, _defineProperty3['default'])(_ref, config.END_CURSOR, null), (0, _defineProperty3['default'])(_ref, config.HAS_NEXT_PAGE, false), (0, _defineProperty3['default'])(_ref, config.HAS_PREV_PAGE, false), (0, _defineProperty3['default'])(_ref, config.START_CURSOR, null), _ref;
   }
 };
 

package/lib/RelayCore.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayCore
  * 
@@ -15,7 +13,7 @@
 
 var _require = require('./RelayModernGraphQLTag'),
     getFragment = _require.getFragment,
-    getOperation = _require.getOperation;
+    getRequest = _require.getRequest;
 
 var _require2 = require('./RelayModernOperationSelector'),
     createOperationSelector = _require2.createOperationSelector;
@@ -46,7 +44,7 @@ module.exports = {
   createOperationSelector: createOperationSelector,
   getDataIDsFromObject: getDataIDsFromObject,
   getFragment: getFragment,
-  getOperation: getOperation,
+  getRequest: getRequest,
   getSelector: getSelector,
   getSelectorList: getSelectorList,
   getSelectorsFromObject: getSelectorsFromObject,

package/lib/RelayDataLoader.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayDataLoader
  * 

package/lib/RelayDeclarativeMutationConfig.js

@@ -0,0 +1,316 @@
+/**
+ * Copyright (c) 2013-present, Facebook, Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @providesModule RelayDeclarativeMutationConfig
+ * 
+ * @format
+ */
+
+'use strict';
+
+var MutationTypes = Object.freeze({
+  RANGE_ADD: 'RANGE_ADD',
+  RANGE_DELETE: 'RANGE_DELETE',
+  NODE_DELETE: 'NODE_DELETE',
+  FIELDS_CHANGE: 'FIELDS_CHANGE',
+  REQUIRED_CHILDREN: 'REQUIRED_CHILDREN'
+});
+
+
+var RangeOperations = Object.freeze({
+  APPEND: 'append',
+  IGNORE: 'ignore',
+  PREPEND: 'prepend',
+  REFETCH: 'refetch', // legacy only
+  REMOVE: 'remove' // legacy only
+});
+
+// Unused in Relay Modern
+
+
+// Unused in Relay Modern
+
+
+function convert(configs, request, optimisticUpdater, updater) {
+  var configOptimisticUpdates = optimisticUpdater ? [optimisticUpdater] : [];
+  var configUpdates = updater ? [updater] : [];
+  configs.forEach(function (config) {
+    switch (config.type) {
+      case 'NODE_DELETE':
+        var nodeDeleteResult = nodeDelete(config, request);
+        if (nodeDeleteResult) {
+          configOptimisticUpdates.push(nodeDeleteResult);
+          configUpdates.push(nodeDeleteResult);
+        }
+        break;
+      case 'RANGE_ADD':
+        var rangeAddResult = rangeAdd(config, request);
+        if (rangeAddResult) {
+          configOptimisticUpdates.push(rangeAddResult);
+          configUpdates.push(rangeAddResult);
+        }
+        break;
+      case 'RANGE_DELETE':
+        var rangeDeleteResult = rangeDelete(config, request);
+        if (rangeDeleteResult) {
+          configOptimisticUpdates.push(rangeDeleteResult);
+          configUpdates.push(rangeDeleteResult);
+        }
+        break;
+    }
+  });
+  return {
+    optimisticUpdater: function optimisticUpdater(store, data) {
+      configOptimisticUpdates.forEach(function (eachOptimisticUpdater) {
+        eachOptimisticUpdater(store, data);
+      });
+    },
+    updater: function updater(store, data) {
+      configUpdates.forEach(function (eachUpdater) {
+        eachUpdater(store, data);
+      });
+    }
+  };
+}
+
+function nodeDelete(config, request) {
+  var deletedIDFieldName = config.deletedIDFieldName;
+
+  var rootField = getRootField(request);
+  if (!rootField) {
+    return null;
+  }
+  return function (store, data) {
+    var payload = store.getRootField(rootField);
+    if (!payload) {
+      return;
+    }
+    var deleteID = payload.getValue(deletedIDFieldName);
+    var deleteIDs = Array.isArray(deleteID) ? deleteID : [deleteID];
+    deleteIDs.forEach(function (id) {
+      if (id && typeof id === 'string') {
+        store['delete'](id);
+      }
+    });
+  };
+}
+
+function rangeAdd(config, request) {
+  var parentID = config.parentID,
+      connectionInfo = config.connectionInfo,
+      edgeName = config.edgeName;
+
+  if (!parentID) {
+    require('fbjs/lib/warning')(false, 'RelayDeclarativeMutationConfig: For mutation config RANGE_ADD ' + 'to work you must include a parentID');
+    return null;
+  }
+  var rootField = getRootField(request);
+  if (!connectionInfo || !rootField) {
+    return null;
+  }
+  return function (store, data) {
+    var parent = store.get(parentID);
+    if (!parent) {
+      return;
+    }
+    var payload = store.getRootField(rootField);
+    if (!payload) {
+      return;
+    }
+    var serverEdge = payload.getLinkedRecord(edgeName);
+    var _iteratorNormalCompletion = true;
+    var _didIteratorError = false;
+    var _iteratorError = undefined;
+
+    try {
+      for (var _iterator = connectionInfo[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+        var info = _step.value;
+
+        if (!serverEdge) {
+          continue;
+        }
+        var connection = require('./RelayConnectionHandler').getConnection(parent, info.key, info.filters);
+        if (!connection) {
+          continue;
+        }
+        var clientEdge = require('./RelayConnectionHandler').buildConnectionEdge(store, connection, serverEdge);
+        if (!clientEdge) {
+          continue;
+        }
+        switch (info.rangeBehavior) {
+          case 'append':
+            require('./RelayConnectionHandler').insertEdgeAfter(connection, clientEdge);
+            break;
+          case 'ignore':
+            // Do nothing
+            break;
+          case 'prepend':
+            require('./RelayConnectionHandler').insertEdgeBefore(connection, clientEdge);
+            break;
+          default:
+            require('fbjs/lib/warning')(false, 'RelayDeclarativeMutationConfig: RANGE_ADD range behavior `%s` ' + 'will not work as expected in RelayModern, supported range ' + "behaviors are 'append', 'prepend', and 'ignore'.", info.rangeBehavior);
+            break;
+        }
+      }
+    } catch (err) {
+      _didIteratorError = true;
+      _iteratorError = err;
+    } finally {
+      try {
+        if (!_iteratorNormalCompletion && _iterator['return']) {
+          _iterator['return']();
+        }
+      } finally {
+        if (_didIteratorError) {
+          throw _iteratorError;
+        }
+      }
+    }
+  };
+}
+
+function rangeDelete(config, request) {
+  var parentID = config.parentID,
+      connectionKeys = config.connectionKeys,
+      pathToConnection = config.pathToConnection,
+      deletedIDFieldName = config.deletedIDFieldName;
+
+  if (!parentID) {
+    require('fbjs/lib/warning')(false, 'RelayDeclarativeMutationConfig: For mutation config RANGE_DELETE ' + 'to work you must include a parentID');
+    return null;
+  }
+  var rootField = getRootField(request);
+  if (!rootField) {
+    return null;
+  }
+  return function (store, data) {
+    if (!data) {
+      return;
+    }
+    var deleteIDs = [];
+    var deletedIDField = data[rootField];
+    if (deletedIDField && Array.isArray(deletedIDFieldName)) {
+      var _iteratorNormalCompletion2 = true;
+      var _didIteratorError2 = false;
+      var _iteratorError2 = undefined;
+
+      try {
+        for (var _iterator2 = deletedIDFieldName[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+          var eachField = _step2.value;
+
+          if (deletedIDField && typeof deletedIDField === 'object') {
+            deletedIDField = deletedIDField[eachField];
+          }
+        }
+      } catch (err) {
+        _didIteratorError2 = true;
+        _iteratorError2 = err;
+      } finally {
+        try {
+          if (!_iteratorNormalCompletion2 && _iterator2['return']) {
+            _iterator2['return']();
+          }
+        } finally {
+          if (_didIteratorError2) {
+            throw _iteratorError2;
+          }
+        }
+      }
+
+      if (Array.isArray(deletedIDField)) {
+        deletedIDField.forEach(function (idObject) {
+          if (idObject && idObject.id && typeof idObject === 'object' && typeof idObject.id === 'string') {
+            deleteIDs.push(idObject.id);
+          }
+        });
+      } else if (deletedIDField && deletedIDField.id && typeof deletedIDField.id === 'string') {
+        deleteIDs.push(deletedIDField.id);
+      }
+    } else if (deletedIDField && typeof deletedIDFieldName === 'string' && typeof deletedIDField === 'object') {
+      deletedIDField = deletedIDField[deletedIDFieldName];
+      if (typeof deletedIDField === 'string') {
+        deleteIDs.push(deletedIDField);
+      } else if (Array.isArray(deletedIDField)) {
+        deletedIDField.forEach(function (id) {
+          if (typeof id === 'string') {
+            deleteIDs.push(id);
+          }
+        });
+      }
+    }
+    deleteNode(parentID, connectionKeys, pathToConnection, store, deleteIDs);
+  };
+}
+
+function deleteNode(parentID, connectionKeys, pathToConnection, store, deleteIDs) {
+  require('fbjs/lib/warning')(connectionKeys, 'RelayDeclarativeMutationConfig: RANGE_DELETE must provide a ' + 'connectionKeys');
+  var parent = store.get(parentID);
+  if (!parent) {
+    return;
+  }
+  if (pathToConnection.length < 2) {
+    require('fbjs/lib/warning')(false, 'RelayDeclarativeMutationConfig: RANGE_DELETE ' + 'pathToConnection must include at least parent and connection');
+    return;
+  }
+  var recordProxy = parent;
+  for (var i = 1; i < pathToConnection.length - 1; i++) {
+    if (recordProxy) {
+      recordProxy = recordProxy.getLinkedRecord(pathToConnection[i]);
+    }
+  }
+  // Should never enter loop except edge cases
+  if (!connectionKeys || !recordProxy) {
+    require('fbjs/lib/warning')(false, 'RelayDeclarativeMutationConfig: RANGE_DELETE ' + 'pathToConnection is incorrect. Unable to find connection with ' + 'parentID: %s and path: %s', parentID, pathToConnection.toString());
+    return;
+  }
+  var _iteratorNormalCompletion3 = true;
+  var _didIteratorError3 = false;
+  var _iteratorError3 = undefined;
+
+  try {
+    var _loop = function _loop() {
+      var key = _step3.value;
+
+      var connection = require('./RelayConnectionHandler').getConnection(recordProxy, key.key, key.filters);
+      if (connection) {
+        deleteIDs.forEach(function (deleteID) {
+          require('./RelayConnectionHandler').deleteNode(connection, deleteID);
+        });
+      }
+    };
+
+    for (var _iterator3 = connectionKeys[Symbol.iterator](), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true) {
+      _loop();
+    }
+  } catch (err) {
+    _didIteratorError3 = true;
+    _iteratorError3 = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion3 && _iterator3['return']) {
+        _iterator3['return']();
+      }
+    } finally {
+      if (_didIteratorError3) {
+        throw _iteratorError3;
+      }
+    }
+  }
+}
+
+function getRootField(request) {
+  if (request.fragment.selections && request.fragment.selections.length > 0 && request.fragment.selections[0].kind === 'LinkedField') {
+    return request.fragment.selections[0].name;
+  }
+  return null;
+}
+
+module.exports = {
+  MutationTypes: MutationTypes,
+  RangeOperations: RangeOperations,
+
+  convert: convert
+};

package/lib/RelayDefaultHandleKey.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayDefaultHandleKey
  * 

package/lib/RelayDefaultHandlerProvider.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayDefaultHandlerProvider
  *