react-relay 2.0.0-rc.2 → 5.0.0

package/lib/RelayGraphQLMutation.js

@@ -1,288 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * 
- * @format
- */
-'use strict';
-
-var _defineProperty2 = require("@babel/runtime/helpers/interopRequireDefault")(require("@babel/runtime/helpers/defineProperty"));
-
-var _objectSpread4 = require("@babel/runtime/helpers/interopRequireDefault")(require("@babel/runtime/helpers/objectSpread"));
-
-var COUNTER_PREFIX = 'RelayGraphQLMutation';
-var collisionIDCounter = 0;
-/**
- * @public
- *
- * Low-level API for modeling a GraphQL mutation.
- *
- * This is the lowest level of abstraction at which product code may deal with
- * mutations in Relay, and it corresponds to the mutation operation ("a write
- * followed by a fetch") described in the GraphQL Specification. You specify
- * the mutation, the inputs, and the query.
- *
- * (There is an even lower-level representation, `RelayMutationRequest`,
- * underlying this which is an entirely internal implementation detail that
- * product code need not be aware of.)
- *
- * @see http://facebook.github.io/graphql/.
- *
- */
-
-var RelayGraphQLMutation =
-/*#__PURE__*/
-function () {
-  /**
-   * Simplest method for creating a RelayGraphQLMutation instance from a static
-   * `mutation`, some `variables` and an `environment`.
-   */
-  RelayGraphQLMutation.create = function create(mutation, variables, environment) {
-    return new RelayGraphQLMutation(mutation, variables, null, environment);
-  };
-  /**
-   * Specialized method for creating RelayGraphQLMutation instances that takes a
-   * `files` object in addition to the base `mutation`, `variables` and
-   * `environment` parameters.
-   */
-
-
-  RelayGraphQLMutation.createWithFiles = function createWithFiles(mutation, variables, files, environment) {
-    return new RelayGraphQLMutation(mutation, variables, files, environment);
-  };
-  /**
-   * General constructor for creating RelayGraphQLMutation instances with
-   * optional `files`, `callbacks` and `collisionKey` arguments.
-   *
-   * Callers must provide an appropriate `mutation`:
-   *
-   *    Relay.QL`
-   *      mutation StoryLikeQuery {
-   *        likeStory(input: $input) {
-   *          clientMutationId
-   *          story {
-   *            likeCount
-   *            likers {
-   *              actor {
-   *                name
-   *              }
-   *            }
-   *          }
-   *        }
-   *      }
-   *    `;
-   *
-   * And set of `variables`:
-   *
-   *    {
-   *      input: {
-   *        feedbackId: 'aFeedbackId',
-   *      },
-   *    }
-   *
-   * As per the GraphQL Relay Specification:
-   *
-   * - The mutation should take a single argument named "input".
-   * - That input argument should contain a (string) "clientMutationId" property
-   *   for the purposes of reconciling requests and responses (automatically
-   *   added by the RelayGraphQLMutation API).
-   * - The query should request "clientMutationId" as a subselection.
-   *
-   * @see http://facebook.github.io/relay/docs/graphql-mutations.html
-   * @see http://facebook.github.io/relay/graphql/mutations.htm
-   *
-   * If not supplied, a unique collision key is derived (meaning that the
-   * created mutation will be independent and not collide with any other).
-   */
-
-
-  function RelayGraphQLMutation(query, variables, files, environment, callbacks, collisionKey) {
-    this._query = query;
-    this._variables = variables;
-    this._files = files || null;
-    this._environment = environment;
-    this._callbacks = callbacks || null;
-    this._collisionKey = collisionKey || "".concat(COUNTER_PREFIX, ":collisionKey:").concat(getNextCollisionID());
-    this._transaction = null;
-  }
-  /**
-   * Call this to optimistically apply an update to the store.
-   *
-   * The optional `config` parameter can be used to configure a `RANGE_ADD` type
-   * mutation, similar to `RelayMutation` API.
-   *
-   * Optionally, follow up with a call to `commit()` to send the mutation
-   * to the server.
-   *
-   * Note: An optimistic update may only be applied once.
-   */
-
-
-  var _proto = RelayGraphQLMutation.prototype;
-
-  _proto.applyOptimistic = function applyOptimistic(optimisticQuery, optimisticResponse, configs) {
-    !!this._transaction ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'RelayGraphQLMutation: `applyOptimistic()` was called on an instance ' + 'that already has a transaction in progress.') : require("fbjs/lib/invariant")(false) : void 0;
-    this._transaction = this._createTransaction(optimisticQuery, optimisticResponse);
-    return this._transaction.applyOptimistic(configs);
-  };
-  /**
-   * Call this to send the mutation to the server.
-   *
-   * The optional `config` parameter can be used to configure a `RANGE_ADD` type
-   * mutation, similar to the `RelayMutation` API.
-   *
-   * Optionally, precede with a call to `applyOptimistic()` to apply an update
-   * optimistically to the store.
-   *
-   * Note: This method may only be called once per instance.
-   */
-
-
-  _proto.commit = function commit(configs) {
-    if (!this._transaction) {
-      this._transaction = this._createTransaction();
-    }
-
-    return this._transaction.commit(configs);
-  };
-
-  _proto.rollback = function rollback() {
-    if (this._transaction) {
-      return this._transaction.rollback();
-    }
-  };
-
-  _proto._createTransaction = function _createTransaction(optimisticQuery, optimisticResponse) {
-    return new PendingGraphQLTransaction(this._environment, this._query, this._variables, this._files, optimisticQuery, optimisticResponse, this._collisionKey, this._callbacks);
-  };
-
-  return RelayGraphQLMutation;
-}();
-
-function getNextCollisionID() {
-  return collisionIDCounter++;
-}
-/**
- * @internal
- *
- * Data structure conforming to the `PendingTransaction` interface specified by
- * `RelayMutationQueue`.
- */
-
-
-var PendingGraphQLTransaction =
-/*#__PURE__*/
-function () {
-  // These properties required to conform to the PendingTransaction interface:
-  // Other properties:
-  function PendingGraphQLTransaction(environment, query, variables, files, optimisticQuery, optimisticResponse, collisionKey, callbacks) {
-    this._configs = [];
-    this._query = query;
-    this._variables = variables;
-    this._files = files;
-    this._optimisticQuery = optimisticQuery || null;
-    this._optimisticResponse = optimisticResponse || null;
-    this._collisionKey = collisionKey;
-    this.onFailure = callbacks && callbacks.onFailure;
-    this.onSuccess = callbacks && callbacks.onSuccess;
-    this.status = require("./RelayMutationTransactionStatus").CREATED;
-    this.error = null;
-    this._mutation = null;
-    this._optimisticConfigs = null;
-    this._optimisticMutation = null;
-    this.mutationTransaction = environment.getStoreData().getMutationQueue().createTransactionWithPendingTransaction(this);
-    this.id = this.mutationTransaction.getID();
-  } // Methods from the PendingTransaction interface.
-
-
-  var _proto2 = PendingGraphQLTransaction.prototype;
-
-  _proto2.getCallName = function getCallName() {
-    !this._mutation ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'RelayGraphQLMutation: `getCallName()` called but no mutation exists ' + '(`getQuery()` must be called first to construct the mutation).') : require("fbjs/lib/invariant")(false) : void 0;
-    return this._mutation.getCall().name;
-  };
-
-  _proto2.getCollisionKey = function getCollisionKey() {
-    return this._collisionKey;
-  };
-
-  _proto2.getConfigs = function getConfigs() {
-    return this._configs;
-  };
-
-  _proto2.getFiles = function getFiles() {
-    return this._files;
-  };
-
-  _proto2.getOptimisticConfigs = function getOptimisticConfigs() {
-    return this._optimisticConfigs;
-  };
-
-  _proto2.getOptimisticQuery = function getOptimisticQuery(storeData) {
-    if (!this._optimisticMutation && this._optimisticQuery) {
-      var concreteMutation = require("./QueryBuilder").getMutation(this._optimisticQuery);
-
-      var mutation = require("./RelayQuery").Mutation.create(concreteMutation, require("./RelayMetaRoute").get('$RelayGraphQLMutation'), this._getVariables());
-
-      this._optimisticMutation = mutation; // Cast RelayQuery.{Node -> Mutation}.
-    }
-
-    return this._optimisticMutation;
-  };
-
-  _proto2.getOptimisticResponse = function getOptimisticResponse() {
-    return (0, _objectSpread4["default"])({}, this._optimisticResponse, (0, _defineProperty2["default"])({}, require("relay-runtime").ConnectionInterface.get().CLIENT_MUTATION_ID, this.id));
-  };
-
-  _proto2.getQuery = function getQuery(storeData) {
-    if (!this._mutation) {
-      var concreteMutation = require("./QueryBuilder").getMutation(this._query);
-
-      var mutation = require("./RelayQuery").Mutation.create(concreteMutation, require("./RelayMetaRoute").get('$RelayGraphQLMutation'), this._getVariables());
-
-      this._mutation = mutation; // Cast RelayQuery.{Node -> Mutation}.
-    }
-
-    return this._mutation;
-  }; // Additional methods outside the PendingTransaction interface.
-
-
-  _proto2.commit = function commit(configs) {
-    if (configs) {
-      this._configs = configs;
-    }
-
-    return this.mutationTransaction.commit();
-  };
-
-  _proto2.applyOptimistic = function applyOptimistic(configs) {
-    if (configs) {
-      this._optimisticConfigs = configs;
-    }
-
-    return this.mutationTransaction.applyOptimistic();
-  };
-
-  _proto2.rollback = function rollback() {
-    this.mutationTransaction.rollback();
-  };
-
-  _proto2._getVariables = function _getVariables() {
-    var input = this._variables.input;
-
-    if (!input) {
-      !false ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'RelayGraphQLMutation: Required `input` variable is missing ' + '(supplied variables were: [%s]).', Object.keys(this._variables).join(', ')) : require("fbjs/lib/invariant")(false) : void 0;
-    }
-
-    return (0, _objectSpread4["default"])({}, this._variables, {
-      input: (0, _objectSpread4["default"])({}, input, (0, _defineProperty2["default"])({}, require("relay-runtime").ConnectionInterface.get().CLIENT_MUTATION_ID, this.id))
-    });
-  };
-
-  return PendingGraphQLTransaction;
-}();
-
-module.exports = RelayGraphQLMutation;

package/lib/RelayGraphQLTag.js

@@ -1,42 +0,0 @@
-/**
- * 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.
- *
- *  strict-local
- * @format
- */
-'use strict';
-
-/**
- * Runtime function to correspond to the `graphql` tagged template function.
- * All calls to this function should be transformed by the plugin.
- */
-function graphql() {
-  !false ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'graphql: Unexpected invocation at runtime. Either the Babel transform ' + 'was not set up, or it failed to identify this call site. Make sure it ' + 'is being used verbatim as `graphql`.') : require("fbjs/lib/invariant")(false) : void 0;
-}
-
-function isClassicFragment(taggedNode) {
-  return require("./QueryBuilder").getFragmentDefinition(require("./RelayQL").__getClassicNode(taggedNode)) != null;
-}
-
-function isClassicOperation(taggedNode) {
-  return require("./QueryBuilder").getOperationDefinition(require("./RelayQL").__getClassicNode(taggedNode)) != null;
-}
-
-function getClassicFragment(taggedNode) {
-  return require("./RelayQL").__getClassicFragment(taggedNode);
-}
-
-function getClassicOperation(taggedNode) {
-  return require("./RelayQL").__getClassicOperation(taggedNode);
-}
-
-module.exports = {
-  getClassicFragment: getClassicFragment,
-  getClassicOperation: getClassicOperation,
-  graphql: graphql,
-  isClassicFragment: isClassicFragment,
-  isClassicOperation: isClassicOperation
-};

package/lib/RelayInternalTypes.js

@@ -1,15 +0,0 @@
-/**
- * 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.
- *
- *  strict-local
- * @format
- */
-'use strict';
-/**
- * @internal
- *
- * These are types shared across multiple files within Relay internals.
- */

package/lib/RelayInternals.js

@@ -1,24 +0,0 @@
-/**
- * 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.
- *
- *  strict-local
- * @format
- */
-'use strict';
-
-/**
- * This module contains internal Relay modules that we expose for development
- * tools. They should be considered private APIs.
- *
- * @internal
- */
-var RelayInternals = {
-  NetworkLayer: require("./RelayStore").getStoreData().getNetworkLayer(),
-  DefaultStoreData: require("./RelayStore").getStoreData(),
-  flattenRelayQuery: require("./flattenRelayQuery"),
-  printRelayQuery: require("./printRelayQuery")
-};
-module.exports = RelayInternals;

package/lib/RelayMetaRoute.js

@@ -1,35 +0,0 @@
-/**
- * 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.
- *
- *  strict
- * @format
- */
-'use strict';
-/**
- * Meta route based on the real route; provides access to the route name in
- * queries.
- */
-
-var RelayMetaRoute =
-/*#__PURE__*/
-function () {
-  function RelayMetaRoute(name) {
-    Object.defineProperty(this, 'name', {
-      enumerable: true,
-      value: name,
-      writable: false
-    });
-  }
-
-  RelayMetaRoute.get = function get(name) {
-    return cache[name] || (cache[name] = new RelayMetaRoute(name));
-  };
-
-  return RelayMetaRoute;
-}();
-
-var cache = {};
-module.exports = RelayMetaRoute;

package/lib/RelayMockRenderer.js

@@ -1,71 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * 
- * @format
- */
-'use strict';
-
-var _inheritsLoose2 = require("@babel/runtime/helpers/interopRequireDefault")(require("@babel/runtime/helpers/inheritsLoose"));
-
-var _assertThisInitialized2 = require("@babel/runtime/helpers/interopRequireDefault")(require("@babel/runtime/helpers/assertThisInitialized"));
-
-var _defineProperty2 = require("@babel/runtime/helpers/interopRequireDefault")(require("@babel/runtime/helpers/defineProperty"));
-
-/**
- * A helper for rendering RelayContainers with mock data, outside of a
- * RelayRootContainer/RelayRenderer. This is intended for use in unit tests or
- * component browser-style interfaces.
- *
- * Note: For unit tests, you may need to mock `ReactDOM` as follows:
- *
- * ```
- * jest.mock('ReactDOM', () => ({}));
- * ```
- *
- * Currently ReactDOM and ReactTestRenderer cannot both be loaded in the same
- * test, and Relay transitively includes ReactDOM under its default settings.
- */
-// this should be deprecated
-var RelayMockRenderer =
-/*#__PURE__*/
-function (_React$Component) {
-  (0, _inheritsLoose2["default"])(RelayMockRenderer, _React$Component);
-
-  function RelayMockRenderer() {
-    var _this;
-
-    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-      args[_key] = arguments[_key];
-    }
-
-    _this = _React$Component.call.apply(_React$Component, [this].concat(args)) || this;
-    (0, _defineProperty2["default"])((0, _assertThisInitialized2["default"])((0, _assertThisInitialized2["default"])(_this)), "mockContext", {
-      environment: new (require("./RelayEnvironment"))(),
-      variables: {},
-      route: {
-        name: '$RelayMockRenderer',
-        params: {},
-        queries: {},
-        useMockData: true
-      },
-      useFakeData: true
-    });
-    return _this;
-  }
-
-  var _proto = RelayMockRenderer.prototype;
-
-  _proto.render = function render() {
-    return require("react").createElement(require("./ReactRelayContext").Provider, {
-      value: this.mockContext
-    }, this.props.render());
-  };
-
-  return RelayMockRenderer;
-}(require("react").Component);
-
-module.exports = RelayMockRenderer;