relay-runtime 10.0.1 → 10.1.0

package/lib/store/RelayReferenceMarker.js

@@ -10,16 +10,26 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; 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 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(o); 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 RelayConcreteNode = require('../util/RelayConcreteNode');
 
 var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
 var RelayModernRecord = require('./RelayModernRecord');
 
+var RelayStoreReactFlightUtils = require('./RelayStoreReactFlightUtils');
+
 var RelayStoreUtils = require('./RelayStoreUtils');
 
 var cloneRelayHandleSourceField = require('./cloneRelayHandleSourceField');
 
+var getOperation = require('../util/getOperation');
+
 var invariant = require("fbjs/lib/invariant");
 
 var _require = require('./TypeID'),
@@ -28,6 +38,7 @@ var _require = require('./TypeID'),
 var CONDITION = RelayConcreteNode.CONDITION,
     CLIENT_EXTENSION = RelayConcreteNode.CLIENT_EXTENSION,
     DEFER = RelayConcreteNode.DEFER,
+    FLIGHT_FIELD = RelayConcreteNode.FLIGHT_FIELD,
     FRAGMENT_SPREAD = RelayConcreteNode.FRAGMENT_SPREAD,
     INLINE_FRAGMENT = RelayConcreteNode.INLINE_FRAGMENT,
     LINKED_FIELD = RelayConcreteNode.LINKED_FIELD,
@@ -37,7 +48,8 @@ var CONDITION = RelayConcreteNode.CONDITION,
     SCALAR_HANDLE = RelayConcreteNode.SCALAR_HANDLE,
     STREAM = RelayConcreteNode.STREAM,
     TYPE_DISCRIMINATOR = RelayConcreteNode.TYPE_DISCRIMINATOR;
-var getStorageKey = RelayStoreUtils.getStorageKey,
+var ROOT_ID = RelayStoreUtils.ROOT_ID,
+    getStorageKey = RelayStoreUtils.getStorageKey,
     getModuleOperationKey = RelayStoreUtils.getModuleOperationKey;
 
 function mark(recordSource, selector, references, operationLoader) {
@@ -55,6 +67,7 @@ function mark(recordSource, selector, references, operationLoader) {
 var RelayReferenceMarker = /*#__PURE__*/function () {
   function RelayReferenceMarker(recordSource, variables, references, operationLoader) {
     this._operationLoader = operationLoader !== null && operationLoader !== void 0 ? operationLoader : null;
+    this._operationName = null;
     this._recordSource = recordSource;
     this._references = references;
     this._variables = variables;
@@ -63,6 +76,10 @@ var RelayReferenceMarker = /*#__PURE__*/function () {
   var _proto = RelayReferenceMarker.prototype;
 
   _proto.mark = function mark(node, dataID) {
+    if (node.kind === 'Operation' || node.kind === 'SplitOperation') {
+      this._operationName = node.name;
+    }
+
     this._traverse(node, dataID);
   };
 
@@ -127,6 +144,7 @@ var RelayReferenceMarker = /*#__PURE__*/function () {
           }
 
           break;
+        // $FlowFixMe[incompatible-type]
 
         case FRAGMENT_SPREAD:
           !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReferenceMarker(): Unexpected fragment spread `...%s`, ' + 'expected all fragments to be inlined.', selection.name) : invariant(false) : void 0;
@@ -184,6 +202,15 @@ var RelayReferenceMarker = /*#__PURE__*/function () {
 
           break;
 
+        case FLIGHT_FIELD:
+          if (RelayFeatureFlags.ENABLE_REACT_FLIGHT_COMPONENT_FIELD) {
+            _this._traverseFlightField(selection, record);
+          } else {
+            throw new Error('Flight fields are not yet supported.');
+          }
+
+          break;
+
         default:
           selection;
           !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReferenceMarker: Unknown AST node `%s`.', selection) : invariant(false) : void 0;
@@ -192,8 +219,10 @@ var RelayReferenceMarker = /*#__PURE__*/function () {
   };
 
   _proto._traverseModuleImport = function _traverseModuleImport(moduleImport, record) {
+    var _this$_operationName;
+
     var operationLoader = this._operationLoader;
-    !(operationLoader !== null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReferenceMarker: Expected an operationLoader to be configured when using `@module`.') : invariant(false) : void 0;
+    !(operationLoader !== null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayReferenceMarker: Expected an operationLoader to be configured when using `@module`. ' + 'Could not load fragment `%s` in operation `%s`.', moduleImport.fragmentName, (_this$_operationName = this._operationName) !== null && _this$_operationName !== void 0 ? _this$_operationName : '(unknown)') : invariant(false) : void 0;
     var operationKey = getModuleOperationKey(moduleImport.documentName);
     var operationReference = RelayModernRecord.getValue(record, operationKey);
 
@@ -201,10 +230,12 @@ var RelayReferenceMarker = /*#__PURE__*/function () {
       return;
     }
 
-    var operation = operationLoader.get(operationReference);
+    var normalizationRootNode = operationLoader.get(operationReference);
+
+    if (normalizationRootNode != null) {
+      var selections = getOperation(normalizationRootNode).selections;
 
-    if (operation != null) {
-      this._traverseSelections(operation.selections, record);
+      this._traverseSelections(selections, record);
     } // Otherwise, if the operation is not available, we assume that the data
     // cannot have been processed yet and therefore isn't in the store to
     // begin with.
@@ -239,6 +270,59 @@ var RelayReferenceMarker = /*#__PURE__*/function () {
     });
   };
 
+  _proto._traverseFlightField = function _traverseFlightField(field, record) {
+    var storageKey = getStorageKey(field, this._variables);
+    var linkedID = RelayModernRecord.getLinkedRecordID(record, storageKey);
+
+    if (linkedID == null) {
+      return;
+    }
+
+    this._references.add(linkedID);
+
+    var reactFlightClientResponseRecord = this._recordSource.get(linkedID);
+
+    if (reactFlightClientResponseRecord == null) {
+      return;
+    }
+
+    var reachableQueries = RelayModernRecord.getValue(reactFlightClientResponseRecord, RelayStoreReactFlightUtils.REACT_FLIGHT_QUERIES_STORAGE_KEY);
+
+    if (!Array.isArray(reachableQueries)) {
+      return;
+    }
+
+    var operationLoader = this._operationLoader;
+    !(operationLoader !== null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'DataChecker: Expected an operationLoader to be configured when using ' + 'React Flight') : invariant(false) : void 0; // In Flight, the variables that are in scope for reachable queries aren't
+    // the same as what's in scope for the outer query.
+
+    var prevVariables = this._variables; // $FlowFixMe[incompatible-cast]
+
+    var _iterator = _createForOfIteratorHelper(reachableQueries),
+        _step;
+
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var query = _step.value;
+        this._variables = query.variables;
+        var operationReference = query.module;
+        var normalizationRootNode = operationLoader.get(operationReference);
+
+        if (normalizationRootNode != null) {
+          var operation = getOperation(normalizationRootNode);
+
+          this._traverse(operation, ROOT_ID);
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+
+    this._variables = prevVariables;
+  };
+
   return RelayReferenceMarker;
 }();
 

package/lib/store/RelayResponseNormalizer.js

@@ -14,12 +14,20 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; 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 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(o); 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 RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
 var RelayModernRecord = require('./RelayModernRecord');
 
 var RelayProfiler = require('../util/RelayProfiler');
 
+var areEqual = require("fbjs/lib/areEqual");
+
 var invariant = require("fbjs/lib/invariant");
 
 var warning = require("fbjs/lib/warning");
@@ -28,6 +36,7 @@ var _require = require('../util/RelayConcreteNode'),
     CONDITION = _require.CONDITION,
     CLIENT_EXTENSION = _require.CLIENT_EXTENSION,
     DEFER = _require.DEFER,
+    FLIGHT_FIELD = _require.FLIGHT_FIELD,
     INLINE_FRAGMENT = _require.INLINE_FRAGMENT,
     LINKED_FIELD = _require.LINKED_FIELD,
     LINKED_HANDLE = _require.LINKED_HANDLE,
@@ -44,18 +53,25 @@ var _require2 = require('./ClientID'),
 var _require3 = require('./RelayModernSelector'),
     createNormalizationSelector = _require3.createNormalizationSelector;
 
-var _require4 = require('./RelayStoreUtils'),
-    getArgumentValues = _require4.getArgumentValues,
-    getHandleStorageKey = _require4.getHandleStorageKey,
-    getModuleComponentKey = _require4.getModuleComponentKey,
-    getModuleOperationKey = _require4.getModuleOperationKey,
-    getStorageKey = _require4.getStorageKey,
-    TYPENAME_KEY = _require4.TYPENAME_KEY,
-    ROOT_ID = _require4.ROOT_ID;
-
-var _require5 = require('./TypeID'),
-    generateTypeID = _require5.generateTypeID,
-    TYPE_SCHEMA_TYPE = _require5.TYPE_SCHEMA_TYPE;
+var _require4 = require('./RelayStoreReactFlightUtils'),
+    refineToReactFlightPayloadData = _require4.refineToReactFlightPayloadData,
+    REACT_FLIGHT_QUERIES_STORAGE_KEY = _require4.REACT_FLIGHT_QUERIES_STORAGE_KEY,
+    REACT_FLIGHT_TREE_STORAGE_KEY = _require4.REACT_FLIGHT_TREE_STORAGE_KEY,
+    REACT_FLIGHT_TYPE_NAME = _require4.REACT_FLIGHT_TYPE_NAME;
+
+var _require5 = require('./RelayStoreUtils'),
+    getArgumentValues = _require5.getArgumentValues,
+    getHandleStorageKey = _require5.getHandleStorageKey,
+    getModuleComponentKey = _require5.getModuleComponentKey,
+    getModuleOperationKey = _require5.getModuleOperationKey,
+    getStorageKey = _require5.getStorageKey,
+    TYPENAME_KEY = _require5.TYPENAME_KEY,
+    ROOT_ID = _require5.ROOT_ID,
+    ROOT_TYPE = _require5.ROOT_TYPE;
+
+var _require6 = require('./TypeID'),
+    generateTypeID = _require6.generateTypeID,
+    TYPE_SCHEMA_TYPE = _require6.TYPE_SCHEMA_TYPE;
 
 /**
  * Normalizes the results of a query and standard GraphQL response, writing the
@@ -87,6 +103,7 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
     this._path = options.path ? (0, _toConsumableArray2["default"])(options.path) : [];
     this._recordSource = recordSource;
     this._variables = variables;
+    this._reactFlightPayloadDeserializer = options.reactFlightPayloadDeserializer;
   }
 
   var _proto = RelayResponseNormalizer.prototype;
@@ -252,6 +269,15 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
           this._isClientExtension = isClientExtension;
           break;
 
+        case FLIGHT_FIELD:
+          if (RelayFeatureFlags.ENABLE_REACT_FLIGHT_COMPONENT_FIELD) {
+            this._normalizeFlightField(node, selection, record, data);
+          } else {
+            throw new Error('Flight fields are not yet supported.');
+          }
+
+          break;
+
         default:
           selection;
           !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayResponseNormalizer(): Unexpected ast kind `%s`.', selection.kind) : invariant(false) : void 0;
@@ -366,8 +392,10 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
         }
       }
 
-      if (selection.kind === SCALAR_FIELD && process.env.NODE_ENV !== "production") {
-        this._validateConflictingFieldsWithIdenticalId(record, storageKey, fieldValue);
+      if (process.env.NODE_ENV !== "production") {
+        if (selection.kind === SCALAR_FIELD) {
+          this._validateConflictingFieldsWithIdenticalId(record, storageKey, fieldValue);
+        }
       }
 
       RelayModernRecord.setValue(record, storageKey, null);
@@ -375,7 +403,9 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
     }
 
     if (selection.kind === SCALAR_FIELD) {
-      this._validateConflictingFieldsWithIdenticalId(record, storageKey, fieldValue);
+      if (process.env.NODE_ENV !== "production") {
+        this._validateConflictingFieldsWithIdenticalId(record, storageKey, fieldValue);
+      }
 
       RelayModernRecord.setValue(record, storageKey, fieldValue);
     } else if (selection.kind === LINKED_FIELD) {
@@ -394,6 +424,70 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
     }
   };
 
+  _proto._normalizeFlightField = function _normalizeFlightField(parent, selection, record, data) {
+    var responseKey = selection.alias || selection.name;
+    var storageKey = getStorageKey(selection, this._variables);
+    var fieldValue = data[responseKey];
+
+    if (fieldValue == null) {
+      RelayModernRecord.setValue(record, storageKey, null);
+      return;
+    }
+
+    var reactFlightPayload = refineToReactFlightPayloadData(fieldValue);
+    !(reactFlightPayload != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayResponseNormalizer(): Expected React Flight payload data ' + 'to be an object with `tree` and `queries` properties, got `%s`.', fieldValue) : invariant(false) : void 0;
+    !(typeof this._reactFlightPayloadDeserializer === 'function') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayResponseNormalizer: Expected reactFlightPayloadDeserializer to ' + 'be a function, got `%s`.', this._reactFlightPayloadDeserializer) : invariant(false) : void 0; // We store the deserialized reactFlightClientResponse in a separate
+    // record and link it to the parent record. This is so we can GC the Flight
+    // tree later even if the parent record is still reachable.
+
+    var reactFlightClientResponse = this._reactFlightPayloadDeserializer(reactFlightPayload.tree);
+
+    var reactFlightID = generateClientID(RelayModernRecord.getDataID(record), getStorageKey(selection, this._variables));
+
+    var reactFlightClientResponseRecord = this._recordSource.get(reactFlightID);
+
+    if (reactFlightClientResponseRecord == null) {
+      reactFlightClientResponseRecord = RelayModernRecord.create(reactFlightID, REACT_FLIGHT_TYPE_NAME);
+
+      this._recordSource.set(reactFlightID, reactFlightClientResponseRecord);
+    }
+
+    RelayModernRecord.setValue(reactFlightClientResponseRecord, REACT_FLIGHT_TREE_STORAGE_KEY, reactFlightClientResponse);
+    var reachableQueries = [];
+
+    var _iterator = _createForOfIteratorHelper(reactFlightPayload.queries),
+        _step;
+
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var query = _step.value;
+
+        if (query.response.data != null) {
+          this._moduleImportPayloads.push({
+            data: query.response.data,
+            dataID: ROOT_ID,
+            operationReference: query.module,
+            path: [],
+            typeName: ROOT_TYPE,
+            variables: query.variables
+          });
+        }
+
+        reachableQueries.push({
+          module: query.module,
+          variables: query.variables
+        });
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+
+    RelayModernRecord.setValue(reactFlightClientResponseRecord, REACT_FLIGHT_QUERIES_STORAGE_KEY, reachableQueries);
+    RelayModernRecord.setLinkedRecordID(record, storageKey, reactFlightID);
+  };
+
   _proto._normalizeLink = function _normalizeLink(field, record, storageKey, fieldValue) {
     var _field$concreteType;
 
@@ -463,10 +557,14 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
         _this._recordSource.set(nextID, nextRecord);
       } else if (process.env.NODE_ENV !== "production") {
         _this._validateRecordType(nextRecord, field, item);
-      }
+      } // NOTE: the check to strip __DEV__ code only works for simple
+      // `if (__DEV__)`
 
-      if (prevIDs && process.env.NODE_ENV !== "production") {
-        _this._validateConflictingLinkedFieldsWithIdenticalId(record, prevIDs[nextIndex], nextID, storageKey);
+
+      if (process.env.NODE_ENV !== "production") {
+        if (prevIDs) {
+          _this._validateConflictingLinkedFieldsWithIdenticalId(record, prevIDs[nextIndex], nextID, storageKey);
+        }
       } // $FlowFixMe[incompatible-variance]
 
 
@@ -494,10 +592,11 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
   ;
 
   _proto._validateConflictingFieldsWithIdenticalId = function _validateConflictingFieldsWithIdenticalId(record, storageKey, fieldValue) {
+    // NOTE: Only call this function in DEV
     if (process.env.NODE_ENV !== "production") {
       var dataID = RelayModernRecord.getDataID(record);
       var previousValue = RelayModernRecord.getValue(record, storageKey);
-      process.env.NODE_ENV !== "production" ? warning(storageKey === TYPENAME_KEY || previousValue === undefined || previousValue === fieldValue, 'RelayResponseNormalizer: Invalid record. The record contains two ' + 'instances of the same id: `%s` with conflicting field, %s and its values: %s and %s. ' + 'If two fields are different but share ' + 'the same id, one field will overwrite the other.', dataID, storageKey, previousValue, fieldValue) : void 0;
+      process.env.NODE_ENV !== "production" ? warning(storageKey === TYPENAME_KEY || previousValue === undefined || areEqual(previousValue, fieldValue), 'RelayResponseNormalizer: Invalid record. The record contains two ' + 'instances of the same id: `%s` with conflicting field, %s and its values: %s and %s. ' + 'If two fields are different but share ' + 'the same id, one field will overwrite the other.', dataID, storageKey, previousValue, fieldValue) : void 0;
     }
   }
   /**
@@ -506,6 +605,7 @@ var RelayResponseNormalizer = /*#__PURE__*/function () {
   ;
 
   _proto._validateConflictingLinkedFieldsWithIdenticalId = function _validateConflictingLinkedFieldsWithIdenticalId(record, prevID, nextID, storageKey) {
+    // NOTE: Only call this function in DEV
     if (process.env.NODE_ENV !== "production") {
       process.env.NODE_ENV !== "production" ? warning(prevID === undefined || prevID === nextID, 'RelayResponseNormalizer: Invalid record. The record contains ' + 'references to the conflicting field, %s and its id values: %s and %s. ' + 'We need to make sure that the record the field points ' + 'to remains consistent or one field will overwrite the other.', storageKey, prevID, nextID) : void 0;
     }

package/lib/store/RelayStoreReactFlightUtils.js

@@ -0,0 +1,47 @@
+/**
+ * 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 invariant = require("fbjs/lib/invariant");
+
+var _require = require('./RelayModernRecord'),
+    getType = _require.getType;
+
+var REACT_FLIGHT_QUERIES_STORAGE_KEY = 'queries';
+var REACT_FLIGHT_TREE_STORAGE_KEY = 'tree';
+var REACT_FLIGHT_TYPE_NAME = 'ReactFlightComponent';
+
+function refineToReactFlightPayloadData(payload) {
+  if (payload == null || typeof payload !== 'object' || !Array.isArray(payload.tree) || !Array.isArray(payload.queries)) {
+    return null;
+  }
+
+  return payload;
+}
+
+function getReactFlightClientResponse(record) {
+  !(getType(record) === REACT_FLIGHT_TYPE_NAME) ? process.env.NODE_ENV !== "production" ? invariant(false, 'getReactFlightClientResponse(): Expected a ReactFlightComponentRecord, ' + 'got %s.', record) : invariant(false) : void 0;
+  var response = record[REACT_FLIGHT_TREE_STORAGE_KEY];
+
+  if (response != null) {
+    return response;
+  }
+
+  return null;
+}
+
+module.exports = {
+  REACT_FLIGHT_QUERIES_STORAGE_KEY: REACT_FLIGHT_QUERIES_STORAGE_KEY,
+  REACT_FLIGHT_TREE_STORAGE_KEY: REACT_FLIGHT_TREE_STORAGE_KEY,
+  REACT_FLIGHT_TYPE_NAME: REACT_FLIGHT_TYPE_NAME,
+  getReactFlightClientResponse: getReactFlightClientResponse,
+  refineToReactFlightPayloadData: refineToReactFlightPayloadData
+};

package/lib/store/defaultRequiredFieldLogger.js

@@ -0,0 +1,18 @@
+/**
+ * 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
+ */
+'use strict';
+
+var defaultRequiredFieldLogger = function defaultRequiredFieldLogger(event) {
+  if (process.env.NODE_ENV !== "production" && event.kind === 'missing_field.log') {
+    throw new Error('Relay Environment Configuration Error (dev only): `@required(action: LOG)` requires that the Relay Environment be configured with a `requiredFieldLogger`.');
+  }
+};
+
+module.exports = defaultRequiredFieldLogger;

package/lib/store/normalizeRelayPayload.js

@@ -31,7 +31,7 @@ function normalizeRelayPayload(selector, payload, errors, options) {
   var source = RelayRecordSource.create();
   source.set(selector.dataID, RelayModernRecord.create(selector.dataID, ROOT_TYPE));
   var relayPayload = RelayResponseNormalizer.normalize(source, selector, payload, options);
-  return _objectSpread({}, relayPayload, {
+  return _objectSpread(_objectSpread({}, relayPayload), {}, {
     errors: errors
   });
 }

package/lib/subscription/requestSubscription.js

@@ -33,7 +33,7 @@ function requestSubscription(environment, config) {
       onNext = config.onNext,
       variables = config.variables,
       cacheConfig = config.cacheConfig;
-  var operation = createOperationDescriptor(subscription, variables);
+  var operation = createOperationDescriptor(subscription, variables, cacheConfig);
   process.env.NODE_ENV !== "production" ? warning(!(config.updater && configs), 'requestSubscription: Expected only one of `updater` and `configs` to be provided') : void 0;
 
   var _ref = configs ? RelayDeclarativeMutationConfig.convert(configs, subscription, null
@@ -43,8 +43,7 @@ function requestSubscription(environment, config) {
 
   var sub = environment.execute({
     operation: operation,
-    updater: updater,
-    cacheConfig: cacheConfig
+    updater: updater
   }).map(function () {
     var data = environment.lookup(operation.fragment).data; // $FlowFixMe[incompatible-cast]
 

package/lib/util/NormalizationNode.js

@@ -8,8 +8,4 @@
  * @format
  */
 // flowlint ambiguous-object-type:error
-'use strict';
-/**
- * Represents a single operation used to processing and normalize runtime
- * request results.
- */
+'use strict';

package/lib/util/RelayConcreteNode.js

@@ -28,6 +28,7 @@ var RelayConcreteNode = {
   CLIENT_EXTENSION: 'ClientExtension',
   DEFER: 'Defer',
   CONNECTION: 'Connection',
+  FLIGHT_FIELD: 'FlightField',
   FRAGMENT: 'Fragment',
   FRAGMENT_SPREAD: 'FragmentSpread',
   INLINE_DATA_FRAGMENT_SPREAD: 'InlineDataFragmentSpread',
@@ -39,6 +40,7 @@ var RelayConcreteNode = {
   LIST_VALUE: 'ListValue',
   LOCAL_ARGUMENT: 'LocalArgument',
   MODULE_IMPORT: 'ModuleImport',
+  REQUIRED_FIELD: 'RequiredField',
   OBJECT_VALUE: 'ObjectValue',
   OPERATION: 'Operation',
   REQUEST: 'Request',

package/lib/util/RelayFeatureFlags.js

@@ -11,10 +11,13 @@
 'use strict';
 
 var RelayFeatureFlags = {
-  // T45504512: new connection model
   ENABLE_VARIABLE_CONNECTION_KEY: false,
   ENABLE_PARTIAL_RENDERING_DEFAULT: false,
   ENABLE_RELAY_CONTAINERS_SUSPENSE: false,
-  ENABLE_PRECISE_TYPE_REFINEMENT: false
+  ENABLE_PRECISE_TYPE_REFINEMENT: false,
+  ENABLE_REACT_FLIGHT_COMPONENT_FIELD: false,
+  ENABLE_REQUIRED_DIRECTIVES: false,
+  ENABLE_GETFRAGMENTIDENTIFIER_OPTIMIZATION: false,
+  ENABLE_FRIENDLY_QUERY_NAME_GQL_URL: false
 };
 module.exports = RelayFeatureFlags;

package/lib/util/getFragmentIdentifier.js

@@ -11,6 +11,10 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+var RelayFeatureFlags = require('./RelayFeatureFlags');
+
+var isEmptyObject = require('./isEmptyObject');
+
 var stableCopy = require('./stableCopy');
 
 var _require = require('../store/RelayModernSelector'),
@@ -19,15 +23,20 @@ var _require = require('../store/RelayModernSelector'),
     getSelector = _require.getSelector;
 
 function getFragmentIdentifier(fragmentNode, fragmentRef) {
-  var _JSON$stringify;
-
   var selector = getSelector(fragmentNode, fragmentRef);
   var fragmentOwnerIdentifier = selector == null ? 'null' : selector.kind === 'SingularReaderSelector' ? selector.owner.identifier : '[' + selector.selectors.map(function (sel) {
     return sel.owner.identifier;
   }).join(',') + ']';
   var fragmentVariables = getVariablesFromFragment(fragmentNode, fragmentRef);
   var dataIDs = getDataIDsFromFragment(fragmentNode, fragmentRef);
-  return fragmentOwnerIdentifier + '/' + fragmentNode.name + '/' + JSON.stringify(stableCopy(fragmentVariables)) + '/' + ((_JSON$stringify = JSON.stringify(dataIDs)) !== null && _JSON$stringify !== void 0 ? _JSON$stringify : 'missing');
+
+  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);
+  } 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');
+  }
 }
 
 module.exports = getFragmentIdentifier;

package/lib/util/getOperation.js

@@ -0,0 +1,33 @@
+/**
+ * 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
+ * @emails oncall+relay
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+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:
+      return node.operation;
+
+    case SPLIT_OPERATION:
+    default:
+      return node;
+  }
+}
+
+module.exports = getOperation;

package/lib/util/isEmptyObject.js

@@ -0,0 +1,25 @@
+/**
+ * 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
+ * @emails oncall+relay
+ */
+'use strict';
+
+var hasOwnProperty = Object.prototype.hasOwnProperty;
+
+function isEmptyObject(obj) {
+  for (var _key in obj) {
+    if (hasOwnProperty.call(obj, _key)) {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+module.exports = isEmptyObject;

package/lib/util/recycleNodesInto.js

@@ -9,12 +9,15 @@
  */
 // flowlint ambiguous-object-type:error
 'use strict';
+
+var hasWeakSetDefined = typeof WeakSet !== 'undefined';
+var hasWeakMapDefined = typeof WeakMap !== 'undefined';
 /**
  * Recycles subtrees from `prevData` by replacing equal subtrees in `nextData`.
  */
 
 function recycleNodesInto(prevData, nextData) {
-  if (prevData === nextData || typeof prevData !== 'object' || !prevData || typeof nextData !== 'object' || !nextData) {
+  if (prevData === nextData || typeof prevData !== 'object' || prevData instanceof Set || prevData instanceof Map || hasWeakSetDefined && prevData instanceof WeakSet || hasWeakMapDefined && prevData instanceof WeakMap || !prevData || typeof nextData !== 'object' || nextData instanceof Set || nextData instanceof Map || hasWeakSetDefined && nextData instanceof WeakSet || hasWeakMapDefined && nextData instanceof WeakMap || !nextData) {
     return nextData;
   }