relay-runtime 12.0.0 → 13.0.0-rc.0

package/lib/network/wrapNetworkWithLogObserver.js

@@ -11,7 +11,6 @@
 'use strict';
 
 var generateID = require('../util/generateID');
-
 /**
  * Wraps the network with logging to ensure that network requests are
  * always logged. Relying on each network callsite to be wrapped is
@@ -20,6 +19,8 @@ var generateID = require('../util/generateID');
  * devtools will mutate the `env.__log` method, and the devtools rely
  * on it to receive network events.
  */
+
+
 function wrapNetworkWithLogObserver(env, network) {
   return {
     execute: function execute(params, variables, cacheConfig, uploadables) {

package/lib/query/GraphQLTag.js

@@ -14,7 +14,8 @@ var RelayConcreteNode = require('../util/RelayConcreteNode');
 
 var invariant = require('invariant');
 
-var warning = require("fbjs/lib/warning");
+var warning = require("fbjs/lib/warning"); // The type of a graphql`...` tagged template expression.
+
 
 /**
  * Runtime function to correspond to the `graphql` tagged template function.

package/lib/query/fetchQuery.js

@@ -17,18 +17,17 @@ var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/obje
 
 var RelayObservable = require('../network/RelayObservable');
 
-var fetchQueryInternal = require('./fetchQueryInternal');
-
-var invariant = require('invariant');
+var _require = require('../store/RelayModernOperationDescriptor'),
+    createOperationDescriptor = _require.createOperationDescriptor;
 
 var reportMissingRequiredFields = require('../util/reportMissingRequiredFields');
 
-var _require = require('../store/RelayModernOperationDescriptor'),
-    createOperationDescriptor = _require.createOperationDescriptor;
+var fetchQueryInternal = require('./fetchQueryInternal');
 
 var _require2 = require('./GraphQLTag'),
     getRequest = _require2.getRequest;
 
+var invariant = require('invariant');
 /**
  * Fetches the given query and variables on the provided environment,
  * and de-dupes identical in-flight requests.
@@ -106,6 +105,8 @@ var _require2 = require('./GraphQLTag'),
  * ```
  * NOTE: When using .toPromise(), the request cannot be cancelled.
  */
+
+
 function fetchQuery(environment, query, variables, options) {
   var _options$fetchPolicy;
 

package/lib/query/fetchQuery_DEPRECATED.js

@@ -15,12 +15,13 @@ var _require = require('../store/RelayModernOperationDescriptor'),
 
 var _require2 = require('./GraphQLTag'),
     getRequest = _require2.getRequest;
-
 /**
  * A helper function to fetch the results of a query. Note that results for
  * fragment spreads are masked: fields must be explicitly listed in the query in
  * order to be accessible in the result object.
  */
+
+
 function fetchQuery_DEPRECATED(environment, taggedNode, variables, cacheConfig) {
   var query = getRequest(taggedNode);
 

package/lib/store/ClientID.js

@@ -10,10 +10,16 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
+
+var _require = require('../util/StringInterner'),
+    intern = _require.intern;
+
 var PREFIX = 'client:';
 
 function generateClientID(id, storageKey, index) {
-  var key = id + ':' + storageKey;
+  var internedId = RelayFeatureFlags.STRING_INTERN_LEVEL <= 0 ? id : intern(id, RelayFeatureFlags.MAX_DATA_ID_LENGTH);
+  var key = internedId + ':' + storageKey;
 
   if (index != null) {
     key += ':' + index;

package/lib/store/DataChecker.js

@@ -15,41 +15,41 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
 
-var RelayConcreteNode = require('../util/RelayConcreteNode');
-
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
-
-var RelayModernRecord = require('./RelayModernRecord');
-
 var RelayRecordSourceMutator = require('../mutations/RelayRecordSourceMutator');
 
 var RelayRecordSourceProxy = require('../mutations/RelayRecordSourceProxy');
 
-var RelayStoreReactFlightUtils = require('./RelayStoreReactFlightUtils');
-
-var RelayStoreUtils = require('./RelayStoreUtils');
-
-var cloneRelayHandleSourceField = require('./cloneRelayHandleSourceField');
-
-var cloneRelayScalarHandleSourceField = require('./cloneRelayScalarHandleSourceField');
-
 var getOperation = require('../util/getOperation');
 
-var invariant = require('invariant');
+var RelayConcreteNode = require('../util/RelayConcreteNode');
+
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
 var _require = require('./ClientID'),
     isClientID = _require.isClientID;
 
+var cloneRelayHandleSourceField = require('./cloneRelayHandleSourceField');
+
+var cloneRelayScalarHandleSourceField = require('./cloneRelayScalarHandleSourceField');
+
 var _require2 = require('./RelayConcreteVariables'),
     getLocalVariables = _require2.getLocalVariables;
 
+var RelayModernRecord = require('./RelayModernRecord');
+
 var _require3 = require('./RelayRecordState'),
     EXISTENT = _require3.EXISTENT,
     UNKNOWN = _require3.UNKNOWN;
 
+var RelayStoreReactFlightUtils = require('./RelayStoreReactFlightUtils');
+
+var RelayStoreUtils = require('./RelayStoreUtils');
+
 var _require4 = require('./TypeID'),
     generateTypeID = _require4.generateTypeID;
 
+var invariant = require('invariant');
+
 var ACTOR_CHANGE = RelayConcreteNode.ACTOR_CHANGE,
     CONDITION = RelayConcreteNode.CONDITION,
     CLIENT_COMPONENT = RelayConcreteNode.CLIENT_COMPONENT,
@@ -145,8 +145,7 @@ var DataChecker = /*#__PURE__*/function () {
   };
 
   _proto._getVariableValue = function _getVariableValue(name) {
-    !this._variables.hasOwnProperty(name) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayAsyncLoader(): Undefined variable `%s`.', name) : invariant(false) : void 0; // $FlowFixMe[cannot-write]
-
+    !this._variables.hasOwnProperty(name) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayAsyncLoader(): Undefined variable `%s`.', name) : invariant(false) : void 0;
     return this._variables[name];
   };
 

package/lib/store/OperationExecutor.js

@@ -21,27 +21,17 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
-var RelayError = require('../util/RelayError');
-
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
-
-var RelayModernRecord = require('./RelayModernRecord');
-
 var RelayObservable = require('../network/RelayObservable');
 
-var RelayRecordSource = require('./RelayRecordSource');
-
-var RelayResponseNormalizer = require('./RelayResponseNormalizer');
-
 var generateID = require('../util/generateID');
 
 var getOperation = require('../util/getOperation');
 
-var invariant = require('invariant');
+var RelayError = require('../util/RelayError');
 
-var stableCopy = require('../util/stableCopy');
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
-var warning = require("fbjs/lib/warning");
+var stableCopy = require('../util/stableCopy');
 
 var withDuration = require('../util/withDuration');
 
@@ -52,15 +42,25 @@ var _require = require('./ClientID'),
 var _require2 = require('./RelayConcreteVariables'),
     getLocalVariables = _require2.getLocalVariables;
 
+var RelayModernRecord = require('./RelayModernRecord');
+
 var _require3 = require('./RelayModernSelector'),
     createNormalizationSelector = _require3.createNormalizationSelector,
     createReaderSelector = _require3.createReaderSelector;
 
+var RelayRecordSource = require('./RelayRecordSource');
+
+var RelayResponseNormalizer = require('./RelayResponseNormalizer');
+
 var _require4 = require('./RelayStoreUtils'),
     ROOT_TYPE = _require4.ROOT_TYPE,
     TYPENAME_KEY = _require4.TYPENAME_KEY,
     getStorageKey = _require4.getStorageKey;
 
+var invariant = require('invariant');
+
+var warning = require("fbjs/lib/warning");
+
 function execute(config) {
   return new Executor(config);
 }

package/lib/store/RelayConcreteVariables.js

@@ -14,11 +14,10 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 
-var invariant = require('invariant');
-
 var _require = require('./RelayStoreUtils'),
     getArgumentValues = _require.getArgumentValues;
 
+var invariant = require('invariant');
 /**
  * Determines the variables that are in scope for a fragment given the variables
  * in scope at the root query as well as any arguments applied at the fragment
@@ -26,13 +25,14 @@ var _require = require('./RelayStoreUtils'),
  *
  * Note that this is analagous to determining function arguments given a function call.
  */
+
+
 function getFragmentVariables(fragment, rootVariables, argumentVariables) {
   var variables;
   fragment.argumentDefinitions.forEach(function (definition) {
     if (argumentVariables.hasOwnProperty(definition.name)) {
       return;
-    } // $FlowFixMe[cannot-spread-interface]
-
+    }
 
     variables = variables || (0, _objectSpread2["default"])({}, argumentVariables);
 
@@ -52,12 +52,9 @@ function getFragmentVariables(fragment, rootVariables, argumentVariables) {
            * RelayStoreUtils.getStableVariableValue() that variable keys are all
            * present.
            */
-          // $FlowFixMe[incompatible-use]
           variables[definition.name] = undefined;
           break;
-        } // $FlowFixMe[incompatible-use]
-        // $FlowFixMe[cannot-write]
-
+        }
 
         variables[definition.name] = rootVariables[definition.name];
         break;
@@ -80,7 +77,7 @@ function getFragmentVariables(fragment, rootVariables, argumentVariables) {
 function getOperationVariables(operation, variables) {
   var operationVariables = {};
   operation.argumentDefinitions.forEach(function (def) {
-    var value = def.defaultValue; // $FlowFixMe[cannot-write]
+    var value = def.defaultValue;
 
     if (variables[def.name] != null) {
       value = variables[def.name];

package/lib/store/RelayModernEnvironment.js

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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