relay-runtime 1.7.0-rc.1 → 2.0.0

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,84 +7,81 @@
  * 
  * @format
  */
-
 'use strict';
 
 // As early as possible, check for the existence of the JavaScript globals which
 // Relay Runtime relies upon, and produce a clear message if they do not exist.
-if (process.env.NODE_ENV !== 'production') {
+if (process.env.NODE_ENV !== "production") {
   if (typeof Map !== 'function' || typeof Set !== 'function' || typeof Promise !== 'function' || typeof Object.assign !== 'function') {
     throw new Error('relay-runtime requires Map, Set, Promise, and Object.assign to exist. ' + 'Use a polyfill to provide these for older browsers.');
   }
 }
-
 /**
  * The public interface to Relay Runtime.
  */
-module.exports = {
-  // Core API
-  Environment: require('./RelayModernEnvironment'),
-  Network: require('./RelayNetwork'),
-  Observable: require('./RelayObservable'),
-  QueryResponseCache: require('./RelayQueryResponseCache'),
-  RecordSource: require('./RelayInMemoryRecordSource'),
-  Store: require('./RelayMarkSweepStore'),
 
-  areEqualSelectors: require('./RelayCore').areEqualSelectors,
-  createFragmentSpecResolver: require('./RelayCore').createFragmentSpecResolver,
-  createOperationSelector: require('./RelayCore').createOperationSelector,
-  getDataIDsFromObject: require('./RelayCore').getDataIDsFromObject,
-  getFragment: require('./RelayModernGraphQLTag').getFragment,
-  getRequest: require('./RelayModernGraphQLTag').getRequest,
-  // TODO (T23201154) remove in a future Relay release.
-  getOperation: function getOperation() {
-    if (process.env.NODE_ENV !== 'production') {
-      require('fbjs/lib/warning')(false, 'getOperation() deprecated. Use getRequest().');
-    }
-    return require('./RelayModernGraphQLTag').getRequest.apply(null, arguments);
-  },
-  getSelector: require('./RelayCore').getSelector,
-  getSelectorList: require('./RelayCore').getSelectorList,
-  getSelectorsFromObject: require('./RelayCore').getSelectorsFromObject,
-  getStorageKey: require('./RelayStoreUtils').getStorageKey,
-  getVariablesFromObject: require('./RelayCore').getVariablesFromObject,
-  graphql: require('./RelayModernGraphQLTag').graphql,
 
+module.exports = {
+  // Core API
+  Environment: require("./RelayModernEnvironment"),
+  Network: require("./RelayNetwork"),
+  Observable: require("./RelayObservable"),
+  QueryResponseCache: require("./RelayQueryResponseCache"),
+  RecordSource: require("./RelayInMemoryRecordSource"),
+  Store: require("./RelayModernStore"),
+  areEqualSelectors: require("./RelayCore").areEqualSelectors,
+  createFragmentSpecResolver: require("./RelayCore").createFragmentSpecResolver,
+  createOperationDescriptor: require("./RelayCore").createOperationDescriptor,
+  getDataIDsFromObject: require("./RelayCore").getDataIDsFromObject,
+  getFragment: require("./RelayModernGraphQLTag").getFragment,
+  getPaginationFragment: require("./RelayModernGraphQLTag").getPaginationFragment,
+  getRefetchableFragment: require("./RelayModernGraphQLTag").getRefetchableFragment,
+  getRequest: require("./RelayModernGraphQLTag").getRequest,
+  getSelector: require("./RelayCore").getSelector,
+  getSelectorList: require("./RelayCore").getSelectorList,
+  getSelectorsFromObject: require("./RelayCore").getSelectorsFromObject,
+  getStorageKey: require("./RelayStoreUtils").getStorageKey,
+  getVariablesFromObject: require("./RelayCore").getVariablesFromObject,
+  graphql: require("./RelayModernGraphQLTag").graphql,
   // Declarative mutation API
-  MutationTypes: require('./RelayDeclarativeMutationConfig').MutationTypes,
-  RangeOperations: require('./RelayDeclarativeMutationConfig').RangeOperations,
-
+  MutationTypes: require("./RelayDeclarativeMutationConfig").MutationTypes,
+  RangeOperations: require("./RelayDeclarativeMutationConfig").RangeOperations,
   // Extensions
-  ConnectionHandler: require('./RelayConnectionHandler'),
-  ViewerHandler: require('./RelayViewerHandler'),
-
+  DefaultHandlerProvider: require("./RelayDefaultHandlerProvider"),
+  ConnectionHandler: require("./RelayConnectionHandler"),
+  ViewerHandler: require("./RelayViewerHandler"),
   // Helpers (can be implemented via the above API)
-  applyOptimisticMutation: require('./applyRelayModernOptimisticMutation'),
-  commitLocalUpdate: require('./commitLocalUpdate'),
-  commitMutation: require('./commitRelayModernMutation'),
-  fetchQuery: require('./fetchRelayModernQuery'),
-  isRelayModernEnvironment: require('./isRelayModernEnvironment'),
-  requestSubscription: require('./requestRelaySubscription'),
-
+  applyOptimisticMutation: require("./applyRelayModernOptimisticMutation"),
+  commitLocalUpdate: require("./commitLocalUpdate"),
+  commitMutation: require("./commitRelayModernMutation"),
+  fetchQuery: require("./fetchRelayModernQuery"),
+  isRelayModernEnvironment: require("./isRelayModernEnvironment"),
+  requestSubscription: require("./requestRelaySubscription"),
   // Configuration interface for legacy or special uses
-  ConnectionInterface: require('./RelayConnectionInterface'),
-
+  ConnectionInterface: require("./RelayConnectionInterface"),
   // Utilities
-  RelayProfiler: require('./RelayProfiler'),
-
+  RelayProfiler: require("./RelayProfiler"),
   // INTERNAL-ONLY: These exports might be removed at any point.
-  RelayConcreteNode: require('./RelayConcreteNode'),
-  RelayError: require('./RelayError'),
-  RelayNetworkLoggerTransaction: require('./RelayNetworkLoggerTransaction'),
-  DEFAULT_HANDLE_KEY: require('./RelayDefaultHandleKey').DEFAULT_HANDLE_KEY,
-  ROOT_ID: require('./RelayStoreUtils').ROOT_ID,
-
-  createRelayNetworkLogger: require('./createRelayNetworkLogger'),
-  deepFreeze: require('./deepFreeze'),
-  generateClientID: require('./generateRelayClientID'),
-  getRelayHandleKey: require('./getRelayHandleKey'),
-  isScalarAndEqual: require('./isScalarAndEqual'),
-  recycleNodesInto: require('./recycleNodesInto'),
-  simpleClone: require('./simpleClone'),
-  stableCopy: require('./stableCopy')
+  RelayConcreteNode: require("./RelayConcreteNode"),
+  RelayError: require("./RelayError"),
+  RelayNetworkLoggerTransaction: require("./RelayNetworkLoggerTransaction"),
+  DEFAULT_HANDLE_KEY: require("./RelayDefaultHandleKey").DEFAULT_HANDLE_KEY,
+  FRAGMENTS_KEY: require("./RelayStoreUtils").FRAGMENTS_KEY,
+  FRAGMENT_OWNER_KEY: require("./RelayStoreUtils").FRAGMENT_OWNER_KEY,
+  ID_KEY: require("./RelayStoreUtils").ID_KEY,
+  REF_KEY: require("./RelayStoreUtils").REF_KEY,
+  REFS_KEY: require("./RelayStoreUtils").REFS_KEY,
+  ROOT_ID: require("./RelayStoreUtils").ROOT_ID,
+  ROOT_TYPE: require("./RelayStoreUtils").ROOT_TYPE,
+  createRelayNetworkLogger: require("./createRelayNetworkLogger"),
+  deepFreeze: require("./deepFreeze"),
+  generateClientID: require("./generateRelayClientID"),
+  getRelayHandleKey: require("./getRelayHandleKey"),
+  isScalarAndEqual: require("./isScalarAndEqual"),
+  recycleNodesInto: require("./recycleNodesInto"),
+  simpleClone: require("./simpleClone"),
+  stableCopy: require("./stableCopy"),
+  __internal: {
+    getModernOperationVariables: require("./RelayConcreteVariables").getOperationVariables
+  }
 };

package/lib/isPromise.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,7 +7,6 @@
  *  strict
  * @format
  */
-
 'use strict';
 
 function isPromise(p) {

package/lib/isRelayModernEnvironment.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,9 +7,7 @@
  * 
  * @format
  */
-
 'use strict';
-
 /**
  * Determine if a given value is an object that implements the `Environment`
  * interface defined in `RelayStoreTypes`.

package/lib/isScalarAndEqual.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,9 +7,7 @@
  *  strict
  * @format
  */
-
 'use strict';
-
 /**
  * A fast test to determine if two values are equal scalars:
  * - compares scalars such as booleans, strings, numbers by value

package/lib/normalizePayload.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,28 +7,30 @@
  * 
  * @format
  */
-
 'use strict';
 
-function normalizePayload(payload) {
-  var operation = payload.operation,
-      variables = payload.variables,
-      response = payload.response;
-  var data = response.data,
-      errors = response.errors;
+function normalizePayload(operation, payload) {
+  var data = payload.data,
+      errors = payload.errors;
 
   if (data != null) {
-    return require('./normalizeRelayPayload')({
-      dataID: require('./RelayStoreUtils').ROOT_ID,
-      node: operation,
-      variables: variables
-    }, data, errors, { handleStrippedNulls: true });
+    return require("./normalizeRelayPayload")(operation.root, data, errors, {
+      handleStrippedNulls: true
+    });
   }
-  var error = require('./RelayError').create('RelayNetwork', 'No data returned for operation `%s`, got error(s):\n%s\n\nSee the error ' + '`source` property for more information.', operation.name, errors ? errors.map(function (_ref) {
+
+  var node = operation.node;
+
+  var error = require("./RelayError").create('RelayNetwork', 'No data returned for operation `%s`, got error(s):\n%s\n\nSee the error ' + '`source` property for more information.', node.params ? node.params.name : node.name, errors ? errors.map(function (_ref) {
     var message = _ref.message;
     return message;
   }).join('\n') : '(No errors)');
-  error.source = { errors: errors, operation: operation, variables: variables };
+
+  error.source = {
+    errors: errors,
+    operation: operation.node,
+    variables: operation.variables
+  };
   throw error;
 }
 

package/lib/normalizeRelayPayload.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,23 +7,23 @@
  *  strict-local
  * @format
  */
-
 'use strict';
 
 function normalizeRelayPayload(selector, payload, errors) {
-  var options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : { handleStrippedNulls: false };
-
-  var source = new (require('./RelayInMemoryRecordSource'))();
-  source.set(require('./RelayStoreUtils').ROOT_ID, require('./RelayModernRecord').create(require('./RelayStoreUtils').ROOT_ID, require('./RelayStoreUtils').ROOT_TYPE));
+  var options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {
+    handleStrippedNulls: false
+  };
+  var source = new (require("./RelayInMemoryRecordSource"))();
+  source.set(require("./RelayStoreUtils").ROOT_ID, require("./RelayModernRecord").create(require("./RelayStoreUtils").ROOT_ID, require("./RelayStoreUtils").ROOT_TYPE));
 
-  var _RelayResponseNormali = require('./RelayResponseNormalizer').normalize(source, selector, payload, options),
+  var _RelayResponseNormali = require("./RelayResponseNormalizer").normalize(source, selector, payload, options),
       fieldPayloads = _RelayResponseNormali.fieldPayloads,
-      deferrableSelections = _RelayResponseNormali.deferrableSelections;
+      matchPayloads = _RelayResponseNormali.matchPayloads;
 
   return {
     errors: errors,
     fieldPayloads: fieldPayloads,
-    deferrableSelections: deferrableSelections,
+    matchPayloads: matchPayloads,
     source: source
   };
 }

package/lib/recycleNodesInto.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,9 +7,7 @@
  *  strict
  * @format
  */
-
 'use strict';
-
 /**
  * Recycles subtrees from `prevData` by replacing equal subtrees in `nextData`.
  */
@@ -18,19 +16,28 @@ function recycleNodesInto(prevData, nextData) {
   if (prevData === nextData || typeof prevData !== 'object' || !prevData || typeof nextData !== 'object' || !nextData) {
     return nextData;
   }
-  var canRecycle = false;
 
-  // Assign local variables to preserve Flow type refinement.
+  var canRecycle = false; // Assign local variables to preserve Flow type refinement.
+
   var prevArray = Array.isArray(prevData) ? prevData : null;
   var nextArray = Array.isArray(nextData) ? nextData : null;
+
   if (prevArray && nextArray) {
     canRecycle = nextArray.reduce(function (wasEqual, nextItem, ii) {
       var prevValue = prevArray[ii];
       var nextValue = recycleNodesInto(prevValue, nextItem);
+
       if (nextValue !== nextArray[ii]) {
-        nextArray[ii] = nextValue;
+        if (process.env.NODE_ENV !== "production") {
+          if (!Object.isFrozen(nextArray)) {
+            nextArray[ii] = nextValue;
+          }
+        } else {
+          nextArray[ii] = nextValue;
+        }
       }
-      return wasEqual && nextArray[ii] === prevArray[ii];
+
+      return wasEqual && nextValue === prevArray[ii];
     }, true) && prevArray.length === nextArray.length;
   } else if (!prevArray && !nextArray) {
     // Assign local variables to preserve Flow type refinement.
@@ -41,12 +48,21 @@ function recycleNodesInto(prevData, nextData) {
     canRecycle = nextKeys.reduce(function (wasEqual, key) {
       var prevValue = prevObject[key];
       var nextValue = recycleNodesInto(prevValue, nextObject[key]);
+
       if (nextValue !== nextObject[key]) {
-        nextObject[key] = nextValue;
+        if (process.env.NODE_ENV !== "production") {
+          if (!Object.isFrozen(nextObject)) {
+            nextObject[key] = nextValue;
+          }
+        } else {
+          nextObject[key] = nextValue;
+        }
       }
-      return wasEqual && nextObject[key] === prevObject[key];
+
+      return wasEqual && nextValue === prevObject[key];
     }, true) && prevKeys.length === nextKeys.length;
   }
+
   return canRecycle ? prevData : nextData;
 }
 

package/lib/requestRelaySubscription.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,79 +7,46 @@
  * 
  * @format
  */
-
 'use strict';
 
-var _extends3 = _interopRequireDefault(require('babel-runtime/helpers/extends'));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
-
 function requestRelaySubscription(environment, config) {
   var _environment$unstable = environment.unstable_internal,
-      createOperationSelector = _environment$unstable.createOperationSelector,
+      createOperationDescriptor = _environment$unstable.createOperationDescriptor,
       getRequest = _environment$unstable.getRequest;
-
   var subscription = getRequest(config.subscription);
-  if (subscription.operationKind !== 'subscription') {
+
+  if (subscription.params.operationKind !== 'subscription') {
     throw new Error('requestRelaySubscription: Must use Subscription operation');
   }
+
   var configs = config.configs,
       onCompleted = config.onCompleted,
       onError = config.onError,
       onNext = config.onNext,
-      variables = config.variables,
-      receiveEvents = config.receiveEvents;
+      variables = config.variables;
+  var operation = createOperationDescriptor(subscription, variables);
+  process.env.NODE_ENV !== "production" ? require("fbjs/lib/warning")(!(config.updater && configs), 'requestRelaySubscription: Expected only one of `updater` and `configs` to be provided') : void 0;
 
-  var operation = createOperationSelector(subscription, variables);
-
-  process.env.NODE_ENV !== 'production' ? require('fbjs/lib/warning')(!(config.updater && configs), 'requestRelaySubscription: Expected only one of `updater` and `configs` to be provided') : void 0;
-
-  var _ref = configs ? require('./RelayDeclarativeMutationConfig').convert(configs, subscription, null /* optimisticUpdater */
+  var _ref = configs ? require("./RelayDeclarativeMutationConfig").convert(configs, subscription, null
+  /* optimisticUpdater */
   , config.updater) : config,
       updater = _ref.updater;
 
-  if (receiveEvents) {
-    return environment.executeWithEvents({
-      operation: operation,
-      updater: updater,
-      cacheConfig: { force: true }
-    }).subscribeLegacy({
-      onNext: function (_onNext) {
-        function onNext(_x) {
-          return _onNext.apply(this, arguments);
-        }
-
-        onNext.toString = function () {
-          return _onNext.toString();
-        };
-
-        return onNext;
-      }(function (payload) {
-        if (onNext) {
-          if (payload.kind === 'event') {
-            onNext(payload);
-          } else {
-            var data = environment.lookup(operation.fragment).data;
-            onNext((0, _extends3['default'])({ kind: 'data' }, data));
-          }
-        }
-      }),
-      onError: onError,
-      onCompleted: onCompleted
-    });
-  } else {
-    return environment.execute({
-      operation: operation,
-      updater: updater,
-      cacheConfig: { force: true }
-    }).map(function () {
-      return environment.lookup(operation.fragment).data;
-    }).subscribeLegacy({
-      onNext: onNext,
-      onError: onError,
-      onCompleted: onCompleted
-    });
-  }
+  return environment.execute({
+    operation: operation,
+    updater: updater,
+    cacheConfig: {
+      force: true
+    }
+  }).map(function () {
+    var data = environment.lookup(operation.fragment).data; // $FlowFixMe
+
+    return data;
+  }).subscribeLegacy({
+    onNext: onNext,
+    onError: onError,
+    onCompleted: onCompleted
+  });
 }
 
 module.exports = requestRelaySubscription;

package/lib/simpleClone.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,7 +7,6 @@
  * 
  * @format
  */
-
 'use strict';
 
 /**
@@ -19,7 +18,7 @@ function simpleClone(value) {
   if (Array.isArray(value)) {
     return value.map(simpleClone);
   } else if (value && typeof value === 'object') {
-    return require('fbjs/lib/mapObject')(value, simpleClone);
+    return require("fbjs/lib/mapObject")(value, simpleClone);
   } else {
     return value;
   }

package/lib/stableCopy.js

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2013-present, Facebook, Inc.
+ * 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.
@@ -7,9 +7,7 @@
  * 
  * @format
  */
-
 'use strict';
-
 /**
  * Creates a copy of the provided value, ensuring any nested objects have their
  * keys sorted such that equivalent values would have identical JSON.stringify
@@ -20,14 +18,18 @@ function stableCopy(value) {
   if (!value || typeof value !== 'object') {
     return value;
   }
+
   if (Array.isArray(value)) {
     return value.map(stableCopy);
   }
+
   var keys = Object.keys(value).sort();
   var stable = {};
+
   for (var i = 0; i < keys.length; i++) {
     stable[keys[i]] = stableCopy(value[keys[i]]);
   }
+
   return stable;
 }