relay-runtime 7.0.0 → 9.1.0

package/lib/index.js

@@ -7,17 +7,18 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
-var RelayConcreteNode = require('./util/RelayConcreteNode');
+var ConnectionHandler = require('./handlers/connection/ConnectionHandler');
 
-var RelayConcreteVariables = require('./store/RelayConcreteVariables');
+var ConnectionInterface = require('./handlers/connection/ConnectionInterface');
 
-var RelayConnectionHandler = require('./handlers/connection/RelayConnectionHandler');
+var GraphQLTag = require('./query/GraphQLTag');
 
-var RelayConnectionInterface = require('./handlers/connection/RelayConnectionInterface');
+var RelayConcreteNode = require('./util/RelayConcreteNode');
 
-var RelayConnectionResolver = require('./store/RelayConnectionResolver');
+var RelayConcreteVariables = require('./store/RelayConcreteVariables');
 
 var RelayDeclarativeMutationConfig = require('./mutations/RelayDeclarativeMutationConfig');
 
@@ -25,16 +26,12 @@ var RelayDefaultHandleKey = require('./util/RelayDefaultHandleKey');
 
 var RelayDefaultHandlerProvider = require('./handlers/RelayDefaultHandlerProvider');
 
-var RelayDefaultMissingFieldHandlers = require('./handlers/RelayDefaultMissingFieldHandlers');
-
 var RelayError = require('./util/RelayError');
 
 var RelayFeatureFlags = require('./util/RelayFeatureFlags');
 
 var RelayModernEnvironment = require('./store/RelayModernEnvironment');
 
-var RelayModernGraphQLTag = require('./query/RelayModernGraphQLTag');
-
 var RelayModernOperationDescriptor = require('./store/RelayModernOperationDescriptor');
 
 var RelayModernRecord = require('./store/RelayModernRecord');
@@ -55,6 +52,8 @@ var RelayQueryResponseCache = require('./network/RelayQueryResponseCache');
 
 var RelayRecordSource = require('./store/RelayRecordSource');
 
+var RelayReplaySubject = require('./util/RelayReplaySubject');
+
 var RelayStoreUtils = require('./store/RelayStoreUtils');
 
 var ViewerPattern = require('./store/ViewerPattern');
@@ -67,6 +66,8 @@ var commitMutation = require('./mutations/commitMutation');
 
 var createFragmentSpecResolver = require('./store/createFragmentSpecResolver');
 
+var createPayloadFor3DField = require('./util/createPayloadFor3DField');
+
 var createRelayContext = require('./store/createRelayContext');
 
 var deepFreeze = require('./util/deepFreeze');
@@ -77,10 +78,10 @@ var fetchQueryInternal = require('./query/fetchQueryInternal');
 
 var getFragmentIdentifier = require('./util/getFragmentIdentifier');
 
-var getFragmentSpecIdentifier = require('./util/getFragmentSpecIdentifier');
-
 var getRelayHandleKey = require('./util/getRelayHandleKey');
 
+var getRequestIdentifier = require('./util/getRequestIdentifier');
+
 var isPromise = require('./util/isPromise');
 
 var isRelayModernEnvironment = require('./store/isRelayModernEnvironment');
@@ -97,7 +98,8 @@ var stableCopy = require('./util/stableCopy');
 
 var _require = require('./store/ClientID'),
     generateClientID = _require.generateClientID,
-    generateUniqueClientID = _require.generateUniqueClientID;
+    generateUniqueClientID = _require.generateUniqueClientID,
+    isClientID = _require.isClientID;
 
 // As early as possible, check for the existence of the JavaScript globals which
 // Relay Runtime relies upon, and produce a clear message if they do not exist.
@@ -124,6 +126,7 @@ module.exports = {
   QueryResponseCache: RelayQueryResponseCache,
   RecordSource: RelayRecordSource,
   Record: RelayModernRecord,
+  ReplaySubject: RelayReplaySubject,
   Store: RelayModernStore,
   areEqualSelectors: RelayModernSelector.areEqualSelectors,
   createFragmentSpecResolver: createFragmentSpecResolver,
@@ -133,14 +136,15 @@ module.exports = {
   createRequestDescriptor: RelayModernOperationDescriptor.createRequestDescriptor,
   getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
   getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
-  getFragment: RelayModernGraphQLTag.getFragment,
-  getInlineDataFragment: RelayModernGraphQLTag.getInlineDataFragment,
+  getFragment: GraphQLTag.getFragment,
+  getInlineDataFragment: GraphQLTag.getInlineDataFragment,
   getModuleComponentKey: RelayStoreUtils.getModuleComponentKey,
   getModuleOperationKey: RelayStoreUtils.getModuleOperationKey,
-  getPaginationFragment: RelayModernGraphQLTag.getPaginationFragment,
+  getPaginationFragment: GraphQLTag.getPaginationFragment,
   getPluralSelector: RelayModernSelector.getPluralSelector,
-  getRefetchableFragment: RelayModernGraphQLTag.getRefetchableFragment,
-  getRequest: RelayModernGraphQLTag.getRequest,
+  getRefetchableFragment: GraphQLTag.getRefetchableFragment,
+  getRequest: GraphQLTag.getRequest,
+  getRequestIdentifier: getRequestIdentifier,
   getSelector: RelayModernSelector.getSelector,
   getSelectorsFromObject: RelayModernSelector.getSelectorsFromObject,
   getSingularSelector: RelayModernSelector.getSingularSelector,
@@ -149,16 +153,14 @@ module.exports = {
   getVariablesFromObject: RelayModernSelector.getVariablesFromObject,
   getVariablesFromPluralFragment: RelayModernSelector.getVariablesFromPluralFragment,
   getVariablesFromSingularFragment: RelayModernSelector.getVariablesFromSingularFragment,
-  graphql: RelayModernGraphQLTag.graphql,
+  graphql: GraphQLTag.graphql,
   readInlineData: readInlineData,
   // Declarative mutation API
   MutationTypes: RelayDeclarativeMutationConfig.MutationTypes,
   RangeOperations: RelayDeclarativeMutationConfig.RangeOperations,
   // Extensions
   DefaultHandlerProvider: RelayDefaultHandlerProvider,
-  DefaultMissingFieldHandlers: RelayDefaultMissingFieldHandlers,
-  ConnectionHandler: RelayConnectionHandler,
-  ConnectionResolver_UNSTABLE: RelayConnectionResolver,
+  ConnectionHandler: ConnectionHandler,
   VIEWER_ID: ViewerPattern.VIEWER_ID,
   VIEWER_TYPE: ViewerPattern.VIEWER_TYPE,
   // Helpers (can be implemented via the above API)
@@ -169,9 +171,10 @@ module.exports = {
   isRelayModernEnvironment: isRelayModernEnvironment,
   requestSubscription: requestSubscription,
   // Configuration interface for legacy or special uses
-  ConnectionInterface: RelayConnectionInterface,
+  ConnectionInterface: ConnectionInterface,
   // Utilities
   RelayProfiler: RelayProfiler,
+  createPayloadFor3DField: createPayloadFor3DField,
   // INTERNAL-ONLY: These exports might be removed at any point.
   RelayConcreteNode: RelayConcreteNode,
   RelayError: RelayError,
@@ -189,20 +192,19 @@ module.exports = {
   generateClientID: generateClientID,
   generateUniqueClientID: generateUniqueClientID,
   getRelayHandleKey: getRelayHandleKey,
+  isClientID: isClientID,
   isPromise: isPromise,
   isScalarAndEqual: isScalarAndEqual,
   recycleNodesInto: recycleNodesInto,
   stableCopy: stableCopy,
   getFragmentIdentifier: getFragmentIdentifier,
-  getFragmentSpecIdentifier: getFragmentSpecIdentifier,
   __internal: {
     OperationTracker: RelayOperationTracker,
     createRelayContext: createRelayContext,
-    getModernOperationVariables: RelayConcreteVariables.getOperationVariables,
+    getOperationVariables: RelayConcreteVariables.getOperationVariables,
     fetchQuery: fetchQueryInternal.fetchQuery,
     fetchQueryDeduped: fetchQueryInternal.fetchQueryDeduped,
-    getPromiseForRequestInFlight: fetchQueryInternal.getPromiseForRequestInFlight,
-    getObservableForRequestInFlight: fetchQueryInternal.getObservableForRequestInFlight,
-    hasRequestInFlight: fetchQueryInternal.hasRequestInFlight
+    getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
+    getObservableForActiveRequest: fetchQueryInternal.getObservableForActiveRequest
   }
 };

package/lib/mutations/RelayDeclarativeMutationConfig.js

@@ -7,9 +7,16 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
-var RelayConnectionHandler = require('../handlers/connection/RelayConnectionHandler');
+function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+var ConnectionHandler = require('../handlers/connection/ConnectionHandler');
 
 var warning = require("fbjs/lib/warning");
 
@@ -128,25 +135,25 @@ function rangeAdd(config, request) {
     }
 
     var serverEdge = payload.getLinkedRecord(edgeName);
-    var _iteratorNormalCompletion = true;
-    var _didIteratorError = false;
-    var _iteratorError = undefined;
+
+    var _iterator = _createForOfIteratorHelper(connectionInfo),
+        _step;
 
     try {
-      for (var _iterator = connectionInfo[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
         var info = _step.value;
 
         if (!serverEdge) {
           continue;
         }
 
-        var connection = RelayConnectionHandler.getConnection(parent, info.key, info.filters);
+        var connection = ConnectionHandler.getConnection(parent, info.key, info.filters);
 
         if (!connection) {
           continue;
         }
 
-        var clientEdge = RelayConnectionHandler.buildConnectionEdge(store, connection, serverEdge);
+        var clientEdge = ConnectionHandler.buildConnectionEdge(store, connection, serverEdge);
 
         if (!clientEdge) {
           continue;
@@ -154,11 +161,11 @@ function rangeAdd(config, request) {
 
         switch (info.rangeBehavior) {
           case 'append':
-            RelayConnectionHandler.insertEdgeAfter(connection, clientEdge);
+            ConnectionHandler.insertEdgeAfter(connection, clientEdge);
             break;
 
           case 'prepend':
-            RelayConnectionHandler.insertEdgeBefore(connection, clientEdge);
+            ConnectionHandler.insertEdgeBefore(connection, clientEdge);
             break;
 
           default:
@@ -167,18 +174,9 @@ function rangeAdd(config, request) {
         }
       }
     } catch (err) {
-      _didIteratorError = true;
-      _iteratorError = err;
+      _iterator.e(err);
     } finally {
-      try {
-        if (!_iteratorNormalCompletion && _iterator["return"] != null) {
-          _iterator["return"]();
-        }
-      } finally {
-        if (_didIteratorError) {
-          throw _iteratorError;
-        }
-      }
+      _iterator.f();
     }
   };
 }
@@ -209,12 +207,11 @@ function rangeDelete(config, request) {
     var deletedIDField = data[rootField];
 
     if (deletedIDField && Array.isArray(deletedIDFieldName)) {
-      var _iteratorNormalCompletion2 = true;
-      var _didIteratorError2 = false;
-      var _iteratorError2 = undefined;
+      var _iterator2 = _createForOfIteratorHelper(deletedIDFieldName),
+          _step2;
 
       try {
-        for (var _iterator2 = deletedIDFieldName[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
           var eachField = _step2.value;
 
           if (deletedIDField && typeof deletedIDField === 'object') {
@@ -222,18 +219,9 @@ function rangeDelete(config, request) {
           }
         }
       } catch (err) {
-        _didIteratorError2 = true;
-        _iteratorError2 = err;
+        _iterator2.e(err);
       } finally {
-        try {
-          if (!_iteratorNormalCompletion2 && _iterator2["return"] != null) {
-            _iterator2["return"]();
-          }
-        } finally {
-          if (_didIteratorError2) {
-            throw _iteratorError2;
-          }
-        }
+        _iterator2.f();
       }
 
       if (Array.isArray(deletedIDField)) {
@@ -290,38 +278,28 @@ function deleteNode(parentID, connectionKeys, pathToConnection, store, deleteIDs
     return;
   }
 
-  var _iteratorNormalCompletion3 = true;
-  var _didIteratorError3 = false;
-  var _iteratorError3 = undefined;
+  var _iterator3 = _createForOfIteratorHelper(connectionKeys),
+      _step3;
 
   try {
     var _loop = function _loop() {
       var key = _step3.value;
-      var connection = RelayConnectionHandler.getConnection(recordProxy, key.key, key.filters);
+      var connection = ConnectionHandler.getConnection(recordProxy, key.key, key.filters);
 
       if (connection) {
         deleteIDs.forEach(function (deleteID) {
-          RelayConnectionHandler.deleteNode(connection, deleteID);
+          ConnectionHandler.deleteNode(connection, deleteID);
         });
       }
     };
 
-    for (var _iterator3 = connectionKeys[Symbol.iterator](), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true) {
+    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
       _loop();
     }
   } catch (err) {
-    _didIteratorError3 = true;
-    _iteratorError3 = err;
+    _iterator3.e(err);
   } finally {
-    try {
-      if (!_iteratorNormalCompletion3 && _iterator3["return"] != null) {
-        _iterator3["return"]();
-      }
-    } finally {
-      if (_didIteratorError3) {
-        throw _iteratorError3;
-      }
-    }
+    _iterator3.f();
   }
 }
 

package/lib/mutations/RelayRecordProxy.js

@@ -7,6 +7,7 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 var invariant = require("fbjs/lib/invariant");
@@ -23,9 +24,7 @@ var _require2 = require('../store/RelayStoreUtils'),
  * A helper class for manipulating a given record from a record source via an
  * imperative/OO-style API.
  */
-var RelayRecordProxy =
-/*#__PURE__*/
-function () {
+var RelayRecordProxy = /*#__PURE__*/function () {
   function RelayRecordProxy(source, mutator, dataID) {
     this._dataID = dataID;
     this._mutator = mutator;
@@ -126,6 +125,10 @@ function () {
     return this;
   };
 
+  _proto.invalidateRecord = function invalidateRecord() {
+    this._source.markIDForInvalidation(this._dataID);
+  };
+
   return RelayRecordProxy;
 }();
 

package/lib/mutations/RelayRecordSourceMutator.js

@@ -7,6 +7,7 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 var RelayModernRecord = require('../store/RelayModernRecord');
@@ -28,13 +29,10 @@ var _require = require('../store/RelayRecordState'),
  * - Modifications cause a fresh version of a record to be created in `sink`.
  *   These sink records contain only modified fields.
  */
-var RelayRecordSourceMutator =
-/*#__PURE__*/
-function () {
-  function RelayRecordSourceMutator(base, sink, connectionEvents) {
+var RelayRecordSourceMutator = /*#__PURE__*/function () {
+  function RelayRecordSourceMutator(base, sink) {
     this.__sources = [sink, base];
     this._base = base;
-    this._connectionEvents = connectionEvents;
     this._sink = sink;
   }
   /**
@@ -222,10 +220,6 @@ function () {
     RelayModernRecord.setLinkedRecordIDs(sinkRecord, storageKey, linkedIDs);
   };
 
-  _proto.appendConnectionEvent_UNSTABLE = function appendConnectionEvent_UNSTABLE(event) {
-    this._connectionEvents.push(event);
-  };
-
   return RelayRecordSourceMutator;
 }();
 

package/lib/mutations/RelayRecordSourceProxy.js

@@ -7,18 +7,15 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 var RelayModernRecord = require('../store/RelayModernRecord');
 
 var RelayRecordProxy = require('./RelayRecordProxy');
 
-var RelayRecordSourceSelectorProxy = require('./RelayRecordSourceSelectorProxy');
-
 var invariant = require("fbjs/lib/invariant");
 
-var normalizeRelayPayload = require('../store/normalizeRelayPayload');
-
 var _require = require('../store/RelayRecordState'),
     EXISTENT = _require.EXISTENT,
     NONEXISTENT = _require.NONEXISTENT;
@@ -32,14 +29,14 @@ var _require2 = require('../store/RelayStoreUtils'),
  *
  * A helper for manipulating a `RecordSource` via an imperative/OO-style API.
  */
-var RelayRecordSourceProxy =
-/*#__PURE__*/
-function () {
+var RelayRecordSourceProxy = /*#__PURE__*/function () {
   function RelayRecordSourceProxy(mutator, getDataID, handlerProvider) {
     this.__mutator = mutator;
     this._handlerProvider = handlerProvider || null;
     this._proxies = {};
     this._getDataID = getDataID;
+    this._invalidatedStore = false;
+    this._idsMarkedForInvalidation = new Set();
   }
 
   var _proto = RelayRecordSourceProxy.prototype;
@@ -76,22 +73,6 @@ function () {
     }
   };
 
-  _proto.commitPayload = function commitPayload(operation, response) {
-    if (!response) {
-      return new RelayRecordSourceSelectorProxy(this.__mutator, this, operation.fragment);
-    }
-
-    var _normalizeRelayPayloa = normalizeRelayPayload(operation.root, response, null, {
-      getDataID: this._getDataID,
-      request: operation.request
-    }),
-        source = _normalizeRelayPayloa.source,
-        fieldPayloads = _normalizeRelayPayloa.fieldPayloads;
-
-    this.publishSource(source, fieldPayloads);
-    return new RelayRecordSourceSelectorProxy(this.__mutator, this, operation.fragment);
-  };
-
   _proto.create = function create(dataID, typeName) {
     this.__mutator.create(dataID, typeName);
 
@@ -130,10 +111,26 @@ function () {
       root = this.create(ROOT_ID, ROOT_TYPE);
     }
 
-    !(root && root.getType() === ROOT_TYPE) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayRecordSourceProxy#getRoot(): Expected the source to contain a ' + 'root record.') : invariant(false) : void 0;
+    !(root && root.getType() === ROOT_TYPE) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayRecordSourceProxy#getRoot(): Expected the source to contain a ' + 'root record, %s.', root == null ? 'no root record found' : "found a root record of type `".concat(root.getType(), "`")) : invariant(false) : void 0;
     return root;
   };
 
+  _proto.invalidateStore = function invalidateStore() {
+    this._invalidatedStore = true;
+  };
+
+  _proto.isStoreMarkedForInvalidation = function isStoreMarkedForInvalidation() {
+    return this._invalidatedStore;
+  };
+
+  _proto.markIDForInvalidation = function markIDForInvalidation(dataID) {
+    this._idsMarkedForInvalidation.add(dataID);
+  };
+
+  _proto.getIDsMarkedForInvalidation = function getIDsMarkedForInvalidation() {
+    return this._idsMarkedForInvalidation;
+  };
+
   return RelayRecordSourceProxy;
 }();
 

package/lib/mutations/RelayRecordSourceSelectorProxy.js

@@ -7,12 +7,14 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 var invariant = require("fbjs/lib/invariant");
 
 var _require = require('../store/RelayStoreUtils'),
-    getStorageKey = _require.getStorageKey;
+    getStorageKey = _require.getStorageKey,
+    ROOT_TYPE = _require.ROOT_TYPE;
 
 /**
  * @internal
@@ -22,9 +24,7 @@ var _require = require('../store/RelayStoreUtils'),
  * complex arguments and it can be tedious to re-construct the correct sets of
  * arguments to pass to e.g. `getRoot().getLinkedRecord()`.
  */
-var RelayRecordSourceSelectorProxy =
-/*#__PURE__*/
-function () {
+var RelayRecordSourceSelectorProxy = /*#__PURE__*/function () {
   function RelayRecordSourceSelectorProxy(mutator, recordSource, readSelector) {
     this.__mutator = mutator;
     this.__recordSource = recordSource;
@@ -49,6 +49,16 @@ function () {
     return this.__recordSource.getRoot();
   };
 
+  _proto.getOperationRoot = function getOperationRoot() {
+    var root = this.__recordSource.get(this._readSelector.dataID);
+
+    if (!root) {
+      root = this.__recordSource.create(this._readSelector.dataID, ROOT_TYPE);
+    }
+
+    return root;
+  };
+
   _proto._getRootField = function _getRootField(selector, fieldName, plural) {
     var field = selector.node.selections.find(function (selection) {
       return selection.kind === 'LinkedField' && selection.name === fieldName;
@@ -62,24 +72,18 @@ function () {
     var field = this._getRootField(this._readSelector, fieldName, false);
 
     var storageKey = getStorageKey(field, this._readSelector.variables);
-    return this.getRoot().getLinkedRecord(storageKey);
+    return this.getOperationRoot().getLinkedRecord(storageKey);
   };
 
   _proto.getPluralRootField = function getPluralRootField(fieldName) {
     var field = this._getRootField(this._readSelector, fieldName, true);
 
     var storageKey = getStorageKey(field, this._readSelector.variables);
-    return this.getRoot().getLinkedRecords(storageKey);
+    return this.getOperationRoot().getLinkedRecords(storageKey);
   };
 
-  _proto.insertConnectionEdge_UNSTABLE = function insertConnectionEdge_UNSTABLE(connectionID, args, edge) {
-    this.__mutator.appendConnectionEvent_UNSTABLE({
-      kind: 'insert',
-      args: args,
-      connectionID: connectionID,
-      edgeID: edge.getDataID(),
-      request: this._readSelector.owner
-    });
+  _proto.invalidateStore = function invalidateStore() {
+    this.__recordSource.invalidateStore();
   };
 
   return RelayRecordSourceSelectorProxy;

package/lib/mutations/applyOptimisticMutation.js

@@ -7,6 +7,7 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 var RelayDeclarativeMutationConfig = require('./RelayDeclarativeMutationConfig');
@@ -15,7 +16,7 @@ var invariant = require("fbjs/lib/invariant");
 
 var isRelayModernEnvironment = require('../store/isRelayModernEnvironment');
 
-var _require = require('../query/RelayModernGraphQLTag'),
+var _require = require('../query/GraphQLTag'),
     getRequest = _require.getRequest;
 
 var _require2 = require('../store/RelayModernOperationDescriptor'),

package/lib/mutations/commitLocalUpdate.js

@@ -7,6 +7,7 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 function commitLocalUpdate(environment, updater) {

package/lib/mutations/commitMutation.js

@@ -7,6 +7,7 @@
  * 
  * @format
  */
+// flowlint ambiguous-object-type:error
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
@@ -15,6 +16,8 @@ var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers
 
 var RelayDeclarativeMutationConfig = require('./RelayDeclarativeMutationConfig');
 
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
+
 var invariant = require("fbjs/lib/invariant");
 
 var isRelayModernEnvironment = require('../store/isRelayModernEnvironment');
@@ -23,11 +26,14 @@ var validateMutation = require('./validateMutation');
 
 var warning = require("fbjs/lib/warning");
 
-var _require = require('../query/RelayModernGraphQLTag'),
+var _require = require('../query/GraphQLTag'),
     getRequest = _require.getRequest;
 
-var _require2 = require('../store/RelayModernOperationDescriptor'),
-    createOperationDescriptor = _require2.createOperationDescriptor;
+var _require2 = require('../store/ClientID'),
+    generateUniqueClientID = _require2.generateUniqueClientID;
+
+var _require3 = require('../store/RelayModernOperationDescriptor'),
+    createOperationDescriptor = _require3.createOperationDescriptor;
 
 /**
  * Higher-level helper function to execute a mutation against a specific
@@ -49,10 +55,12 @@ function commitMutation(environment, config) {
       optimisticUpdater = config.optimisticUpdater,
       updater = config.updater;
   var configs = config.configs,
+      cacheConfig = config.cacheConfig,
       onError = config.onError,
+      onUnsubscribe = config.onUnsubscribe,
       variables = config.variables,
       uploadables = config.uploadables;
-  var operation = createOperationDescriptor(mutation, variables); // TODO: remove this check after we fix flow.
+  var operation = createOperationDescriptor(mutation, variables, RelayFeatureFlags.ENABLE_UNIQUE_MUTATION_ROOT ? generateUniqueClientID() : undefined); // TODO: remove this check after we fix flow.
 
   if (typeof optimisticResponse === 'function') {
     optimisticResponse = optimisticResponse();
@@ -61,7 +69,7 @@ function commitMutation(environment, config) {
 
   if (process.env.NODE_ENV !== "production") {
     if (optimisticResponse instanceof Object) {
-      validateMutation(optimisticResponse, mutation, config.variables);
+      validateMutation(optimisticResponse, mutation, variables);
     }
   }
 
@@ -74,6 +82,7 @@ function commitMutation(environment, config) {
 
   var errors = [];
   var subscription = environment.executeMutation({
+    cacheConfig: cacheConfig,
     operation: operation,
     optimisticResponse: optimisticResponse,
     optimisticUpdater: optimisticUpdater,
@@ -81,8 +90,16 @@ function commitMutation(environment, config) {
     uploadables: uploadables
   }).subscribe({
     next: function next(payload) {
-      if (payload.errors) {
-        errors.push.apply(errors, (0, _toConsumableArray2["default"])(payload.errors));
+      if (Array.isArray(payload)) {
+        payload.forEach(function (item) {
+          if (item.errors) {
+            errors.push.apply(errors, (0, _toConsumableArray2["default"])(item.errors));
+          }
+        });
+      } else {
+        if (payload.errors) {
+          errors.push.apply(errors, (0, _toConsumableArray2["default"])(payload.errors));
+        }
       }
     },
     complete: function complete() {
@@ -93,7 +110,8 @@ function commitMutation(environment, config) {
         onCompleted(snapshot.data, errors.length !== 0 ? errors : null);
       }
     },
-    error: onError
+    error: onError,
+    unsubscribe: onUnsubscribe
   });
   return {
     dispose: subscription.unsubscribe