relay-runtime 12.0.0 → 13.0.0-rc.0

package/lib/store/RelayStoreUtils.js

@@ -14,14 +14,14 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
-var RelayConcreteNode = require('../util/RelayConcreteNode');
-
 var getRelayHandleKey = require('../util/getRelayHandleKey');
 
-var invariant = require('invariant');
+var RelayConcreteNode = require('../util/RelayConcreteNode');
 
 var stableCopy = require('../util/stableCopy');
 
+var invariant = require('invariant');
+
 var VARIABLE = RelayConcreteNode.VARIABLE,
     LITERAL = RelayConcreteNode.LITERAL,
     OBJECT_VALUE = RelayConcreteNode.OBJECT_VALUE,
@@ -175,8 +175,7 @@ function formatStorageKey(name, argValues) {
 
 
 function getStableVariableValue(name, variables) {
-  !variables.hasOwnProperty(name) ? process.env.NODE_ENV !== "production" ? invariant(false, 'getVariableValue(): Undefined variable `%s`.', name) : invariant(false) : void 0; // $FlowFixMe[cannot-write]
-
+  !variables.hasOwnProperty(name) ? process.env.NODE_ENV !== "production" ? invariant(false, 'getVariableValue(): Undefined variable `%s`.', name) : invariant(false) : void 0;
   return stableCopy(variables[name]);
 }
 
@@ -194,6 +193,7 @@ function getModuleOperationKey(documentName) {
 
 var RelayStoreUtils = {
   ACTOR_IDENTIFIER_KEY: '__actorIdentifier',
+  CLIENT_EDGE_TRAVERSAL_PATH: '__clientEdgeTraversalPath',
   FRAGMENTS_KEY: '__fragments',
   FRAGMENT_OWNER_KEY: '__fragmentOwner',
   FRAGMENT_PROP_NAME_KEY: '__fragmentPropName',

package/lib/store/ResolverCache.js

@@ -14,22 +14,22 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
-var RelayModernRecord = require('./RelayModernRecord');
-
 var recycleNodesInto = require('../util/recycleNodesInto');
 
-var warning = require("fbjs/lib/warning");
-
 var _require = require('./ClientID'),
     generateClientID = _require.generateClientID;
 
+var RelayModernRecord = require('./RelayModernRecord');
+
 var _require2 = require('./RelayStoreUtils'),
-    RELAY_RESOLVER_VALUE_KEY = _require2.RELAY_RESOLVER_VALUE_KEY,
-    RELAY_RESOLVER_INVALIDATION_KEY = _require2.RELAY_RESOLVER_INVALIDATION_KEY,
     RELAY_RESOLVER_INPUTS_KEY = _require2.RELAY_RESOLVER_INPUTS_KEY,
+    RELAY_RESOLVER_INVALIDATION_KEY = _require2.RELAY_RESOLVER_INVALIDATION_KEY,
     RELAY_RESOLVER_READER_SELECTOR_KEY = _require2.RELAY_RESOLVER_READER_SELECTOR_KEY,
+    RELAY_RESOLVER_VALUE_KEY = _require2.RELAY_RESOLVER_VALUE_KEY,
     getStorageKey = _require2.getStorageKey;
 
+var warning = require("fbjs/lib/warning");
+
 // $FlowFixMe[unclear-type] - will always be empty
 var emptySet = new Set();
 

package/lib/store/ResolverFragments.js

@@ -10,14 +10,18 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var invariant = require('invariant');
-
 var _require = require('../query/GraphQLTag'),
     getFragment = _require.getFragment;
 
 var _require2 = require('./RelayModernSelector'),
     getSelector = _require2.getSelector;
 
+var invariant = require('invariant'); // When we call the user-supplied resolver function, it will in turn call
+// `readFragment`, but that's a global function -- it needs information
+// about what resolver is being executed, which is supplied by putting the
+// info on this stack before we call the resolver function.
+
+
 var contextStack = [];
 
 function withResolverContext(context, cb) {
@@ -38,17 +42,17 @@ function withResolverContext(context, cb) {
 //   - array of nullable if the privoided ref type is an array of nullable refs
 
 
-function readFragment(fragmentInput, fragmentRef) {
+function readFragment(fragmentInput, fragmentKey) {
   if (!contextStack.length) {
     throw new Error('readFragment should be called only from within a Relay Resolver function.');
   }
 
   var context = contextStack[contextStack.length - 1];
   var fragmentNode = getFragment(fragmentInput);
-  var fragmentSelector = getSelector(fragmentNode, fragmentRef);
+  var fragmentSelector = getSelector(fragmentNode, fragmentKey);
   !(fragmentSelector != null) ? process.env.NODE_ENV !== "production" ? invariant(false, "Expected a selector for the fragment of the resolver ".concat(fragmentNode.name, ", but got null.")) : invariant(false) : void 0;
   !(fragmentSelector.kind === 'SingularReaderSelector') ? process.env.NODE_ENV !== "production" ? invariant(false, "Expected a singular reader selector for the fragment of the resolver ".concat(fragmentNode.name, ", but it was plural.")) : invariant(false) : void 0;
-  return context.getDataForResolverFragment(fragmentSelector, fragmentRef);
+  return context.getDataForResolverFragment(fragmentSelector, fragmentKey);
 }
 
 module.exports = {

package/lib/store/cloneRelayHandleSourceField.js

@@ -10,16 +10,15 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var areEqual = require("fbjs/lib/areEqual");
-
-var invariant = require('invariant');
-
 var _require = require('../util/RelayConcreteNode'),
     LINKED_FIELD = _require.LINKED_FIELD;
 
 var _require2 = require('./RelayStoreUtils'),
     getHandleStorageKey = _require2.getHandleStorageKey;
 
+var areEqual = require("fbjs/lib/areEqual");
+
+var invariant = require('invariant');
 /**
  * @private
  *
@@ -27,6 +26,8 @@ var _require2 = require('./RelayStoreUtils'),
  * field (on which the handle was declared) among the sibling `selections`, and
  * copying its selections into the clone.
  */
+
+
 function cloneRelayHandleSourceField(handleField, selections, variables) {
   var sourceField = selections.find(function (source) {
     return source.kind === LINKED_FIELD && source.name === handleField.name && source.alias === handleField.alias && areEqual(source.args, handleField.args);

package/lib/store/cloneRelayScalarHandleSourceField.js

@@ -10,22 +10,23 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var areEqual = require("fbjs/lib/areEqual");
-
-var invariant = require('invariant');
-
 var _require = require('../util/RelayConcreteNode'),
     SCALAR_FIELD = _require.SCALAR_FIELD;
 
 var _require2 = require('./RelayStoreUtils'),
     getHandleStorageKey = _require2.getHandleStorageKey;
 
+var areEqual = require("fbjs/lib/areEqual");
+
+var invariant = require('invariant');
 /**
  * @private
  *
  * Creates a clone of the supplied `handleField` by finding the original scalar
  * field (on which the handle was declared) among the sibling `selections`.
  */
+
+
 function cloneRelayScalarHandleSourceField(handleField, selections, variables) {
   var sourceField = selections.find(function (source) {
     return source.kind === SCALAR_FIELD && source.name === handleField.name && source.alias === handleField.alias && areEqual(source.args, handleField.args);

package/lib/store/createRelayContext.js

@@ -10,7 +10,9 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var invariant = require('invariant');
+var invariant = require('invariant'); // Ideally, we'd just import the type of the react module, but this causes Flow
+// problems.
+
 
 var relayContext;
 var firstReact;

package/lib/store/readInlineData.js

@@ -10,14 +10,18 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var invariant = require('invariant');
-
 var _require = require('../query/GraphQLTag'),
     getInlineDataFragment = _require.getInlineDataFragment;
 
 var _require2 = require('./RelayStoreUtils'),
     FRAGMENTS_KEY = _require2.FRAGMENTS_KEY;
 
+var invariant = require('invariant');
+/**
+ * Reads an @inline data fragment that was spread into the parent fragment.
+ */
+
+
 function readInlineData(fragment, fragmentRef) {
   var _fragmentRef$FRAGMENT;
 

package/lib/subscription/requestSubscription.js

@@ -12,10 +12,6 @@
 
 var RelayDeclarativeMutationConfig = require('../mutations/RelayDeclarativeMutationConfig');
 
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
-
-var warning = require("fbjs/lib/warning");
-
 var _require = require('../query/GraphQLTag'),
     getRequest = _require.getRequest;
 
@@ -25,6 +21,10 @@ var _require2 = require('../store/RelayModernOperationDescriptor'),
 var _require3 = require('../store/RelayModernSelector'),
     createReaderSelector = _require3.createReaderSelector;
 
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
+
+var warning = require("fbjs/lib/warning");
+
 function requestSubscription(environment, config) {
   var subscription = getRequest(config.subscription);
 
@@ -48,7 +48,7 @@ function requestSubscription(environment, config) {
   config.updater) : config,
       updater = _ref.updater;
 
-  var sub = environment.execute({
+  var sub = environment.executeSubscription({
     operation: operation,
     updater: updater
   }).subscribe({

package/lib/util/RelayConcreteNode.js

@@ -27,6 +27,7 @@ var RelayConcreteNode = {
   ACTOR_CHANGE: 'ActorChange',
   CONDITION: 'Condition',
   CLIENT_COMPONENT: 'ClientComponent',
+  CLIENT_EDGE: 'ClientEdge',
   CLIENT_EXTENSION: 'ClientExtension',
   DEFER: 'Defer',
   CONNECTION: 'Connection',

package/lib/util/RelayFeatureFlags.js

@@ -11,6 +11,8 @@
 'use strict';
 
 var RelayFeatureFlags = {
+  DELAY_CLEANUP_OF_PENDING_PRELOAD_QUERIES: false,
+  ENABLE_CLIENT_EDGES: false,
   ENABLE_VARIABLE_CONNECTION_KEY: false,
   ENABLE_PARTIAL_RENDERING_DEFAULT: true,
   ENABLE_REACT_FLIGHT_COMPONENT_FIELD: false,
@@ -23,6 +25,10 @@ var RelayFeatureFlags = {
   ENABLE_NOTIFY_SUBSCRIPTION: false,
   BATCH_ASYNC_MODULE_UPDATES_FN: null,
   ENABLE_CONTAINERS_SUBSCRIBE_ON_COMMIT: false,
-  ENABLE_QUERY_RENDERER_OFFSCREEN_SUPPORT: false
+  ENABLE_QUERY_RENDERER_OFFSCREEN_SUPPORT: false,
+  MAX_DATA_ID_LENGTH: null,
+  REFACTOR_SUSPENSE_RESOURCE: true,
+  STRING_INTERN_LEVEL: 0,
+  USE_REACT_CACHE: false
 };
 module.exports = RelayFeatureFlags;

package/lib/util/RelayRuntimeTypes.js

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

package/lib/util/StringInterner.js

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

package/lib/util/getFragmentIdentifier.js

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

package/lib/util/getOperation.js

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

package/lib/util/getPaginationVariables.js

@@ -32,7 +32,7 @@ function getPaginationVariables(direction, count, cursor, baseVariables, extraVa
 
     !(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]
+    process.env.NODE_ENV !== "production" ? warning(!extraVariables.hasOwnProperty(backwardMetadata.count), 'Relay: `UNSTABLE_extraVariables` provided by caller should not ' + 'contain count variable `%s`. This variable is automatically ' + 'determined by Relay.', backwardMetadata.count) : void 0;
 
     var _paginationVariables = (0, _objectSpread4["default"])((0, _objectSpread4["default"])((0, _objectSpread4["default"])({}, baseVariables), extraVariables), {}, (_objectSpread2 = {}, (0, _defineProperty2["default"])(_objectSpread2, backwardMetadata.cursor, cursor), (0, _defineProperty2["default"])(_objectSpread2, backwardMetadata.count, count), _objectSpread2));
 
@@ -49,8 +49,7 @@ function getPaginationVariables(direction, count, cursor, baseVariables, extraVa
 
   !(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]
-
+  process.env.NODE_ENV !== "production" ? warning(!extraVariables.hasOwnProperty(forwardMetadata.count), 'Relay: `UNSTABLE_extraVariables` provided by caller should not ' + 'contain count variable `%s`. This variable is automatically ' + 'determined by Relay.', forwardMetadata.count) : void 0;
   var paginationVariables = (0, _objectSpread4["default"])((0, _objectSpread4["default"])((0, _objectSpread4["default"])({}, baseVariables), extraVariables), {}, (_objectSpread3 = {}, (0, _defineProperty2["default"])(_objectSpread3, forwardMetadata.cursor, cursor), (0, _defineProperty2["default"])(_objectSpread3, forwardMetadata.count, count), _objectSpread3));
 
   if (backwardMetadata && backwardMetadata.cursor) {

package/lib/util/getRelayHandleKey.js

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

package/lib/util/getRequestIdentifier.js

@@ -10,10 +10,10 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
-var invariant = require('invariant');
-
 var stableCopy = require('./stableCopy');
 
+var invariant = require('invariant');
+
 /**
  * Returns a stable identifier for the given pair of `RequestParameters` +
  * variables.

package/multi-actor-environment/ActorSpecificEnvironment.js.flow

@@ -11,31 +11,25 @@
 
 'use strict';
 
-const RelayOperationTracker = require('../store/RelayOperationTracker');
-const RelayPublishQueue = require('../store/RelayPublishQueue');
-
-const defaultGetDataID = require('../store/defaultGetDataID');
-const registerEnvironmentWithDevTools = require('../util/registerEnvironmentWithDevTools');
-const wrapNetworkWithLogObserver = require('../network/wrapNetworkWithLogObserver');
-
 import type {HandlerProvider} from '../handlers/RelayDefaultHandlerProvider';
 import type {GraphQLResponse, PayloadData} from '../network/RelayNetworkTypes';
 import type {INetwork} from '../network/RelayNetworkTypes';
 import type RelayObservable from '../network/RelayObservable';
 import type {
+  ExecuteMutationConfig,
+  LogFunction,
+  MutationParameters,
+  OperationAvailability,
+  OperationDescriptor,
+  OperationTracker,
   OptimisticResponseConfig,
   OptimisticUpdateFunction,
-  OperationDescriptor,
-  OperationAvailability,
-  Snapshot,
+  RequiredFieldLogger,
   SelectorStoreUpdater,
   SingularReaderSelector,
-  StoreUpdater,
-  RequiredFieldLogger,
-  ExecuteMutationConfig,
-  LogFunction,
+  Snapshot,
   Store,
-  OperationTracker,
+  StoreUpdater,
 } from '../store/RelayStoreTypes';
 import type {Disposable, RenderPolicy} from '../util/RelayRuntimeTypes';
 import type {ActorIdentifier} from './ActorIdentifier';
@@ -44,6 +38,12 @@ import type {
   IMultiActorEnvironment,
 } from './MultiActorEnvironmentTypes';
 
+const wrapNetworkWithLogObserver = require('../network/wrapNetworkWithLogObserver');
+const defaultGetDataID = require('../store/defaultGetDataID');
+const RelayOperationTracker = require('../store/RelayOperationTracker');
+const RelayPublishQueue = require('../store/RelayPublishQueue');
+const registerEnvironmentWithDevTools = require('../util/registerEnvironmentWithDevTools');
+
 export type ActorSpecificEnvironmentConfig = $ReadOnly<{
   actorIdentifier: ActorIdentifier,
   configName: ?string,
@@ -113,7 +113,9 @@ class ActorSpecificEnvironment implements IActorEnvironment {
     return this._defaultRenderPolicy;
   }
 
-  applyMutation(optimisticConfig: OptimisticResponseConfig): Disposable {
+  applyMutation<TMutation: MutationParameters>(
+    optimisticConfig: OptimisticResponseConfig<TMutation>,
+  ): Disposable {
     return this.multiActorEnvironment.applyMutation(this, optimisticConfig);
   }
 
@@ -187,13 +189,19 @@ class ActorSpecificEnvironment implements IActorEnvironment {
 
   execute(config: {
     operation: OperationDescriptor,
-    updater?: ?SelectorStoreUpdater,
   }): RelayObservable<GraphQLResponse> {
     return this.multiActorEnvironment.execute(this, config);
   }
 
-  executeMutation(
-    options: ExecuteMutationConfig,
+  executeSubscription<TMutation: MutationParameters>(config: {
+    operation: OperationDescriptor,
+    updater?: ?SelectorStoreUpdater<TMutation['response']>,
+  }): RelayObservable<GraphQLResponse> {
+    return this.multiActorEnvironment.executeSubscription(this, config);
+  }
+
+  executeMutation<TMutation: MutationParameters>(
+    options: ExecuteMutationConfig<TMutation>,
   ): RelayObservable<GraphQLResponse> {
     return this.multiActorEnvironment.executeMutation(this, options);
   }

package/multi-actor-environment/ActorUtils.js.flow

@@ -13,10 +13,10 @@
 
 const ACTOR_IDENTIFIER_FIELD_NAME = 'actor_key';
 
-const {getActorIdentifier} = require('./ActorIdentifier');
-
 import type {ActorIdentifier} from './ActorIdentifier';
 
+const {getActorIdentifier} = require('./ActorIdentifier');
+
 function getActorIdentifierFromPayload(payload: mixed): ?ActorIdentifier {
   if (
     payload != null &&