relay-runtime 11.0.2 → 13.0.0-rc.2

package/lib/store/RelayModernEnvironment.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -15,25 +15,31 @@ 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 generateID = require('../util/generateID');
+var OperationExecutor = require('./OperationExecutor');
+
+var RelayPublishQueue = require('./RelayPublishQueue');
+
+var RelayRecordSource = require('./RelayRecordSource');
 
 var invariant = require('invariant');
 
@@ -64,7 +70,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
     this._defaultRenderPolicy = ((_config$UNSTABLE_defa = config.UNSTABLE_defaultRenderPolicy) !== null && _config$UNSTABLE_defa !== void 0 ? _config$UNSTABLE_defa : RelayFeatureFlags.ENABLE_PARTIAL_RENDERING_DEFAULT === true) ? 'partial' : 'full';
     this._operationLoader = operationLoader;
     this._operationExecutions = new Map();
-    this._network = this.__wrapNetworkWithLogObserver(config.network);
+    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._scheduler = (_config$scheduler = config.scheduler) !== null && _config$scheduler !== void 0 ? _config$scheduler : null;
@@ -73,33 +79,26 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
     this._isServer = (_config$isServer = config.isServer) !== null && _config$isServer !== void 0 ? _config$isServer : false;
 
     this.__setNet = function (newNet) {
-      return _this._network = _this.__wrapNetworkWithLogObserver(newNet);
+      return _this._network = wrapNetworkWithLogObserver(_this, newNet);
     };
 
     if (process.env.NODE_ENV !== "production") {
-      var _require = require('./StoreInspector'),
-          inspect = _require.inspect;
+      var _require2 = require('./StoreInspector'),
+          inspect = _require2.inspect;
 
       this.DEBUG_inspect = function (dataID) {
         return inspect(_this, dataID);
       };
-    } // Register this Relay Environment with Relay DevTools if it exists.
-    // Note: this must always be the last step in the constructor.
-
-
-    var _global = typeof global !== 'undefined' ? global : typeof window !== 'undefined' ? window : undefined;
-
-    var devToolsHook = _global && _global.__RELAY_DEVTOOLS_HOOK__;
-
-    if (devToolsHook) {
-      devToolsHook.registerEnvironment(this);
     }
 
     this._missingFieldHandlers = config.missingFieldHandlers;
     this._operationTracker = (_config$operationTrac = config.operationTracker) !== null && _config$operationTrac !== void 0 ? _config$operationTrac : new RelayOperationTracker();
     this._reactFlightPayloadDeserializer = reactFlightPayloadDeserializer;
     this._reactFlightServerErrorHandler = reactFlightServerErrorHandler;
-    this._shouldProcessClientComponents = config.shouldProcessClientComponents;
+    this._shouldProcessClientComponents = config.shouldProcessClientComponents; // Register this Relay Environment with Relay DevTools if it exists.
+    // Note: this must always be the last step in the constructor.
+
+    registerEnvironmentWithDevTools(this);
   }
 
   var _proto = RelayModernEnvironment.prototype;
@@ -241,9 +240,19 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
 
     var target = RelayRecordSource.create();
 
+    var source = this._store.getSource();
+
     var result = this._store.check(operation, {
-      target: target,
-      handlers: handlers
+      handlers: handlers,
+      defaultActorIdentifier: INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
+      getSourceForActor: function getSourceForActor(actorIdentifier) {
+        assertInternalActorIndentifier(actorIdentifier);
+        return source;
+      },
+      getTargetForActor: function getTargetForActor(actorIdentifier) {
+        assertInternalActorIndentifier(actorIdentifier);
+        return target;
+      }
     });
 
     if (target.size() > 0) {
@@ -268,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
@@ -279,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);
@@ -288,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
     });
   }
@@ -303,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) {
@@ -323,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);
       },
@@ -336,7 +369,7 @@ var RelayModernEnvironment = /*#__PURE__*/function () {
   /**
    * Returns an Observable of GraphQLResponse resulting from executing the
    * provided Query or Subscription operation responses, the result of which is
-   * then normalized and comitted to the publish queue.
+   * 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:
@@ -344,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;
@@ -364,103 +397,50 @@ 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({
-        getDataID: _this9._getDataID,
+        actorIdentifier: INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
+        getDataID: _this10._getDataID,
         isClientPayload: isClientPayload,
+        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,
-        publishQueue: _this9._publishQueue,
-        reactFlightPayloadDeserializer: _this9._reactFlightPayloadDeserializer,
-        reactFlightServerErrorHandler: _this9._reactFlightServerErrorHandler,
-        scheduler: _this9._scheduler,
-        shouldProcessClientComponents: _this9._shouldProcessClientComponents,
+        getPublishQueue: function getPublishQueue(actorIdentifier) {
+          assertInternalActorIndentifier(actorIdentifier);
+          return publishQueue;
+        },
+        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.
         source: createSource(),
-        store: _this9._store,
-        treatMissingFieldsAsNull: _this9._treatMissingFieldsAsNull,
+        getStore: function getStore(actorIdentifier) {
+          assertInternalActorIndentifier(actorIdentifier);
+          return store;
+        },
+        treatMissingFieldsAsNull: _this10._treatMissingFieldsAsNull,
         updater: updater
       });
       return function () {
         return executor.cancel();
       };
     });
-  }
-  /**
-   * Wraps the network with logging to ensure that network requests are
-   * always logged. Relying on each network callsite to be wrapped is
-   * untenable and will eventually lead to holes in the logging.
-   */
-  ;
-
-  _proto.__wrapNetworkWithLogObserver = function __wrapNetworkWithLogObserver(network) {
-    var that = this;
-    return {
-      execute: function execute(params, variables, cacheConfig, uploadables) {
-        var transactionID = generateID();
-        var log = that.__log;
-        var logObserver = {
-          start: function start(subscription) {
-            log({
-              name: 'network.start',
-              transactionID: transactionID,
-              params: params,
-              variables: variables,
-              cacheConfig: cacheConfig
-            });
-          },
-          next: function next(response) {
-            log({
-              name: 'network.next',
-              transactionID: transactionID,
-              response: response
-            });
-          },
-          error: function error(_error) {
-            log({
-              name: 'network.error',
-              transactionID: transactionID,
-              error: _error
-            });
-          },
-          complete: function complete() {
-            log({
-              name: 'network.complete',
-              transactionID: transactionID
-            });
-          },
-          unsubscribe: function unsubscribe() {
-            log({
-              name: 'network.unsubscribe',
-              transactionID: transactionID
-            });
-          }
-        };
-
-        var logRequestInfo = function logRequestInfo(info) {
-          log({
-            name: 'network.info',
-            transactionID: transactionID,
-            info: info
-          });
-        };
-
-        return network.execute(params, variables, cacheConfig, uploadables, logRequestInfo)["do"](logObserver);
-      }
-    };
   };
 
   return RelayModernEnvironment;

package/lib/store/RelayModernFragmentSpecResolver.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -16,28 +16,29 @@ var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/obje
 
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
-var RelayFeatureFlags = require('../util/RelayFeatureFlags');
+var getPendingOperationsForFragment = require('../util/getPendingOperationsForFragment');
 
-var areEqual = require("fbjs/lib/areEqual");
+var isScalarAndEqual = require('../util/isScalarAndEqual');
 
-var invariant = require('invariant');
+var recycleNodesInto = require('../util/recycleNodesInto');
 
-var isScalarAndEqual = require('../util/isScalarAndEqual');
+var RelayFeatureFlags = require('../util/RelayFeatureFlags');
 
 var reportMissingRequiredFields = require('../util/reportMissingRequiredFields');
 
-var warning = require("fbjs/lib/warning");
+var _require = require('./RelayModernOperationDescriptor'),
+    createRequestDescriptor = _require.createRequestDescriptor;
 
-var _require = require('../query/fetchQueryInternal'),
-    getPromiseForActiveRequest = _require.getPromiseForActiveRequest;
+var _require2 = require('./RelayModernSelector'),
+    areEqualSelectors = _require2.areEqualSelectors,
+    createReaderSelector = _require2.createReaderSelector,
+    getSelectorsFromObject = _require2.getSelectorsFromObject;
 
-var _require2 = require('./RelayModernOperationDescriptor'),
-    createRequestDescriptor = _require2.createRequestDescriptor;
+var areEqual = require("fbjs/lib/areEqual");
 
-var _require3 = require('./RelayModernSelector'),
-    areEqualSelectors = _require3.areEqualSelectors,
-    createReaderSelector = _require3.createReaderSelector,
-    getSelectorsFromObject = _require3.getSelectorsFromObject;
+var invariant = require('invariant');
+
+var warning = require("fbjs/lib/warning");
 
 /**
  * A utility for resolving and subscribing to the results of a fragment spec
@@ -129,13 +130,17 @@ var RelayModernFragmentSpecResolver = /*#__PURE__*/function () {
     return this._data;
   };
 
-  _proto.setCallback = function setCallback(callback) {
+  _proto.setCallback = function setCallback(props, callback) {
     this._callback = callback;
+
+    if (RelayFeatureFlags.ENABLE_CONTAINERS_SUBSCRIBE_ON_COMMIT === true) {
+      this.setProps(props);
+    }
   };
 
   _proto.setProps = function setProps(props) {
-    var ownedSelectors = getSelectorsFromObject(this._fragments, props);
     this._props = {};
+    var ownedSelectors = getSelectorsFromObject(this._fragments, props);
 
     for (var _key3 in ownedSelectors) {
       if (ownedSelectors.hasOwnProperty(_key3)) {
@@ -150,14 +155,14 @@ var RelayModernFragmentSpecResolver = /*#__PURE__*/function () {
           resolver = null;
         } else if (ownedSelector.kind === 'PluralReaderSelector') {
           if (resolver == null) {
-            resolver = new SelectorListResolver(this._context.environment, this._rootIsQueryRenderer, ownedSelector, this._onChange);
+            resolver = new SelectorListResolver(this._context.environment, this._rootIsQueryRenderer, ownedSelector, this._callback != null, this._onChange);
           } else {
             !(resolver instanceof SelectorListResolver) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernFragmentSpecResolver: Expected prop `%s` to always be an array.', _key3) : invariant(false) : void 0;
             resolver.setSelector(ownedSelector);
           }
         } else {
           if (resolver == null) {
-            resolver = new SelectorResolver(this._context.environment, this._rootIsQueryRenderer, ownedSelector, this._onChange);
+            resolver = new SelectorResolver(this._context.environment, this._rootIsQueryRenderer, ownedSelector, this._callback != null, this._onChange);
           } else {
             !(resolver instanceof SelectorResolver) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernFragmentSpecResolver: Expected prop `%s` to always be an object.', _key3) : invariant(false) : void 0;
             resolver.setSelector(ownedSelector);
@@ -194,7 +199,7 @@ var RelayModernFragmentSpecResolver = /*#__PURE__*/function () {
 
 
 var SelectorResolver = /*#__PURE__*/function () {
-  function SelectorResolver(environment, rootIsQueryRenderer, selector, callback) {
+  function SelectorResolver(environment, rootIsQueryRenderer, selector, subscribeOnConstruction, callback) {
     var _this2 = this;
 
     (0, _defineProperty2["default"])(this, "_onChange", function (snapshot) {
@@ -214,7 +219,14 @@ var SelectorResolver = /*#__PURE__*/function () {
     this._environment = environment;
     this._rootIsQueryRenderer = rootIsQueryRenderer;
     this._selector = selector;
-    this._subscription = environment.subscribe(_snapshot, this._onChange);
+
+    if (RelayFeatureFlags.ENABLE_CONTAINERS_SUBSCRIBE_ON_COMMIT === true) {
+      if (subscribeOnConstruction) {
+        this._subscription = environment.subscribe(_snapshot, this._onChange);
+      }
+    } else {
+      this._subscription = environment.subscribe(_snapshot, this._onChange);
+    }
   }
 
   var _proto2 = SelectorResolver.prototype;
@@ -228,9 +240,7 @@ var SelectorResolver = /*#__PURE__*/function () {
   };
 
   _proto2.resolve = function resolve() {
-    if (RelayFeatureFlags.ENABLE_RELAY_CONTAINERS_SUSPENSE === true && this._isMissingData === true) {
-      var _getPromiseForActiveR;
-
+    if (this._isMissingData === true) {
       // NOTE: This branch exists to handle the case in which:
       // - A RelayModern container is rendered as a descendant of a Relay Hook
       //   root using a "partial" renderPolicy (this means that eargerly
@@ -252,13 +262,28 @@ var SelectorResolver = /*#__PURE__*/function () {
       // This should eventually go away with something like @optional, where we only
       // suspend at specific boundaries depending on whether the boundary
       // can be fulfilled or not.
-      var promise = (_getPromiseForActiveR = getPromiseForActiveRequest(this._environment, this._selector.owner)) !== null && _getPromiseForActiveR !== void 0 ? _getPromiseForActiveR : this._environment.getOperationTracker().getPromiseForPendingOperationsAffectingOwner(this._selector.owner);
+      var pendingOperationsResult = getPendingOperationsForFragment(this._environment, this._selector.node, this._selector.owner);
+      var promise = pendingOperationsResult === null || pendingOperationsResult === void 0 ? void 0 : pendingOperationsResult.promise;
 
       if (promise != null) {
         if (this._rootIsQueryRenderer) {
           process.env.NODE_ENV !== "production" ? warning(false, 'Relay: Relay Container for fragment `%s` has missing data and ' + 'would suspend. When using features such as @defer or @module, ' + 'use `useFragment` instead of a Relay Container.', this._selector.node.name) : void 0;
         } else {
+          var _pendingOperationsRes;
+
+          var pendingOperations = (_pendingOperationsRes = pendingOperationsResult === null || pendingOperationsResult === void 0 ? void 0 : pendingOperationsResult.pendingOperations) !== null && _pendingOperationsRes !== void 0 ? _pendingOperationsRes : [];
           process.env.NODE_ENV !== "production" ? warning(false, 'Relay: Relay Container for fragment `%s` suspended. When using ' + 'features such as @defer or @module, use `useFragment` instead ' + 'of a Relay Container.', this._selector.node.name) : void 0;
+
+          this._environment.__log({
+            name: 'suspense.fragment',
+            data: this._data,
+            fragment: this._selector.node,
+            isRelayHooks: false,
+            isMissingData: this._isMissingData,
+            isPromiseCached: false,
+            pendingOperations: pendingOperations
+          });
+
           throw promise;
         }
       }
@@ -280,7 +305,7 @@ var SelectorResolver = /*#__PURE__*/function () {
 
     var snapshot = this._environment.lookup(selector);
 
-    this._data = snapshot.data;
+    this._data = recycleNodesInto(this._data, snapshot.data);
     this._isMissingData = snapshot.isMissingData;
     this._missingRequiredFields = snapshot.missingRequiredFields;
     this._selector = selector;
@@ -319,7 +344,7 @@ var SelectorResolver = /*#__PURE__*/function () {
 
 
 var SelectorListResolver = /*#__PURE__*/function () {
-  function SelectorListResolver(environment, rootIsQueryRenderer, selector, callback) {
+  function SelectorListResolver(environment, rootIsQueryRenderer, selector, subscribeOnConstruction, callback) {
     var _this3 = this;
 
     (0, _defineProperty2["default"])(this, "_onChange", function (data) {
@@ -333,6 +358,7 @@ var SelectorListResolver = /*#__PURE__*/function () {
     this._resolvers = [];
     this._stale = true;
     this._rootIsQueryRenderer = rootIsQueryRenderer;
+    this._subscribeOnConstruction = subscribeOnConstruction;
     this.setSelector(selector);
   }
 
@@ -384,7 +410,7 @@ var SelectorListResolver = /*#__PURE__*/function () {
       if (ii < this._resolvers.length) {
         this._resolvers[ii].setSelector(selectors[ii]);
       } else {
-        this._resolvers[ii] = new SelectorResolver(this._environment, this._rootIsQueryRenderer, selectors[ii], this._onChange);
+        this._resolvers[ii] = new SelectorResolver(this._environment, this._rootIsQueryRenderer, selectors[ii], this._subscribeOnConstruction, this._onChange);
       }
     }
 

package/lib/store/RelayModernOperationDescriptor.js

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

package/lib/store/RelayModernRecord.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -14,25 +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
  *
@@ -82,6 +82,8 @@ var _require2 = require('./RelayStoreUtils'),
  *
  * Clone a record.
  */
+
+
 function clone(record) {
   return (0, _objectSpread2["default"])({}, record);
 }
@@ -171,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];
 }
 /**
@@ -189,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];
 }
@@ -336,6 +338,37 @@ function setLinkedRecordIDs(record, storageKey, linkedIDs) {
   links[REFS_KEY] = linkedIDs;
   record[storageKey] = links;
 }
+/**
+ * @public
+ *
+ * Set the value of a field to a reference to another record in the actor specific store.
+ */
+
+
+function setActorLinkedRecordID(record, storageKey, actorIdentifier, linkedID) {
+  // See perf note above for why we aren't using computed property access.
+  var link = {};
+  link[REF_KEY] = linkedID;
+  link[ACTOR_IDENTIFIER_KEY] = actorIdentifier;
+  record[storageKey] = link;
+}
+/**
+ * @public
+ *
+ * Get link to a record and the actor identifier for the store.
+ */
+
+
+function getActorLinkedRecordID(record, storageKey) {
+  var link = record[storageKey];
+
+  if (link == null) {
+    return link;
+  }
+
+  !(typeof link === 'object' && typeof link[REF_KEY] === 'string' && link[ACTOR_IDENTIFIER_KEY] != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayModernRecord.getActorLinkedRecordID(): Expected `%s.%s` to be an actor specific linked ID, ' + 'was `%s`.', record[ID_KEY], storageKey, JSON.stringify(link)) : invariant(false) : void 0;
+  return [link[ACTOR_IDENTIFIER_KEY], link[REF_KEY]];
+}
 
 module.exports = {
   clone: clone,
@@ -352,5 +385,7 @@ module.exports = {
   setValue: setValue,
   setLinkedRecordID: setLinkedRecordID,
   setLinkedRecordIDs: setLinkedRecordIDs,
-  update: update
+  update: update,
+  getActorLinkedRecordID: getActorLinkedRecordID,
+  setActorLinkedRecordID: setActorLinkedRecordID
 };