relay-runtime 0.0.0-main-976e6ee5 → 0.0.0-main-ec91ebca

package/experimental.js

@@ -1,5 +1,5 @@
 /**
- * Relay v0.0.0-main-976e6ee5
+ * Relay v0.0.0-main-ec91ebca
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/index.js

@@ -1,5 +1,5 @@
 /**
- * Relay v0.0.0-main-976e6ee5
+ * Relay v0.0.0-main-ec91ebca
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/index.js.flow

@@ -147,6 +147,7 @@ export type {
   ReactFlightServerErrorHandler,
   ReaderSelector,
   ReadOnlyRecordProxy,
+  ReadOnlyRecordSourceProxy,
   RecordProxy,
   RecordSourceProxy,
   RecordSourceSelectorProxy,
@@ -271,6 +272,7 @@ module.exports = {
   createReaderSelector: RelayModernSelector.createReaderSelector,
   createRequestDescriptor:
     RelayModernOperationDescriptor.createRequestDescriptor,
+  getArgumentValues: RelayStoreUtils.getArgumentValues,
   getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
   getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
   getNode: GraphQLTag.getNode,

package/lib/index.js

@@ -156,6 +156,7 @@ module.exports = {
   createOperationDescriptor: RelayModernOperationDescriptor.createOperationDescriptor,
   createReaderSelector: RelayModernSelector.createReaderSelector,
   createRequestDescriptor: RelayModernOperationDescriptor.createRequestDescriptor,
+  getArgumentValues: RelayStoreUtils.getArgumentValues,
   getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
   getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
   getNode: GraphQLTag.getNode,

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

@@ -32,7 +32,7 @@ var ActorSpecificEnvironment = /*#__PURE__*/function () {
     this._operationTracker = new RelayOperationTracker();
     this._store = config.store;
     this._network = wrapNetworkWithLogObserver(this, config.network);
-    this._publishQueue = new RelayPublishQueue(config.store, config.handlerProvider, defaultGetDataID);
+    this._publishQueue = new RelayPublishQueue(config.store, config.handlerProvider, defaultGetDataID, config.missingFieldHandlers);
     this._defaultRenderPolicy = config.defaultRenderPolicy; // TODO:T92305692 Remove `options` in favor of directly using `actorIdentifier` on the environment
 
     this.options = {

package/lib/multi-actor-environment/MultiActorEnvironment.js

@@ -34,7 +34,7 @@ var ActorSpecificEnvironment = require('./ActorSpecificEnvironment');
 
 var MultiActorEnvironment = /*#__PURE__*/function () {
   function MultiActorEnvironment(config) {
-    var _config$getDataID, _config$logFn, _config$requiredField, _config$treatMissingF, _config$isServer, _config$defaultRender;
+    var _config$getDataID, _config$logFn, _config$requiredField, _config$treatMissingF, _config$isServer, _config$missingFieldH, _config$defaultRender;
 
     this._actorEnvironments = new Map();
     this._operationLoader = config.operationLoader;
@@ -48,7 +48,7 @@ var MultiActorEnvironment = /*#__PURE__*/function () {
     this._shouldProcessClientComponents = config.shouldProcessClientComponents;
     this._treatMissingFieldsAsNull = (_config$treatMissingF = config.treatMissingFieldsAsNull) !== null && _config$treatMissingF !== void 0 ? _config$treatMissingF : false;
     this._isServer = (_config$isServer = config.isServer) !== null && _config$isServer !== void 0 ? _config$isServer : false;
-    this._missingFieldHandlers = config.missingFieldHandlers;
+    this._missingFieldHandlers = (_config$missingFieldH = config.missingFieldHandlers) !== null && _config$missingFieldH !== void 0 ? _config$missingFieldH : [];
     this._createStoreForActor = config.createStoreForActor;
     this._reactFlightPayloadDeserializer = config.reactFlightPayloadDeserializer;
     this._reactFlightServerErrorHandler = config.reactFlightServerErrorHandler;
@@ -77,7 +77,8 @@ var MultiActorEnvironment = /*#__PURE__*/function () {
         store: this._createStoreForActor != null ? this._createStoreForActor(actorIdentifier) : new RelayModernStore(RelayRecordSource.create()),
         network: this._createNetworkForActor(actorIdentifier),
         handlerProvider: this._handlerProvider,
-        defaultRenderPolicy: this._defaultRenderPolicy
+        defaultRenderPolicy: this._defaultRenderPolicy,
+        missingFieldHandlers: this._missingFieldHandlers
       });
 
       this._actorEnvironments.set(actorIdentifier, newEnvironment);

package/lib/mutations/RelayRecordSourceProxy.js

@@ -37,13 +37,14 @@ var invariant = require('invariant');
 
 
 var RelayRecordSourceProxy = /*#__PURE__*/function () {
-  function RelayRecordSourceProxy(mutator, getDataID, handlerProvider) {
+  function RelayRecordSourceProxy(mutator, getDataID, handlerProvider, missingFieldHandlers) {
     this.__mutator = mutator;
     this._handlerProvider = handlerProvider || null;
     this._proxies = {};
     this._getDataID = getDataID;
     this._invalidatedStore = false;
     this._idsMarkedForInvalidation = new Set();
+    this._missingFieldHandlers = missingFieldHandlers;
   }
 
   var _proto = RelayRecordSourceProxy.prototype;
@@ -139,11 +140,11 @@ var RelayRecordSourceProxy = /*#__PURE__*/function () {
   };
 
   _proto.readUpdatableQuery_EXPERIMENTAL = function readUpdatableQuery_EXPERIMENTAL(query, variables) {
-    return _readUpdatableQuery_EXPERIMENTAL(query, variables, this);
+    return _readUpdatableQuery_EXPERIMENTAL(query, variables, this, this._missingFieldHandlers);
   };
 
   _proto.readUpdatableFragment_EXPERIMENTAL = function readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference) {
-    return _readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, this);
+    return _readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, this, this._missingFieldHandlers);
   };
 
   return RelayRecordSourceProxy;

package/lib/mutations/RelayRecordSourceSelectorProxy.js

@@ -32,10 +32,11 @@ var invariant = require('invariant');
 
 
 var RelayRecordSourceSelectorProxy = /*#__PURE__*/function () {
-  function RelayRecordSourceSelectorProxy(mutator, recordSource, readSelector) {
+  function RelayRecordSourceSelectorProxy(mutator, recordSource, readSelector, missingFieldHandlers) {
     this.__mutator = mutator;
     this.__recordSource = recordSource;
     this._readSelector = readSelector;
+    this._missingFieldHandlers = missingFieldHandlers;
   }
 
   var _proto = RelayRecordSourceSelectorProxy.prototype;
@@ -99,11 +100,11 @@ var RelayRecordSourceSelectorProxy = /*#__PURE__*/function () {
   };
 
   _proto.readUpdatableQuery_EXPERIMENTAL = function readUpdatableQuery_EXPERIMENTAL(query, variables) {
-    return _readUpdatableQuery_EXPERIMENTAL(query, variables, this);
+    return _readUpdatableQuery_EXPERIMENTAL(query, variables, this, this._missingFieldHandlers);
   };
 
   _proto.readUpdatableFragment_EXPERIMENTAL = function readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference) {
-    return _readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, this);
+    return _readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, this, this._missingFieldHandlers);
   };
 
   return RelayRecordSourceSelectorProxy;

package/lib/mutations/createUpdatableProxy.js

@@ -40,9 +40,9 @@ var _require2 = require('../util/RelayConcreteNode'),
 
 var nonUpdatableKeys = ['id', '__id', '__typename', 'js'];
 
-function createUpdatableProxy(updatableProxyRootRecord, variables, selections, recordSourceProxy) {
+function createUpdatableProxy(updatableProxyRootRecord, variables, selections, recordSourceProxy, missingFieldHandlers) {
   var mutableUpdatableProxy = {};
-  updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selections, recordSourceProxy);
+  updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selections, recordSourceProxy, missingFieldHandlers);
 
   if (process.env.NODE_ENV !== "production") {
     Object.freeze(mutableUpdatableProxy);
@@ -54,7 +54,7 @@ function createUpdatableProxy(updatableProxyRootRecord, variables, selections, r
   return mutableUpdatableProxy;
 }
 
-function updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selections, recordSourceProxy) {
+function updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selections, recordSourceProxy, missingFieldHandlers) {
   var _selection$alias3;
 
   var _iterator = (0, _createForOfIteratorHelper2["default"])(selections),
@@ -69,12 +69,12 @@ function updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootReco
           if (selection.plural) {
             Object.defineProperty(mutableUpdatableProxy, (_selection$alias = selection.alias) !== null && _selection$alias !== void 0 ? _selection$alias : selection.name, {
               // $FlowFixMe[incompatible-call] these getters and setters have different types on purpose
-              get: createGetterForPluralLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy),
+              get: createGetterForPluralLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers),
               set: createSetterForPluralLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy)
             });
           } else {
             Object.defineProperty(mutableUpdatableProxy, (_selection$alias2 = selection.alias) !== null && _selection$alias2 !== void 0 ? _selection$alias2 : selection.name, {
-              get: createGetterForSingularLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy),
+              get: createGetterForSingularLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers),
               set: createSetterForSingularLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy)
             });
           }
@@ -90,8 +90,14 @@ function updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootReco
               var newVariables = getArgumentValues((_selection$args = selection.args) !== null && _selection$args !== void 0 ? _selection$args : [], variables); // Flow incorrect assumes that the return value for the get method must match
               // the set parameter.
 
-              return updatableProxyRootRecord.getValue(selection.name, newVariables // $FlowFixMe[unclear-type] Typed by the generated updatable query flow type
+              var value = updatableProxyRootRecord.getValue(selection.name, newVariables // $FlowFixMe[unclear-type] Typed by the generated updatable query flow type
               );
+
+              if (value == null) {
+                value = getScalarUsingMissingFieldHandlers(selection, newVariables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers);
+              }
+
+              return value;
             },
             set: nonUpdatableKeys.includes(selection.name) ? undefined : // $FlowFixMe[unclear-type] Typed by the generated updatable query flow type
             function (newValue) {
@@ -106,13 +112,13 @@ function updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootReco
 
         case INLINE_FRAGMENT:
           if (updatableProxyRootRecord.getType() === selection.type) {
-            updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selection.selections, recordSourceProxy);
+            updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selection.selections, recordSourceProxy, missingFieldHandlers);
           }
 
           break;
 
         case CLIENT_EXTENSION:
-          updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selection.selections, recordSourceProxy);
+          updateProxyFromSelections(mutableUpdatableProxy, updatableProxyRootRecord, variables, selection.selections, recordSourceProxy, missingFieldHandlers);
           break;
 
         case FRAGMENT_SPREAD:
@@ -215,18 +221,22 @@ function createSetterForSingularLinkedField(selection, variables, updatableProxy
   };
 }
 
-function createGetterForPluralLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy) {
+function createGetterForPluralLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers) {
   return function () {
     var _selection$args5;
 
     var newVariables = getArgumentValues((_selection$args5 = selection.args) !== null && _selection$args5 !== void 0 ? _selection$args5 : [], variables);
     var linkedRecords = updatableProxyRootRecord.getLinkedRecords(selection.name, newVariables);
 
+    if (linkedRecords === undefined) {
+      linkedRecords = getPluralLinkedRecordUsingMissingFieldHandlers(selection, newVariables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers);
+    }
+
     if (linkedRecords != null) {
       return linkedRecords.map(function (linkedRecord) {
         if (linkedRecord != null) {
           var updatableProxy = {};
-          updateProxyFromSelections(updatableProxy, linkedRecord, variables, selection.selections, recordSourceProxy);
+          updateProxyFromSelections(updatableProxy, linkedRecord, variables, selection.selections, recordSourceProxy, missingFieldHandlers);
 
           if (process.env.NODE_ENV !== "production") {
             Object.freeze(updatableProxy);
@@ -247,16 +257,20 @@ function createGetterForPluralLinkedField(selection, variables, updatableProxyRo
   };
 }
 
-function createGetterForSingularLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy) {
+function createGetterForSingularLinkedField(selection, variables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers) {
   return function () {
     var _selection$args6;
 
     var newVariables = getArgumentValues((_selection$args6 = selection.args) !== null && _selection$args6 !== void 0 ? _selection$args6 : [], variables);
     var linkedRecord = updatableProxyRootRecord.getLinkedRecord(selection.name, newVariables);
 
+    if (linkedRecord === undefined) {
+      linkedRecord = getLinkedRecordUsingMissingFieldHandlers(selection, newVariables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers);
+    }
+
     if (linkedRecord != null) {
       var updatableProxy = {};
-      updateProxyFromSelections(updatableProxy, linkedRecord, variables, selection.selections, recordSourceProxy);
+      updateProxyFromSelections(updatableProxy, linkedRecord, variables, selection.selections, recordSourceProxy, missingFieldHandlers);
 
       if (process.env.NODE_ENV !== "production") {
         Object.freeze(updatableProxy);
@@ -272,6 +286,79 @@ function createGetterForSingularLinkedField(selection, variables, updatableProxy
   };
 }
 
+function getLinkedRecordUsingMissingFieldHandlers(selection, newVariables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers) {
+  var _iterator2 = (0, _createForOfIteratorHelper2["default"])(missingFieldHandlers),
+      _step2;
+
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var handler = _step2.value;
+
+      if (handler.kind === 'linked') {
+        var newId = handler.handle(selection, updatableProxyRootRecord, newVariables, recordSourceProxy);
+
+        if (newId != null) {
+          return recordSourceProxy.get(newId);
+        }
+      }
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+}
+
+function getPluralLinkedRecordUsingMissingFieldHandlers(selection, newVariables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers) {
+  var _iterator3 = (0, _createForOfIteratorHelper2["default"])(missingFieldHandlers),
+      _step3;
+
+  try {
+    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+      var handler = _step3.value;
+
+      if (handler.kind === 'pluralLinked') {
+        var newIds = handler.handle(selection, updatableProxyRootRecord, newVariables, recordSourceProxy);
+
+        if (newIds != null) {
+          return newIds.map(function (newId) {
+            if (newId != null) {
+              return recordSourceProxy.get(newId);
+            }
+          });
+        }
+      }
+    }
+  } catch (err) {
+    _iterator3.e(err);
+  } finally {
+    _iterator3.f();
+  }
+}
+
+function getScalarUsingMissingFieldHandlers(selection, newVariables, updatableProxyRootRecord, recordSourceProxy, missingFieldHandlers) {
+  var _iterator4 = (0, _createForOfIteratorHelper2["default"])(missingFieldHandlers),
+      _step4;
+
+  try {
+    for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+      var handler = _step4.value;
+
+      if (handler.kind === 'scalar') {
+        var value = handler.handle(selection, updatableProxyRootRecord, newVariables, recordSourceProxy);
+
+        if (value !== undefined) {
+          return value;
+        }
+      }
+    }
+  } catch (err) {
+    _iterator4.e(err);
+  } finally {
+    _iterator4.f();
+  }
+}
+
 module.exports = {
   createUpdatableProxy: createUpdatableProxy
 };

package/lib/mutations/readUpdatableFragment_EXPERIMENTAL.js

@@ -25,7 +25,7 @@ var _require4 = require('./createUpdatableProxy'),
 var invariant = require('invariant'); // Note: plural fragment references are currently not supported
 
 
-function readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, proxy) {
+function readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, proxy, missingFieldHandlers) {
   var updatableFragment = getFragment(fragment);
   var fragmentVariables = getVariablesFromFragment(updatableFragment, fragmentReference); // $FlowFixMe[prop-missing] it's there, we just don't include it in the type
 
@@ -33,7 +33,7 @@ function readUpdatableFragment_EXPERIMENTAL(fragment, fragmentReference, proxy)
   var fragmentRoot = proxy.get(id);
   !(fragmentRoot != null) ? process.env.NODE_ENV !== "production" ? invariant(false, "No record with ".concat(id, " was found. This likely indicates a problem with Relay.")) : invariant(false) : void 0;
   return {
-    updatableData: createUpdatableProxy(fragmentRoot, fragmentVariables, updatableFragment.selections, proxy)
+    updatableData: createUpdatableProxy(fragmentRoot, fragmentVariables, updatableFragment.selections, proxy, missingFieldHandlers)
   };
 }
 

package/lib/mutations/readUpdatableQuery_EXPERIMENTAL.js

@@ -16,10 +16,10 @@ var _require = require('../query/GraphQLTag'),
 var _require2 = require('./createUpdatableProxy'),
     createUpdatableProxy = _require2.createUpdatableProxy;
 
-function readUpdatableQuery_EXPERIMENTAL(query, variables, proxy) {
+function readUpdatableQuery_EXPERIMENTAL(query, variables, proxy, missingFieldHandlers) {
   var updatableQuery = getUpdatableQuery(query);
   return {
-    updatableData: createUpdatableProxy(proxy.getRoot(), variables, updatableQuery.fragment.selections, proxy)
+    updatableData: createUpdatableProxy(proxy.getRoot(), variables, updatableQuery.fragment.selections, proxy, missingFieldHandlers)
   };
 }
 

package/lib/store/DataChecker.js

@@ -124,7 +124,7 @@ var DataChecker = /*#__PURE__*/function () {
       var target = this._getTargetForActor(actorIdentifier);
 
       var mutator = new RelayRecordSourceMutator(this._getSourceForActor(actorIdentifier), target);
-      var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID);
+      var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID, undefined, this._handlers);
       tuple = [mutator, recordSourceProxy];
 
       this._mutatorRecordSourceProxyCache.set(actorIdentifier, tuple);
@@ -156,29 +156,12 @@ var DataChecker = /*#__PURE__*/function () {
     this._recordWasMissing = true;
   };
 
-  _proto._getDataForHandlers = function _getDataForHandlers(field, dataID) {
-    return {
-      /* $FlowFixMe[class-object-subtyping] added when improving typing for
-       * this parameters */
-      args: field.args ? getArgumentValues(field.args, this._variables) : {},
-      // Getting a snapshot of the record state is potentially expensive since
-      // we will need to merge the sink and source records. Since we do not create
-      // any new records in this process, it is probably reasonable to provide
-      // handlers with a copy of the source record.
-      // The only thing that the provided record will not contain is fields
-      // added by previous handlers.
-      record: this._source.get(dataID)
-    };
-  };
-
   _proto._handleMissingScalarField = function _handleMissingScalarField(field, dataID) {
     if (field.name === 'id' && field.alias == null && isClientID(dataID)) {
       return undefined;
     }
 
-    var _this$_getDataForHand = this._getDataForHandlers(field, dataID),
-        args = _this$_getDataForHand.args,
-        record = _this$_getDataForHand.record;
+    var args = field.args != undefined ? getArgumentValues(field.args, this._variables) : {};
 
     var _iterator = (0, _createForOfIteratorHelper2["default"])(this._handlers),
         _step;
@@ -188,7 +171,7 @@ var DataChecker = /*#__PURE__*/function () {
         var handler = _step.value;
 
         if (handler.kind === 'scalar') {
-          var newValue = handler.handle(field, record, args, this._recordSourceProxy);
+          var newValue = handler.handle(field, this._recordSourceProxy.get(dataID), args, this._recordSourceProxy);
 
           if (newValue !== undefined) {
             return newValue;
@@ -205,9 +188,7 @@ var DataChecker = /*#__PURE__*/function () {
   };
 
   _proto._handleMissingLinkField = function _handleMissingLinkField(field, dataID) {
-    var _this$_getDataForHand2 = this._getDataForHandlers(field, dataID),
-        args = _this$_getDataForHand2.args,
-        record = _this$_getDataForHand2.record;
+    var args = field.args != undefined ? getArgumentValues(field.args, this._variables) : {};
 
     var _iterator2 = (0, _createForOfIteratorHelper2["default"])(this._handlers),
         _step2;
@@ -217,7 +198,7 @@ var DataChecker = /*#__PURE__*/function () {
         var handler = _step2.value;
 
         if (handler.kind === 'linked') {
-          var newValue = handler.handle(field, record, args, this._recordSourceProxy);
+          var newValue = handler.handle(field, this._recordSourceProxy.get(dataID), args, this._recordSourceProxy);
 
           if (newValue !== undefined && (newValue === null || this._mutator.getStatus(newValue) === EXISTENT)) {
             return newValue;
@@ -236,9 +217,7 @@ var DataChecker = /*#__PURE__*/function () {
   _proto._handleMissingPluralLinkField = function _handleMissingPluralLinkField(field, dataID) {
     var _this = this;
 
-    var _this$_getDataForHand3 = this._getDataForHandlers(field, dataID),
-        args = _this$_getDataForHand3.args,
-        record = _this$_getDataForHand3.record;
+    var args = field.args != undefined ? getArgumentValues(field.args, this._variables) : {};
 
     var _iterator3 = (0, _createForOfIteratorHelper2["default"])(this._handlers),
         _step3;
@@ -248,7 +227,7 @@ var DataChecker = /*#__PURE__*/function () {
         var handler = _step3.value;
 
         if (handler.kind === 'pluralLinked') {
-          var newValue = handler.handle(field, record, args, this._recordSourceProxy);
+          var newValue = handler.handle(field, this._recordSourceProxy.get(dataID), args, this._recordSourceProxy);
 
           if (newValue != null) {
             var allItemsKnown = newValue.every(function (linkedID) {

package/lib/store/RelayModernEnvironment.js

@@ -46,7 +46,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
   function RelayModernEnvironment(config) {
     var _this = this;
 
-    var _config$log, _config$requiredField, _config$UNSTABLE_defa, _config$getDataID, _config$handlerProvid, _config$scheduler, _config$isServer, _config$missingFieldH, _config$operationTrac;
+    var _config$log, _config$requiredField, _config$UNSTABLE_defa, _config$getDataID, _config$missingFieldH, _config$handlerProvid, _config$scheduler, _config$isServer, _config$operationTrac;
 
     this.configName = config.configName;
     this._treatMissingFieldsAsNull = config.treatMissingFieldsAsNull === true;
@@ -71,7 +71,8 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
     this._operationExecutions = new Map();
     this._network = wrapNetworkWithLogObserver(this, config.network);
     this._getDataID = (_config$getDataID = config.getDataID) !== null && _config$getDataID !== void 0 ? _config$getDataID : defaultGetDataID;
-    this._publishQueue = new RelayPublishQueue(config.store, (_config$handlerProvid = config.handlerProvider) !== null && _config$handlerProvid !== void 0 ? _config$handlerProvid : RelayDefaultHandlerProvider, this._getDataID);
+    this._missingFieldHandlers = (_config$missingFieldH = config.missingFieldHandlers) !== null && _config$missingFieldH !== void 0 ? _config$missingFieldH : [];
+    this._publishQueue = new RelayPublishQueue(config.store, (_config$handlerProvid = config.handlerProvider) !== null && _config$handlerProvid !== void 0 ? _config$handlerProvid : RelayDefaultHandlerProvider, this._getDataID, this._missingFieldHandlers);
     this._scheduler = (_config$scheduler = config.scheduler) !== null && _config$scheduler !== void 0 ? _config$scheduler : null;
     this._store = config.store;
     this.options = config.options;
@@ -90,7 +91,6 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
       };
     }
 
-    this._missingFieldHandlers = (_config$missingFieldH = config.missingFieldHandlers) !== null && _config$missingFieldH !== void 0 ? _config$missingFieldH : [];
     this._operationTracker = (_config$operationTrac = config.operationTracker) !== null && _config$operationTrac !== void 0 ? _config$operationTrac : new RelayOperationTracker();
     this._reactFlightPayloadDeserializer = reactFlightPayloadDeserializer;
     this._reactFlightServerErrorHandler = reactFlightServerErrorHandler;

package/lib/store/RelayPublishQueue.js

@@ -57,7 +57,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
   // 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) {
+  function RelayPublishQueue(store, handlerProvider, getDataID, missingFieldHandlers) {
     this._hasStoreSnapshot = false;
     this._handlerProvider = handlerProvider || null;
     this._pendingBackupRebase = false;
@@ -67,6 +67,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
     this._appliedOptimisticUpdates = new Set();
     this._gcHold = null;
     this._getDataID = getDataID;
+    this._missingFieldHandlers = missingFieldHandlers;
   }
   /**
    * Schedule applying an optimistic updates on the next `run()`.
@@ -232,7 +233,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
     var source = payload.source,
         fieldPayloads = payload.fieldPayloads;
     var mutator = new RelayRecordSourceMutator(this._store.getSource(), source);
-    var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID);
+    var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID, this._handlerProvider, this._missingFieldHandlers);
 
     if (fieldPayloads && fieldPayloads.length) {
       fieldPayloads.forEach(function (fieldPayload) {
@@ -246,7 +247,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
     if (updater) {
       var selector = operation.fragment;
       !(selector != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernEnvironment: Expected a selector to be provided with updater function.') : invariant(false) : void 0;
-      var recordSourceSelectorProxy = new RelayRecordSourceSelectorProxy(mutator, recordSourceProxy, selector);
+      var recordSourceSelectorProxy = new RelayRecordSourceSelectorProxy(mutator, recordSourceProxy, selector, this._missingFieldHandlers);
       var selectorData = lookupSelector(source, selector);
       updater(recordSourceSelectorProxy, selectorData);
     }
@@ -285,7 +286,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
         var updater = data.updater;
         var sink = RelayRecordSource.create();
         var mutator = new RelayRecordSourceMutator(_this2._store.getSource(), sink);
-        var recordSourceProxy = new RelayRecordSourceProxy(mutator, _this2._getDataID);
+        var recordSourceProxy = new RelayRecordSourceProxy(mutator, _this2._getDataID, _this2._handlerProvider, _this2._missingFieldHandlers);
         applyWithGuard(updater, null, [recordSourceProxy], null, 'RelayPublishQueue:commitData');
         invalidatedStore = invalidatedStore || recordSourceProxy.isStoreMarkedForInvalidation();
         var idsMarkedForInvalidation = recordSourceProxy.getIDsMarkedForInvalidation();
@@ -310,7 +311,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); // $FlowFixMe[unclear-type] see explanation above.
+    var recordSourceProxy = new RelayRecordSourceProxy(mutator, this._getDataID, this._handlerProvider, this._missingFieldHandlers); // $FlowFixMe[unclear-type] see explanation above.
 
     var processUpdate = function processUpdate(optimisticUpdate) {
       if (optimisticUpdate.storeUpdater) {
@@ -334,7 +335,7 @@ var RelayPublishQueue = /*#__PURE__*/function () {
             selectorData = lookupSelector(source, operation.fragment);
           }
 
-          var recordSourceSelectorProxy = new RelayRecordSourceSelectorProxy(mutator, recordSourceProxy, operation.fragment);
+          var recordSourceSelectorProxy = new RelayRecordSourceSelectorProxy(mutator, recordSourceProxy, operation.fragment, _this3._missingFieldHandlers);
           applyWithGuard(updater, null, [recordSourceSelectorProxy, selectorData], null, 'RelayPublishQueue:applyUpdates');
         }
       }

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

@@ -17,6 +17,7 @@ import type {INetwork} from '../network/RelayNetworkTypes';
 import type RelayObservable from '../network/RelayObservable';
 import type {
   ExecuteMutationConfig,
+  MissingFieldHandler,
   LogFunction,
   MutationParameters,
   OperationAvailability,
@@ -54,6 +55,7 @@ export type ActorSpecificEnvironmentConfig = $ReadOnly<{
   network: INetwork,
   requiredFieldLogger: RequiredFieldLogger,
   store: Store,
+  missingFieldHandlers: $ReadOnlyArray<MissingFieldHandler>,
 }>;
 
 class ActorSpecificEnvironment implements IActorEnvironment {
@@ -83,6 +85,7 @@ class ActorSpecificEnvironment implements IActorEnvironment {
       config.store,
       config.handlerProvider,
       defaultGetDataID,
+      config.missingFieldHandlers,
     );
     this._defaultRenderPolicy = config.defaultRenderPolicy;
     // TODO:T92305692 Remove `options` in favor of directly using `actorIdentifier` on the environment

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

@@ -83,7 +83,7 @@ class MultiActorEnvironment implements IMultiActorEnvironment {
   +_handlerProvider: HandlerProvider;
   +_isServer: boolean;
   +_logFn: LogFunction;
-  +_missingFieldHandlers: ?$ReadOnlyArray<MissingFieldHandler>;
+  +_missingFieldHandlers: $ReadOnlyArray<MissingFieldHandler>;
   +_operationExecutions: Map<string, ActiveState>;
   +_operationLoader: ?OperationLoader;
   +_reactFlightPayloadDeserializer: ?ReactFlightPayloadDeserializer;
@@ -109,7 +109,7 @@ class MultiActorEnvironment implements IMultiActorEnvironment {
     this._shouldProcessClientComponents = config.shouldProcessClientComponents;
     this._treatMissingFieldsAsNull = config.treatMissingFieldsAsNull ?? false;
     this._isServer = config.isServer ?? false;
-    this._missingFieldHandlers = config.missingFieldHandlers;
+    this._missingFieldHandlers = config.missingFieldHandlers ?? [];
     this._createStoreForActor = config.createStoreForActor;
     this._reactFlightPayloadDeserializer =
       config.reactFlightPayloadDeserializer;
@@ -141,6 +141,7 @@ class MultiActorEnvironment implements IMultiActorEnvironment {
         network: this._createNetworkForActor(actorIdentifier),
         handlerProvider: this._handlerProvider,
         defaultRenderPolicy: this._defaultRenderPolicy,
+        missingFieldHandlers: this._missingFieldHandlers,
       });
       this._actorEnvironments.set(actorIdentifier, newEnvironment);
       return newEnvironment;

package/mutations/RelayRecordSourceProxy.js.flow

@@ -22,6 +22,7 @@ import type {
   RecordSource,
   RecordSourceProxy,
   UpdatableData,
+  MissingFieldHandler,
 } from '../store/RelayStoreTypes';
 import type {
   DataID,
@@ -55,11 +56,13 @@ class RelayRecordSourceProxy implements RecordSourceProxy {
   _getDataID: GetDataID;
   _invalidatedStore: boolean;
   _idsMarkedForInvalidation: DataIDSet;
+  _missingFieldHandlers: $ReadOnlyArray<MissingFieldHandler>;
 
   constructor(
     mutator: RelayRecordSourceMutator,
     getDataID: GetDataID,
     handlerProvider?: ?HandlerProvider,
+    missingFieldHandlers: $ReadOnlyArray<MissingFieldHandler>,
   ) {
     this.__mutator = mutator;
     this._handlerProvider = handlerProvider || null;
@@ -67,6 +70,7 @@ class RelayRecordSourceProxy implements RecordSourceProxy {
     this._getDataID = getDataID;
     this._invalidatedStore = false;
     this._idsMarkedForInvalidation = new Set();
+    this._missingFieldHandlers = missingFieldHandlers;
   }
 
   publishSource(
@@ -176,7 +180,12 @@ class RelayRecordSourceProxy implements RecordSourceProxy {
     query: UpdatableQuery<TVariables, TData>,
     variables: TVariables,
   ): UpdatableData<TData> {
-    return readUpdatableQuery_EXPERIMENTAL(query, variables, this);
+    return readUpdatableQuery_EXPERIMENTAL(
+      query,
+      variables,
+      this,
+      this._missingFieldHandlers,
+    );
   }
 
   readUpdatableFragment_EXPERIMENTAL<TFragmentType: FragmentType, TData>(
@@ -187,6 +196,7 @@ class RelayRecordSourceProxy implements RecordSourceProxy {
       fragment,
       fragmentReference,
       this,
+      this._missingFieldHandlers,
     );
   }
 }