relay-runtime 11.0.2 → 12.0.0

package/index.js

@@ -1,5 +1,5 @@
 /**
- * Relay v11.0.2
+ * Relay v12.0.0
  *
  * Copyright (c) Facebook, Inc. and its affiliates.
  *

package/index.js.flow

@@ -50,8 +50,13 @@ const fetchQuery = require('./query/fetchQuery');
 const fetchQueryInternal = require('./query/fetchQueryInternal');
 const fetchQuery_DEPRECATED = require('./query/fetchQuery_DEPRECATED');
 const getFragmentIdentifier = require('./util/getFragmentIdentifier');
+const getPaginationMetadata = require('./util/getPaginationMetadata');
+const getPaginationVariables = require('./util/getPaginationVariables');
+const getPendingOperationsForFragment = require('./util/getPendingOperationsForFragment');
+const getRefetchMetadata = require('./util/getRefetchMetadata');
 const getRelayHandleKey = require('./util/getRelayHandleKey');
 const getRequestIdentifier = require('./util/getRequestIdentifier');
+const getValueAtPath = require('./util/getValueAtPath');
 const isPromise = require('./util/isPromise');
 const isRelayModernEnvironment = require('./store/isRelayModernEnvironment');
 const isScalarAndEqual = require('./util/isScalarAndEqual');
@@ -154,7 +159,11 @@ export type {
   Snapshot,
   StoreUpdater,
 } from './store/RelayStoreTypes';
-export type {GraphQLSubscriptionConfig} from './subscription/requestSubscription';
+export type {
+  DEPRECATED_GraphQLSubscriptionConfig,
+  GraphQLSubscriptionConfig,
+  SubscriptionParameters,
+} from './subscription/requestSubscription';
 export type {JSResourceReference} from './util/JSResourceTypes.flow';
 export type {
   NormalizationArgument,
@@ -207,6 +216,7 @@ export type {
   VariablesOf,
 } from './util/RelayRuntimeTypes';
 export type {Local3DPayload} from './util/createPayloadFor3DField';
+export type {Direction} from './util/getPaginationVariables';
 export type {RequestIdentifier} from './util/getRequestIdentifier';
 
 // As early as possible, check for the existence of the JavaScript globals which
@@ -329,6 +339,11 @@ module.exports = {
   recycleNodesInto: recycleNodesInto,
   stableCopy: stableCopy,
   getFragmentIdentifier: getFragmentIdentifier,
+  getRefetchMetadata: getRefetchMetadata,
+  getPaginationMetadata: getPaginationMetadata,
+  getPaginationVariables: getPaginationVariables,
+  getPendingOperationsForFragment: getPendingOperationsForFragment,
+  getValueAtPath: getValueAtPath,
   __internal: {
     OperationTracker: RelayOperationTracker,
     createRelayContext: createRelayContext,

package/lib/index.js

@@ -84,10 +84,20 @@ var fetchQuery_DEPRECATED = require('./query/fetchQuery_DEPRECATED');
 
 var getFragmentIdentifier = require('./util/getFragmentIdentifier');
 
+var getPaginationMetadata = require('./util/getPaginationMetadata');
+
+var getPaginationVariables = require('./util/getPaginationVariables');
+
+var getPendingOperationsForFragment = require('./util/getPendingOperationsForFragment');
+
+var getRefetchMetadata = require('./util/getRefetchMetadata');
+
 var getRelayHandleKey = require('./util/getRelayHandleKey');
 
 var getRequestIdentifier = require('./util/getRequestIdentifier');
 
+var getValueAtPath = require('./util/getValueAtPath');
+
 var isPromise = require('./util/isPromise');
 
 var isRelayModernEnvironment = require('./store/isRelayModernEnvironment');
@@ -214,6 +224,11 @@ module.exports = {
   recycleNodesInto: recycleNodesInto,
   stableCopy: stableCopy,
   getFragmentIdentifier: getFragmentIdentifier,
+  getRefetchMetadata: getRefetchMetadata,
+  getPaginationMetadata: getPaginationMetadata,
+  getPaginationVariables: getPaginationVariables,
+  getPendingOperationsForFragment: getPendingOperationsForFragment,
+  getValueAtPath: getValueAtPath,
   __internal: {
     OperationTracker: RelayOperationTracker,
     createRelayContext: createRelayContext,

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

@@ -13,11 +13,21 @@
  * A unique identifier of the current actor.
  */
 
+var invariant = require('invariant');
+
+var INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE = 'INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE';
+
+function assertInternalActorIndentifier(actorIdentifier) {
+  !(actorIdentifier === INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Expected to use only internal version of the `actorIdentifier`. "%s" was provided.', actorIdentifier) : invariant(false) : void 0;
+}
+
 module.exports = {
+  assertInternalActorIndentifier: assertInternalActorIndentifier,
   getActorIdentifier: function getActorIdentifier(actorID) {
     return actorID;
   },
   getDefaultActorIdentifier: function getDefaultActorIdentifier() {
     throw new Error('Not Implemented');
-  }
+  },
+  INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE: INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE
 };

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

@@ -12,50 +12,90 @@
 
 var RelayOperationTracker = require('../store/RelayOperationTracker');
 
-function todo() {
-  throw new Error('Not implementd');
-}
+var RelayPublishQueue = require('../store/RelayPublishQueue');
+
+var defaultGetDataID = require('../store/defaultGetDataID');
+
+var registerEnvironmentWithDevTools = require('../util/registerEnvironmentWithDevTools');
+
+var wrapNetworkWithLogObserver = require('../network/wrapNetworkWithLogObserver');
 
 var ActorSpecificEnvironment = /*#__PURE__*/function () {
-  // Actor specific properties
   function ActorSpecificEnvironment(config) {
+    var _this = this;
+
+    this.configName = config.configName;
     this.actorIdentifier = config.actorIdentifier;
     this.multiActorEnvironment = config.multiActorEnvironment;
     this.__log = config.logFn;
     this.requiredFieldLogger = config.requiredFieldLogger;
     this._operationTracker = new RelayOperationTracker();
     this._store = config.store;
-    this._network = config.network;
+    this._network = wrapNetworkWithLogObserver(this, config.network);
+    this._publishQueue = new RelayPublishQueue(config.store, config.handlerProvider, defaultGetDataID);
+    this._defaultRenderPolicy = config.defaultRenderPolicy; // TODO:T92305692 Remove `options` in favor of directly using `actorIdentifier` on the environment
+
+    this.options = {
+      actorID: this.actorIdentifier
+    }; // We need to add this here to pass `isRelayModernEnvironment` check
+    // $FlowFixMe[prop-missing]
+
+    this['@@RelayModernEnvironment'] = true;
+
+    if (process.env.NODE_ENV !== "production") {
+      var _require = require('../store/StoreInspector'),
+          inspect = _require.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.
+
+
+    registerEnvironmentWithDevTools(this);
   }
 
   var _proto = ActorSpecificEnvironment.prototype;
 
+  _proto.getPublishQueue = function getPublishQueue() {
+    return this._publishQueue;
+  };
+
   _proto.UNSTABLE_getDefaultRenderPolicy = function UNSTABLE_getDefaultRenderPolicy() {
-    return todo();
+    return this._defaultRenderPolicy;
   };
 
   _proto.applyMutation = function applyMutation(optimisticConfig) {
-    return this.multiActorEnvironment.applyMutation(this.actorIdentifier, optimisticConfig);
+    return this.multiActorEnvironment.applyMutation(this, optimisticConfig);
   };
 
   _proto.applyUpdate = function applyUpdate(optimisticUpdate) {
-    return this.multiActorEnvironment.applyUpdate(this.actorIdentifier, optimisticUpdate);
+    return this.multiActorEnvironment.applyUpdate(this, optimisticUpdate);
+  };
+
+  _proto.revertUpdate = function revertUpdate(optimisticUpdate) {
+    return this.multiActorEnvironment.revertUpdate(this, optimisticUpdate);
+  };
+
+  _proto.replaceUpdate = function replaceUpdate(optimisticUpdate, replacementUpdate) {
+    return this.multiActorEnvironment.replaceUpdate(this, optimisticUpdate, replacementUpdate);
   };
 
   _proto.check = function check(operation) {
-    return this.multiActorEnvironment.check(this.actorIdentifier, operation);
+    return this.multiActorEnvironment.check(this, operation);
   };
 
   _proto.subscribe = function subscribe(snapshot, callback) {
-    return this.multiActorEnvironment.subscribe(this.actorIdentifier, snapshot, callback);
+    return this.multiActorEnvironment.subscribe(this, snapshot, callback);
   };
 
   _proto.retain = function retain(operation) {
-    return this.multiActorEnvironment.retain(this.actorIdentifier, operation);
+    return this.multiActorEnvironment.retain(this, operation);
   };
 
   _proto.commitUpdate = function commitUpdate(updater) {
-    return this.multiActorEnvironment.commitUpdate(this.actorIdentifier, updater);
+    return this.multiActorEnvironment.commitUpdate(this, updater);
   }
   /**
    * Commit a payload to the environment using the given operation selector.
@@ -63,7 +103,7 @@ var ActorSpecificEnvironment = /*#__PURE__*/function () {
   ;
 
   _proto.commitPayload = function commitPayload(operationDescriptor, payload) {
-    return this.multiActorEnvironment.commitPayload(this.actorIdentifier, operationDescriptor, payload);
+    return this.multiActorEnvironment.commitPayload(this, operationDescriptor, payload);
   };
 
   _proto.getNetwork = function getNetwork() {
@@ -79,27 +119,27 @@ var ActorSpecificEnvironment = /*#__PURE__*/function () {
   };
 
   _proto.lookup = function lookup(selector) {
-    return this.multiActorEnvironment.lookup(this.actorIdentifier, selector);
+    return this.multiActorEnvironment.lookup(this, selector);
   };
 
   _proto.execute = function execute(config) {
-    return this.multiActorEnvironment.execute(this.actorIdentifier, config);
+    return this.multiActorEnvironment.execute(this, config);
   };
 
   _proto.executeMutation = function executeMutation(options) {
-    return this.multiActorEnvironment.executeMutation(this.actorIdentifier, options);
+    return this.multiActorEnvironment.executeMutation(this, options);
   };
 
   _proto.executeWithSource = function executeWithSource(options) {
-    return this.multiActorEnvironment.executeWithSource(this.actorIdentifier, options);
+    return this.multiActorEnvironment.executeWithSource(this, options);
   };
 
   _proto.isRequestActive = function isRequestActive(requestIdentifier) {
-    return this.multiActorEnvironment.isRequestActive(this.actorIdentifier, requestIdentifier);
+    return this.multiActorEnvironment.isRequestActive(this, requestIdentifier);
   };
 
   _proto.isServer = function isServer() {
-    return todo();
+    return this.multiActorEnvironment.isServer();
   };
 
   return ActorSpecificEnvironment;

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

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ *
+ * @emails oncall+relay
+ * 
+ * @format
+ */
+'use strict';
+
+var ACTOR_IDENTIFIER_FIELD_NAME = 'actor_key';
+
+var _require = require('./ActorIdentifier'),
+    getActorIdentifier = _require.getActorIdentifier;
+
+function getActorIdentifierFromPayload(payload) {
+  if (payload != null && typeof payload === 'object' && typeof payload[ACTOR_IDENTIFIER_FIELD_NAME] === 'string') {
+    return getActorIdentifier(payload[ACTOR_IDENTIFIER_FIELD_NAME]);
+  }
+}
+
+module.exports = {
+  ACTOR_IDENTIFIER_FIELD_NAME: ACTOR_IDENTIFIER_FIELD_NAME,
+  getActorIdentifierFromPayload: getActorIdentifierFromPayload
+};