relay-runtime 12.0.0 → 13.0.0

package/lib/store/RelayModernEnvironment.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -15,33 +15,33 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 
-var OperationExecutor = require('./OperationExecutor');
-
 var RelayDefaultHandlerProvider = require('../handlers/RelayDefaultHandlerProvider');
 
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
+var _require = require('../multi-actor-environment/ActorIdentifier'),
+    INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE = _require.INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
+    assertInternalActorIndentifier = _require.assertInternalActorIndentifier;
 
 var RelayObservable = require('../network/RelayObservable');
 
+var wrapNetworkWithLogObserver = require('../network/wrapNetworkWithLogObserver');
+
 var RelayOperationTracker = require('../store/RelayOperationTracker');
 
-var RelayPublishQueue = require('./RelayPublishQueue');
+var registerEnvironmentWithDevTools = require('../util/registerEnvironmentWithDevTools');
 
-var RelayRecordSource = require('./RelayRecordSource');
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
 var defaultGetDataID = require('./defaultGetDataID');
 
 var defaultRequiredFieldLogger = require('./defaultRequiredFieldLogger');
 
-var invariant = require('invariant');
+var OperationExecutor = require('./OperationExecutor');
 
-var registerEnvironmentWithDevTools = require('../util/registerEnvironmentWithDevTools');
+var RelayPublishQueue = require('./RelayPublishQueue');
 
-var wrapNetworkWithLogObserver = require('../network/wrapNetworkWithLogObserver');
+var RelayRecordSource = require('./RelayRecordSource');
 
-var _require = require('../multi-actor-environment/ActorIdentifier'),
-    INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE = _require.INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
-    assertInternalActorIndentifier = _require.assertInternalActorIndentifier;
+var invariant = require('invariant');
 
 var RelayModernEnvironment = /*#__PURE__*/function () {
   function RelayModernEnvironment(config) {
@@ -277,7 +277,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
   }
   /**
    * Returns an Observable of GraphQLResponse resulting from executing the
-   * provided Query or Subscription operation, each result of which is then
+   * provided Query operation, each result of which is then
    * normalized and committed to the publish queue.
    *
    * Note: Observables are lazy, so calling this method will do nothing until
@@ -288,8 +288,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
   _proto.execute = function execute(_ref) {
     var _this7 = this;
 
-    var operation = _ref.operation,
-        updater = _ref.updater;
+    var operation = _ref.operation;
     return this._execute({
       createSource: function createSource() {
         return _this7._network.execute(operation.request.node.params, operation.request.variables, operation.request.cacheConfig || {}, null);
@@ -297,6 +296,31 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
       isClientPayload: false,
       operation: operation,
       optimisticConfig: null,
+      updater: null
+    });
+  }
+  /**
+   * Returns an Observable of GraphQLResponse resulting from executing the
+   * provided Subscription operation, each result of which is then
+   * normalized and committed to the publish queue.
+   *
+   * Note: Observables are lazy, so calling this method will do nothing until
+   * the result is subscribed to: environment.execute({...}).subscribe({...}).
+   */
+  ;
+
+  _proto.executeSubscription = function executeSubscription(_ref2) {
+    var _this8 = this;
+
+    var operation = _ref2.operation,
+        updater = _ref2.updater;
+    return this._execute({
+      createSource: function createSource() {
+        return _this8._network.execute(operation.request.node.params, operation.request.variables, operation.request.cacheConfig || {}, null);
+      },
+      isClientPayload: false,
+      operation: operation,
+      optimisticConfig: null,
       updater: updater
     });
   }
@@ -312,14 +336,14 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
    */
   ;
 
-  _proto.executeMutation = function executeMutation(_ref2) {
-    var _this8 = this;
+  _proto.executeMutation = function executeMutation(_ref3) {
+    var _this9 = this;
 
-    var operation = _ref2.operation,
-        optimisticResponse = _ref2.optimisticResponse,
-        optimisticUpdater = _ref2.optimisticUpdater,
-        updater = _ref2.updater,
-        uploadables = _ref2.uploadables;
+    var operation = _ref3.operation,
+        optimisticResponse = _ref3.optimisticResponse,
+        optimisticUpdater = _ref3.optimisticUpdater,
+        updater = _ref3.updater,
+        uploadables = _ref3.uploadables;
     var optimisticConfig;
 
     if (optimisticResponse || optimisticUpdater) {
@@ -332,7 +356,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
 
     return this._execute({
       createSource: function createSource() {
-        return _this8._network.execute(operation.request.node.params, operation.request.variables, (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, operation.request.cacheConfig), {}, {
+        return _this9._network.execute(operation.request.node.params, operation.request.variables, (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, operation.request.cacheConfig), {}, {
           force: true
         }), uploadables);
       },
@@ -353,9 +377,9 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
    */
   ;
 
-  _proto.executeWithSource = function executeWithSource(_ref3) {
-    var operation = _ref3.operation,
-        source = _ref3.source;
+  _proto.executeWithSource = function executeWithSource(_ref4) {
+    var operation = _ref4.operation,
+        source = _ref4.source;
     return this._execute({
       createSource: function createSource() {
         return source;
@@ -373,35 +397,35 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
     return "RelayModernEnvironment(".concat((_this$configName = this.configName) !== null && _this$configName !== void 0 ? _this$configName : '', ")");
   };
 
-  _proto._execute = function _execute(_ref4) {
-    var _this9 = this;
+  _proto._execute = function _execute(_ref5) {
+    var _this10 = this;
 
-    var createSource = _ref4.createSource,
-        isClientPayload = _ref4.isClientPayload,
-        operation = _ref4.operation,
-        optimisticConfig = _ref4.optimisticConfig,
-        updater = _ref4.updater;
+    var createSource = _ref5.createSource,
+        isClientPayload = _ref5.isClientPayload,
+        operation = _ref5.operation,
+        optimisticConfig = _ref5.optimisticConfig,
+        updater = _ref5.updater;
     var publishQueue = this._publishQueue;
     var store = this._store;
     return RelayObservable.create(function (sink) {
       var executor = OperationExecutor.execute({
         actorIdentifier: INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
-        getDataID: _this9._getDataID,
+        getDataID: _this10._getDataID,
         isClientPayload: isClientPayload,
-        log: _this9.__log,
+        log: _this10.__log,
         operation: operation,
-        operationExecutions: _this9._operationExecutions,
-        operationLoader: _this9._operationLoader,
-        operationTracker: _this9._operationTracker,
+        operationExecutions: _this10._operationExecutions,
+        operationLoader: _this10._operationLoader,
+        operationTracker: _this10._operationTracker,
         optimisticConfig: optimisticConfig,
         getPublishQueue: function getPublishQueue(actorIdentifier) {
           assertInternalActorIndentifier(actorIdentifier);
           return publishQueue;
         },
-        reactFlightPayloadDeserializer: _this9._reactFlightPayloadDeserializer,
-        reactFlightServerErrorHandler: _this9._reactFlightServerErrorHandler,
-        scheduler: _this9._scheduler,
-        shouldProcessClientComponents: _this9._shouldProcessClientComponents,
+        reactFlightPayloadDeserializer: _this10._reactFlightPayloadDeserializer,
+        reactFlightServerErrorHandler: _this10._reactFlightServerErrorHandler,
+        scheduler: _this10._scheduler,
+        shouldProcessClientComponents: _this10._shouldProcessClientComponents,
         sink: sink,
         // NOTE: Some product tests expect `Network.execute` to be called only
         //       when the Observable is executed.
@@ -410,7 +434,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
           assertInternalActorIndentifier(actorIdentifier);
           return store;
         },
-        treatMissingFieldsAsNull: _this9._treatMissingFieldsAsNull,
+        treatMissingFieldsAsNull: _this10._treatMissingFieldsAsNull,
         updater: updater
       });
       return function () {

package/lib/store/RelayModernFragmentSpecResolver.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -16,21 +16,15 @@ var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/obje
 
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
-
-var areEqual = require("fbjs/lib/areEqual");
-
 var getPendingOperationsForFragment = require('../util/getPendingOperationsForFragment');
 
-var invariant = require('invariant');
-
 var isScalarAndEqual = require('../util/isScalarAndEqual');
 
 var recycleNodesInto = require('../util/recycleNodesInto');
 
-var reportMissingRequiredFields = require('../util/reportMissingRequiredFields');
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
-var warning = require("fbjs/lib/warning");
+var reportMissingRequiredFields = require('../util/reportMissingRequiredFields');
 
 var _require = require('./RelayModernOperationDescriptor'),
     createRequestDescriptor = _require.createRequestDescriptor;
@@ -40,6 +34,12 @@ var _require2 = require('./RelayModernSelector'),
     createReaderSelector = _require2.createReaderSelector,
     getSelectorsFromObject = _require2.getSelectorsFromObject;
 
+var areEqual = require("fbjs/lib/areEqual");
+
+var invariant = require('invariant');
+
+var warning = require("fbjs/lib/warning");
+
 /**
  * A utility for resolving and subscribing to the results of a fragment spec
  * (key -> fragment mapping) given some "props" that determine the root ID

package/lib/store/RelayModernOperationDescriptor.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -23,13 +23,14 @@ var _require2 = require('./RelayModernSelector'),
 
 var _require3 = require('./RelayStoreUtils'),
     ROOT_ID = _require3.ROOT_ID;
-
 /**
  * Creates an instance of the `OperationDescriptor` type defined in
  * `RelayStoreTypes` given an operation and some variables. The input variables
  * are filtered to exclude variables that do not match defined arguments on the
  * operation, and default values are populated for null values.
  */
+
+
 function createOperationDescriptor(request, variables, cacheConfig) {
   var dataID = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : ROOT_ID;
   var operation = request.operation;

package/lib/store/RelayModernRecord.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -14,26 +14,25 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 
-var areEqual = require("fbjs/lib/areEqual");
-
 var deepFreeze = require('../util/deepFreeze');
 
-var invariant = require('invariant');
-
-var warning = require("fbjs/lib/warning");
-
 var _require = require('./ClientID'),
     isClientID = _require.isClientID;
 
 var _require2 = require('./RelayStoreUtils'),
     ACTOR_IDENTIFIER_KEY = _require2.ACTOR_IDENTIFIER_KEY,
     ID_KEY = _require2.ID_KEY,
+    INVALIDATED_AT_KEY = _require2.INVALIDATED_AT_KEY,
     REF_KEY = _require2.REF_KEY,
     REFS_KEY = _require2.REFS_KEY,
-    TYPENAME_KEY = _require2.TYPENAME_KEY,
-    INVALIDATED_AT_KEY = _require2.INVALIDATED_AT_KEY,
-    ROOT_ID = _require2.ROOT_ID;
+    ROOT_ID = _require2.ROOT_ID,
+    TYPENAME_KEY = _require2.TYPENAME_KEY;
 
+var areEqual = require("fbjs/lib/areEqual");
+
+var invariant = require('invariant');
+
+var warning = require("fbjs/lib/warning");
 /**
  * @public
  *
@@ -83,6 +82,8 @@ var _require2 = require('./RelayStoreUtils'),
  *
  * Clone a record.
  */
+
+
 function clone(record) {
   return (0, _objectSpread2["default"])({}, record);
 }
@@ -172,7 +173,7 @@ function getLinkedRecordID(record, storageKey) {
     return link;
   }
 
-  !(typeof link === 'object' && link && typeof link[REF_KEY] === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernRecord.getLinkedRecordID(): Expected `%s.%s` to be a linked ID, ' + 'was `%s`.', record[ID_KEY], storageKey, JSON.stringify(link)) : invariant(false) : void 0;
+  !(typeof link === 'object' && link && typeof link[REF_KEY] === 'string') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernRecord.getLinkedRecordID(): Expected `%s.%s` to be a linked ID, ' + 'was `%s`.%s', record[ID_KEY], storageKey, JSON.stringify(link), typeof link === 'object' && link[REFS_KEY] !== undefined ? ' It appears to be a plural linked record: did you mean to call ' + 'getLinkedRecords() instead of getLinkedRecord()?' : '') : invariant(false) : void 0;
   return link[REF_KEY];
 }
 /**
@@ -190,7 +191,7 @@ function getLinkedRecordIDs(record, storageKey) {
     return links;
   }
 
-  !(typeof links === 'object' && Array.isArray(links[REFS_KEY])) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernRecord.getLinkedRecordIDs(): Expected `%s.%s` to contain an array ' + 'of linked IDs, got `%s`.', record[ID_KEY], storageKey, JSON.stringify(links)) : invariant(false) : void 0; // assume items of the array are ids
+  !(typeof links === 'object' && Array.isArray(links[REFS_KEY])) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernRecord.getLinkedRecordIDs(): Expected `%s.%s` to contain an array ' + 'of linked IDs, got `%s`.%s', record[ID_KEY], storageKey, JSON.stringify(links), typeof links === 'object' && links[REF_KEY] !== undefined ? ' It appears to be a singular linked record: did you mean to call ' + 'getLinkedRecord() instead of getLinkedRecords()?' : '') : invariant(false) : void 0; // assume items of the array are ids
 
   return links[REFS_KEY];
 }

package/lib/store/RelayModernSelector.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -10,21 +10,21 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var areEqual = require("fbjs/lib/areEqual");
-
-var invariant = require('invariant');
-
-var warning = require("fbjs/lib/warning");
-
 var _require = require('./RelayConcreteVariables'),
     getFragmentVariables = _require.getFragmentVariables;
 
 var _require2 = require('./RelayStoreUtils'),
+    CLIENT_EDGE_TRAVERSAL_PATH = _require2.CLIENT_EDGE_TRAVERSAL_PATH,
     FRAGMENT_OWNER_KEY = _require2.FRAGMENT_OWNER_KEY,
     FRAGMENTS_KEY = _require2.FRAGMENTS_KEY,
     ID_KEY = _require2.ID_KEY,
     IS_WITHIN_UNMATCHED_TYPE_REFINEMENT = _require2.IS_WITHIN_UNMATCHED_TYPE_REFINEMENT;
 
+var areEqual = require("fbjs/lib/areEqual");
+
+var invariant = require('invariant');
+
+var warning = require("fbjs/lib/warning");
 /**
  * @public
  *
@@ -54,18 +54,22 @@ var _require2 = require('./RelayStoreUtils'),
  * const childData = environment.lookup(childSelector).data;
  * ```
  */
+
+
 function getSingularSelector(fragment, item) {
   !(typeof item === 'object' && item !== null && !Array.isArray(item)) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernSelector: Expected value for fragment `%s` to be an object, got ' + '`%s`.', fragment.name, JSON.stringify(item)) : invariant(false) : void 0;
   var dataID = item[ID_KEY];
   var fragments = item[FRAGMENTS_KEY];
   var mixedOwner = item[FRAGMENT_OWNER_KEY];
   var isWithinUnmatchedTypeRefinement = item[IS_WITHIN_UNMATCHED_TYPE_REFINEMENT] === true;
+  var mixedClientEdgeTraversalPath = item[CLIENT_EDGE_TRAVERSAL_PATH];
 
-  if (typeof dataID === 'string' && typeof fragments === 'object' && fragments !== null && typeof fragments[fragment.name] === 'object' && fragments[fragment.name] !== null && typeof mixedOwner === 'object' && mixedOwner !== null) {
+  if (typeof dataID === 'string' && typeof fragments === 'object' && fragments !== null && typeof fragments[fragment.name] === 'object' && fragments[fragment.name] !== null && typeof mixedOwner === 'object' && mixedOwner !== null && (mixedClientEdgeTraversalPath == null || Array.isArray(mixedClientEdgeTraversalPath))) {
     var owner = mixedOwner;
+    var clientEdgeTraversalPath = mixedClientEdgeTraversalPath;
     var argumentVariables = fragments[fragment.name];
     var fragmentVariables = getFragmentVariables(fragment, owner.variables, argumentVariables);
-    return createReaderSelector(fragment, dataID, fragmentVariables, owner, isWithinUnmatchedTypeRefinement);
+    return createReaderSelector(fragment, dataID, fragmentVariables, owner, isWithinUnmatchedTypeRefinement, clientEdgeTraversalPath);
   }
 
   if (process.env.NODE_ENV !== "production") {
@@ -295,10 +299,12 @@ function areEqualSelectors(thisSelector, thatSelector) {
 
 function createReaderSelector(fragment, dataID, variables, request) {
   var isWithinUnmatchedTypeRefinement = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
+  var clientEdgeTraversalPath = arguments.length > 5 ? arguments[5] : undefined;
   return {
     kind: 'SingularReaderSelector',
     dataID: dataID,
     isWithinUnmatchedTypeRefinement: isWithinUnmatchedTypeRefinement,
+    clientEdgeTraversalPath: clientEdgeTraversalPath !== null && clientEdgeTraversalPath !== void 0 ? clientEdgeTraversalPath : null,
     node: fragment,
     variables: variables,
     owner: request

package/lib/store/RelayModernStore.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -16,10 +16,20 @@ var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime
 
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
-var DataChecker = require('./DataChecker');
+var _require = require('../multi-actor-environment/ActorIdentifier'),
+    INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE = _require.INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
+    assertInternalActorIndentifier = _require.assertInternalActorIndentifier;
+
+var deepFreeze = require('../util/deepFreeze');
 
 var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
+var resolveImmediate = require('../util/resolveImmediate');
+
+var DataChecker = require('./DataChecker');
+
+var defaultGetDataID = require('./defaultGetDataID');
+
 var RelayModernRecord = require('./RelayModernRecord');
 
 var RelayOptimisticRecordSource = require('./RelayOptimisticRecordSource');
@@ -34,18 +44,6 @@ var RelayStoreSubscriptions = require('./RelayStoreSubscriptions');
 
 var RelayStoreUtils = require('./RelayStoreUtils');
 
-var deepFreeze = require('../util/deepFreeze');
-
-var defaultGetDataID = require('./defaultGetDataID');
-
-var invariant = require('invariant');
-
-var resolveImmediate = require('../util/resolveImmediate');
-
-var _require = require('../multi-actor-environment/ActorIdentifier'),
-    INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE = _require.INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
-    assertInternalActorIndentifier = _require.assertInternalActorIndentifier;
-
 var _require2 = require('./RelayStoreUtils'),
     ROOT_ID = _require2.ROOT_ID,
     ROOT_TYPE = _require2.ROOT_TYPE;
@@ -53,6 +51,8 @@ var _require2 = require('./RelayStoreUtils'),
 var _require3 = require('./ResolverCache'),
     RecordResolverCache = _require3.RecordResolverCache;
 
+var invariant = require('invariant');
+
 var DEFAULT_RELEASE_BUFFER_SIZE = 10;
 /**
  * @public
@@ -680,8 +680,7 @@ function updateTargetFromSource(target, source, currentWriteEpoch, idsMarkedForI
       }
 
       RelayModernRecord.setValue(nextRecord, RelayStoreUtils.INVALIDATED_AT_KEY, currentWriteEpoch);
-      invalidatedRecordIDs.add(dataID); // $FlowFixMe[incompatible-call]
-
+      invalidatedRecordIDs.add(dataID);
       target.set(dataID, nextRecord);
     });
   } // Update the target based on the changes present in source

package/lib/store/RelayOperationTracker.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/store/RelayOptimisticRecordSource.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/store/RelayPublishQueue.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -12,16 +12,16 @@
 
 var _global$ErrorUtils$ap, _global, _global$ErrorUtils;
 
-var RelayReader = require('./RelayReader');
-
-var RelayRecordSource = require('./RelayRecordSource');
-
 var RelayRecordSourceMutator = require('../mutations/RelayRecordSourceMutator');
 
 var RelayRecordSourceProxy = require('../mutations/RelayRecordSourceProxy');
 
 var RelayRecordSourceSelectorProxy = require('../mutations/RelayRecordSourceSelectorProxy');
 
+var RelayReader = require('./RelayReader');
+
+var RelayRecordSource = require('./RelayRecordSource');
+
 var invariant = require('invariant');
 
 var warning = require("fbjs/lib/warning");
@@ -45,9 +45,15 @@ var RelayPublishQueue = /*#__PURE__*/function () {
   // True if the next `run()` should apply the backup and rerun all optimistic
   // updates performing a rebase.
   // Payloads to apply or Sources to publish to the store with the next `run()`.
+  // $FlowFixMe[unclear-type] See explanation below.
   // Optimistic updaters to add with the next `run()`.
+  // $FlowFixMe[unclear-type] See explanation below.
   // Optimistic updaters that are already added and might be rerun in order to
   // rebase them.
+  // $FlowFixMe[unclear-type] See explanation below.
+  // For _pendingOptimisticUpdates, _appliedOptimisticUpdates, and _pendingData,
+  // we want to parametrize by "any" since the type is effectively
+  // "the union of all T's that PublishQueue's methods were called with".
   // Garbage collection hold, should rerun gc on dispose
   function RelayPublishQueue(store, handlerProvider, getDataID) {
     this._hasStoreSnapshot = false;
@@ -301,7 +307,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
 
     var sink = RelayRecordSource.create();
     var mutator = new RelayRecordSourceMutator(this._store.getSource(), sink);
-    var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID, this._handlerProvider);
+    var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID, this._handlerProvider); // $FlowFixMe[unclear-type] see explanation above.
 
     var processUpdate = function processUpdate(optimisticUpdate) {
       if (optimisticUpdate.storeUpdater) {