react-relay 2.0.0-rc.2 → 5.0.0

package/lib/restoreRelayCacheData.js

@@ -1,188 +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';
-
-var _inheritsLoose2 = require("@babel/runtime/helpers/interopRequireDefault")(require("@babel/runtime/helpers/inheritsLoose"));
-
-/**
- * @internal
- *
- * Retrieves data for queries or fragments from disk into `cachedRecords`.
- */
-function restoreFragmentDataFromCache(dataID, fragment, path, store, cachedRecords, cachedRootCallMap, cacheManager, changeTracker, callbacks) {
-  var restorator = new RelayCachedDataRestorator(cacheManager, store, cachedRecords, cachedRootCallMap, changeTracker, callbacks);
-  restorator.restoreFragmentData(dataID, fragment, path);
-  return {
-    abort: function abort() {
-      restorator.abort();
-    }
-  };
-}
-
-function restoreQueriesDataFromCache(queries, store, cachedRecords, cachedRootCallMap, cacheManager, changeTracker, callbacks) {
-  var restorator = new RelayCachedDataRestorator(cacheManager, store, cachedRecords, cachedRootCallMap, changeTracker, callbacks);
-  restorator.restoreQueriesData(queries);
-  return {
-    abort: function abort() {
-      restorator.abort();
-    }
-  };
-}
-
-var RelayCachedDataRestorator =
-/*#__PURE__*/
-function (_RelayCacheProcessor) {
-  (0, _inheritsLoose2["default"])(RelayCachedDataRestorator, _RelayCacheProcessor);
-
-  function RelayCachedDataRestorator(cacheManager, store, cachedRecords, cachedRootCallMap, changeTracker, callbacks) {
-    var _this;
-
-    _this = _RelayCacheProcessor.call(this, cacheManager, callbacks) || this;
-    _this._cachedRecords = cachedRecords;
-    _this._cachedRootCallMap = cachedRootCallMap;
-    _this._changeTracker = changeTracker;
-    _this._store = store;
-    return _this;
-  }
-
-  var _proto = RelayCachedDataRestorator.prototype;
-
-  _proto.handleNodeVisited = function handleNodeVisited(node, dataID, record, nextState) {
-    var recordState = this._store.getRecordState(dataID);
-
-    this._cachedRecords[dataID] = record; // Mark records as created/updated as necessary. Note that if the
-    // record is known to be deleted in the store then it will have been
-    // been marked as created already. Further, it does not need to be
-    // updated since no additional data can be read about a deleted node.
-
-    if (recordState === 'UNKNOWN' && record !== undefined) {
-      // Mark as created if the store did not have a record but disk cache
-      // did (either a known record or known deletion).
-      this._changeTracker.createID(dataID);
-    } else if (recordState === 'EXISTENT' && record != null) {
-      // Mark as updated only if a record exists in both the store and
-      // disk cache.
-      this._changeTracker.updateID(dataID);
-    }
-
-    if (!record) {
-      // We are out of luck if disk doesn't have the node either.
-      this.handleFailure();
-      return;
-    }
-
-    if (require("./RelayRecord").isClientID(dataID)) {
-      record.__path__ = nextState.path;
-    }
-  };
-
-  _proto.handleIdentifiedRootVisited = function handleIdentifiedRootVisited(query, dataID, identifyingArgKey, nextState) {
-    if (dataID == null) {
-      // Read from cache and we still don't have a valid `dataID`.
-      this.handleFailure();
-      return;
-    }
-
-    var storageKey = query.getStorageKey();
-    this._cachedRootCallMap[storageKey] = this._cachedRootCallMap[storageKey] || {};
-    this._cachedRootCallMap[storageKey][identifyingArgKey || ''] = dataID;
-    nextState.dataID = dataID;
-  };
-
-  _proto.restoreFragmentData = function restoreFragmentData(dataID, fragment, path) {
-    var _this2 = this;
-
-    this.process(function () {
-      _this2.visitFragment(fragment, {
-        dataID: dataID,
-        node: fragment,
-        path: path,
-        rangeCalls: undefined
-      });
-    });
-  };
-
-  _proto.restoreQueriesData = function restoreQueriesData(queries) {
-    var _this3 = this;
-
-    this.process(function () {
-      require("fbjs/lib/forEachObject")(queries, function (query) {
-        if (_this3._state === 'COMPLETED') {
-          return;
-        }
-
-        if (query) {
-          _this3.visitRoot(query, {
-            dataID: undefined,
-            node: query,
-            path: require("./RelayQueryPath").create(query),
-            rangeCalls: undefined
-          });
-        }
-      });
-    });
-  };
-
-  _proto.traverse = function traverse(node, nextState) {
-    !(nextState.dataID != null) ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'RelayCachedDataRestorator: Attempted to traverse without a ' + '`dataID`.') : require("fbjs/lib/invariant")(false) : void 0;
-
-    var _findRelayQueryLeaves = require("./findRelayQueryLeaves")(this._store, this._cachedRecords, nextState.node, nextState.dataID, nextState.path, nextState.rangeCalls),
-        missingData = _findRelayQueryLeaves.missingData,
-        pendingNodeStates = _findRelayQueryLeaves.pendingNodeStates;
-
-    if (missingData) {
-      this.handleFailure();
-      return;
-    }
-
-    for (var ii = 0; ii < pendingNodeStates.length; ii++) {
-      if (this._state === 'COMPLETED') {
-        return;
-      }
-
-      !(pendingNodeStates[ii].dataID != null) ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'RelayCachedDataRestorator: Attempted to visit a node without ' + 'a `dataID`.') : require("fbjs/lib/invariant")(false) : void 0;
-      this.visitNode(pendingNodeStates[ii].node, pendingNodeStates[ii].dataID, pendingNodeStates[ii]);
-    }
-  };
-
-  _proto.visitIdentifiedRoot = function visitIdentifiedRoot(query, identifyingArgKey, nextState) {
-    var dataID = this._store.getDataID(query.getStorageKey(), identifyingArgKey);
-
-    if (dataID == null) {
-      _RelayCacheProcessor.prototype.visitIdentifiedRoot.call(this, query, identifyingArgKey, nextState);
-    } else {
-      this.traverse(query, {
-        dataID: dataID,
-        node: query,
-        path: require("./RelayQueryPath").create(query),
-        rangeCalls: undefined
-      });
-    }
-  };
-
-  return RelayCachedDataRestorator;
-}(require("./RelayCacheProcessor"));
-
-require("relay-runtime").RelayProfiler.instrumentMethods(RelayCachedDataRestorator.prototype, {
-  handleIdentifiedRootVisited: 'RelayCachedDataRestorator.handleIdentifiedRootVisited',
-  handleNodeVisited: 'RelayCachedDataRestorator.handleNodeVisited',
-  queueIdentifiedRoot: 'RelayCachedDataRestorator.queueRoot',
-  queueNode: 'RelayCachedDataRestorator.queueNode',
-  restoreFragmentData: 'RelayCachedDataRestorator.readFragment',
-  restoreQueriesData: 'RelayCachedDataRestorator.read',
-  traverse: 'RelayCachedDataRestorator.traverse',
-  visitNode: 'RelayCachedDataRestorator.visitNode',
-  visitRoot: 'RelayCachedDataRestorator.visitRoot'
-});
-
-module.exports = {
-  restoreFragmentDataFromCache: restoreFragmentDataFromCache,
-  restoreQueriesDataFromCache: restoreQueriesDataFromCache
-};

package/lib/serializeRelayQueryCall.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.
- *
- * 
- * @format
- */
-'use strict';
-
-/**
- * @internal
- *
- * Serializes a query "call" (a classic combination of field and argument value).
- */
-function serializeRelayQueryCall(call) {
-  var value = call.value;
-  var valueString;
-
-  if (Array.isArray(value)) {
-    valueString = require("fbjs/lib/flattenArray")(value).map(function (value) {
-      return serializeCallValue(value);
-    }).join(',');
-  } else {
-    valueString = serializeCallValue(value);
-  }
-
-  return '.' + call.name + '(' + valueString + ')';
-}
-
-function serializeCallValue(value) {
-  if (value == null) {
-    return '';
-  } else if (typeof value !== 'string') {
-    return JSON.stringify(value);
-  } else {
-    return value;
-  }
-}
-
-module.exports = serializeRelayQueryCall;

package/lib/splitDeferredRelayQueries.js

@@ -1,298 +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"));
-
-/**
- * Traverse `node` splitting off deferred query fragments into separate queries.
- *
- * @internal
- */
-function splitDeferredRelayQueries(node) {
-  var splitter = new GraphQLSplitDeferredQueries();
-  var splitQueries = {
-    __nodePath__: [],
-    __parent__: null,
-    __refQuery__: null,
-    deferred: [],
-    required: null
-  };
-  splitter.visit(node, splitQueries);
-  return buildQueries(splitQueries);
-}
-/**
- * Returns the requisite siblings of `node`, but filters any non-requisite
- * children of those siblings.
- */
-
-
-function getRequisiteSiblings(node, parent) {
-  // Get the requisite siblings.
-  var siblings = parent.getChildren().filter(function (child) {
-    return child !== node && child instanceof require("./RelayQuery").Field && child.isRequisite();
-  }); // Filter the non-requisite children from those siblings.
-
-  return siblings.map(function (sibling) {
-    var children = sibling.getChildren().filter(function (child) {
-      return child instanceof require("./RelayQuery").Field && child.isRequisite();
-    });
-    var clone = sibling.clone(children);
-    !clone ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'splitDeferredRelayQueries(): Unexpected non-scalar, requisite field.') : require("fbjs/lib/invariant")(false) : void 0;
-    return clone;
-  });
-}
-/**
- * Traverse the parent chain of `node` wrapping it at each level until it is
- * either:
- *
- * - wrapped in a RelayQuery.Root node
- * - wrapped in a non-root node that can be split off in a "ref query" (ie. a
- *   root call with a ref param that references another query)
- *
- * Additionally ensures that any requisite sibling fields are embedded in each
- * layer of the wrapper.
- */
-
-
-function wrapNode(node, nodePath) {
-  for (var ii = nodePath.length - 1; ii >= 0; ii--) {
-    var parent = nodePath[ii];
-
-    if (parent instanceof require("./RelayQuery").Field && parent.getInferredRootCallName()) {
-      // We can make a "ref query" at this point, so stop wrapping.
-      return new (require("./RelayRefQueryDescriptor"))(node, nodePath.slice(0, ii + 1));
-    }
-
-    var siblings = getRequisiteSiblings(node, parent);
-    var children = [node].concat(siblings); // Cast here because we know that `clone` will never return `null` (because
-    // we always give it at least one child).
-
-    node = parent.clone(children);
-  }
-
-  !(node instanceof require("./RelayQuery").Root) ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'splitDeferredRelayQueries(): Cannot build query without a root node.') : require("fbjs/lib/invariant")(false) : void 0;
-  var identifyingArg = node.getIdentifyingArg();
-  var identifyingArgName = identifyingArg && identifyingArg.name || null;
-  var identifyingArgValue = identifyingArg && identifyingArg.value || null;
-
-  var identifyingArgType = identifyingArg && identifyingArg.type || require("./RelayNodeInterface").ID_TYPE;
-
-  var metadata = {
-    identifyingArgName: identifyingArgName,
-    identifyingArgType: identifyingArgType,
-    isAbstract: true,
-    isDeferred: true,
-    isPlural: false
-  };
-  return require("./RelayQuery").Root.build(node.getName(), node.getFieldName(), identifyingArgValue, node.getChildren(), metadata, node.getType());
-}
-/**
- * Returns `true` if `node` is considered "empty", which means that it contains
- * no non-generated fields, and no ref query dependencies.
- */
-
-
-function isEmpty(node) {
-  if (!node.canHaveSubselections()) {
-    return node.isGenerated() && !node.isRefQueryDependency();
-  } else {
-    return node.getChildren().every(isEmpty);
-  }
-}
-/**
- * Mutates and returns a nested `SplitQueries` structure, updating any deferred
- * "ref queries" to actually reference their contexts.
- */
-
-
-function buildQueries(splitQueries) {
-  if (splitQueries.required && isEmpty(splitQueries.required)) {
-    splitQueries.required = null;
-  }
-
-  splitQueries.deferred = splitQueries.deferred.map(function (nestedSplitQueries) {
-    var descriptor = nestedSplitQueries.__refQuery__;
-
-    if (descriptor) {
-      // Wrap the ref query node with a reference to the required query that is
-      // its context.
-      var context = splitQueries.required;
-
-      if (!context) {
-        // Traverse upwards looking for context.
-        var parentSplitQueries = splitQueries;
-
-        while (parentSplitQueries.__parent__) {
-          context = parentSplitQueries.__parent__.required;
-
-          if (context) {
-            break;
-          }
-
-          parentSplitQueries = parentSplitQueries.__parent__;
-        }
-      }
-
-      !context ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'splitDeferredRelayQueries(): Expected a context root query.') : require("fbjs/lib/invariant")(false) : void 0;
-      nestedSplitQueries.required = createRefQuery(descriptor, context);
-    }
-
-    return buildQueries(nestedSplitQueries);
-  });
-  return splitQueries;
-}
-/**
- * Wraps `descriptor` in a new top-level ref query.
- */
-
-
-function createRefQuery(descriptor, context) {
-  var node = descriptor.node;
-  !(node instanceof require("./RelayQuery").Field || node instanceof require("./RelayQuery").Fragment) ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'splitDeferredRelayQueries(): Ref query requires a field or fragment.') : require("fbjs/lib/invariant")(false) : void 0; // Build up JSONPath.
-
-  var jsonPath = ['$', '*'];
-  var parent;
-
-  for (var ii = 0; ii < descriptor.nodePath.length; ii++) {
-    parent = descriptor.nodePath[ii];
-
-    if (parent instanceof require("./RelayQuery").Field) {
-      jsonPath.push(parent.getSerializationKey());
-
-      if (parent.isPlural()) {
-        jsonPath.push('*');
-      }
-    }
-  }
-
-  !(jsonPath.length > 2) ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'splitDeferredRelayQueries(): Ref query requires a complete path.') : require("fbjs/lib/invariant")(false) : void 0;
-  var field = parent; // Flow
-
-  var primaryKey = field.getInferredPrimaryKey();
-  !primaryKey ? process.env.NODE_ENV !== "production" ? require("fbjs/lib/invariant")(false, 'splitDeferredRelayQueries(): Ref query requires a primary key.') : require("fbjs/lib/invariant")(false) : void 0;
-  jsonPath.push(primaryKey); // Create the wrapper root query.
-
-  var root = require("./RelayQuery").Root.build(context.getName(), require("./RelayNodeInterface").NODES, require("./QueryBuilder").createBatchCallVariable(context.getID(), jsonPath.join('.')), [node], {
-    identifyingArgName: require("./RelayNodeInterface").ID,
-    identifyingArgType: require("./RelayNodeInterface").ID_TYPE,
-    isAbstract: true,
-    isDeferred: true,
-    isPlural: false
-  }, require("./RelayNodeInterface").NODE_TYPE);
-
-  var result = root; // Flow
-
-  return result;
-}
-/**
- * Traverses an input query, updating the passed in `SplitQueries` state object
- * to contain a nested structure representing the required and deferred portions
- * of the input query.
- */
-
-
-var GraphQLSplitDeferredQueries =
-/*#__PURE__*/
-function (_RelayQueryTransform) {
-  (0, _inheritsLoose2["default"])(GraphQLSplitDeferredQueries, _RelayQueryTransform);
-
-  function GraphQLSplitDeferredQueries() {
-    return _RelayQueryTransform.apply(this, arguments) || this;
-  }
-
-  var _proto = GraphQLSplitDeferredQueries.prototype;
-
-  _proto.visitField = function visitField(node, splitQueries) {
-    if (!node.hasDeferredDescendant()) {
-      return node;
-    }
-
-    splitQueries.__nodePath__.push(node);
-
-    var result = this.traverse(node, splitQueries);
-
-    splitQueries.__nodePath__.pop();
-
-    if (result && node.getInferredRootCallName()) {
-      // The node is a ref query dependency; mark it as one.
-      var key = node.getInferredPrimaryKey();
-      var children = result.getChildren().map(function (child) {
-        if (child instanceof require("./RelayQuery").Field && child.getSchemaName() === key) {
-          return child.cloneAsRefQueryDependency();
-        } else {
-          return child;
-        }
-      });
-      result = result.clone(children);
-    }
-
-    return result;
-  };
-
-  _proto.visitFragment = function visitFragment(node, splitQueries) {
-    if (!node.getChildren().length) {
-      return null;
-    }
-
-    if (node.isDeferred()) {
-      var nodePath = splitQueries.__nodePath__;
-      var deferred = {
-        __nodePath__: nodePath,
-        __parent__: splitQueries,
-        __refQuery__: null,
-        deferred: [],
-        required: null
-      };
-      var result = this.traverse(node, deferred);
-
-      if (result) {
-        var wrapped = wrapNode(result, nodePath);
-
-        if (wrapped instanceof require("./RelayQuery").Root) {
-          deferred.required = wrapped;
-        } else if (wrapped instanceof require("./RelayRefQueryDescriptor")) {
-          // for Flow
-          deferred.__refQuery__ = wrapped;
-        }
-      }
-
-      if (result || deferred.deferred.length) {
-        splitQueries.deferred.push(deferred);
-      }
-
-      return null;
-    } else if (node.hasDeferredDescendant()) {
-      return this.traverse(node, splitQueries);
-    } else {
-      return node;
-    }
-  };
-
-  _proto.visitRoot = function visitRoot(node, splitQueries) {
-    if (!node.hasDeferredDescendant()) {
-      splitQueries.required = node;
-      return node;
-    } else {
-      splitQueries.__nodePath__.push(node);
-
-      var result = this.traverse(node, splitQueries);
-
-      splitQueries.__nodePath__.pop();
-
-      splitQueries.required = result;
-      return result;
-    }
-  };
-
-  return GraphQLSplitDeferredQueries;
-}(require("./RelayQueryTransform"));
-
-module.exports = require("relay-runtime").RelayProfiler.instrument('splitDeferredRelayQueries', splitDeferredRelayQueries);

package/lib/stableStringify.js

@@ -1,85 +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';
-
-function isObject(value) {
-  return value !== null && Object.prototype.toString.call(value) === '[object Object]';
-}
-/**
- * Simple recursive stringifier that handles basic objects (does not handle
- * corner cases such as circular references) and produces a JSON-like
- * serialization suitable for use as a cache key or other similar internal
- * book-keeping detail.
- *
- * Sample input:
- *
- *     var object = {
- *       top2: {
- *         middle: {
- *           inner: [1, 'foo', ['bar', 2]],
- *           other: false,
- *         },
- *       },
- *       top1: [
- *         {first: true},
- *         {first: false},
- *         'random',
- *       ],
- *       misc: true,
- *       extra: null,
- *     };
- *
- * Sample output (some whitespace added for clarity):
- *
- *    {
- *      extra:null,
- *      misc:true,
- *      top1:[0:{first:true},1:{first:false},2:"random"],
- *      top2:{middle:{inner:[0:1,1:"foo",2:[0:"bar",1:2]],other:false}}
- *    }
- */
-
-
-function stableStringify(input) {
-  var inputIsArray = Array.isArray(input);
-  var inputIsObject = isObject(input);
-
-  if (inputIsArray || inputIsObject) {
-    var keys = Object.keys(input);
-
-    if (keys.length) {
-      var result = [];
-      keys.sort();
-
-      for (var i = 0; i < keys.length; i++) {
-        var key = keys[i];
-        var value = input[key];
-
-        if (isObject(value) || Array.isArray(value)) {
-          value = stableStringify(value);
-        } else {
-          value = JSON.stringify(value);
-        }
-
-        result.push(key + ':' + value);
-      }
-
-      if (inputIsArray) {
-        return '[' + result.join(',') + ']';
-      } else {
-        return '{' + result.join(',') + '}';
-      }
-    }
-  }
-
-  return JSON.stringify(input);
-}
-
-module.exports = stableStringify;