relay-compiler 1.3.0 → 1.5.0

package/lib/RelayConcreteNode.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayConcreteNode
  * 
@@ -14,19 +12,27 @@
 'use strict';
 
 /**
- * Represents a single ConcreteRoot along with metadata for processing it at
- * runtime. The persisted `id` (or `text`) can be used to fetch the query,
- * the `fragment` can be used to read the root data (masking data from child
- * fragments), and the `query` can be used to normalize server responses.
+ * Represents a common GraphQL request with `text` (or persisted `id`) can be
+ * used to execute it, an `operation` containing information to normalize the
+ * results, and a `fragment` derived from that operation to read the response
+ * data (masking data from child fragments).
+ */
+
+/**
+ * An experimental wrapper around many operations to request in a batched
+ * network request. The composed indivual GraphQL requests should be submitted
+ * as a single networked request, e.g. in the case of deferred nodes or
+ * for streaming connections that are represented as distinct compiled concrete
+ * operations but are still conceptually tied to one source operation.
  *
- * NOTE: The use of "batch" in the name is intentional, as this wrapper around
- * the ConcreteRoot will provide a place to store multiple concrete nodes that
- * are part of the same batch, e.g. in the case of deferred nodes or
- * for streaming connections that are represented as distinct concrete roots but
- * are still conceptually tied to one source query.
+ * Individual requests within the batch may contain data describing their
+ * dependencies on other requests or themselves.
  */
 var RelayConcreteNode = {
+  BATCH_REQUEST: 'BatchRequest',
   CONDITION: 'Condition',
+  DEFERRABLE_FRAGMENT_SPREAD: 'DeferrableFragmentSpread',
+  DEFERRABLE_OPERATION: 'DeferrableOperation',
   FRAGMENT: 'Fragment',
   FRAGMENT_SPREAD: 'FragmentSpread',
   INLINE_FRAGMENT: 'InlineFragment',
@@ -34,11 +40,22 @@ var RelayConcreteNode = {
   LINKED_HANDLE: 'LinkedHandle',
   LITERAL: 'Literal',
   LOCAL_ARGUMENT: 'LocalArgument',
-  ROOT: 'Root',
+  OPERATION: 'Operation',
   ROOT_ARGUMENT: 'RootArgument',
+  REQUEST: 'Request',
   SCALAR_FIELD: 'ScalarField',
   SCALAR_HANDLE: 'ScalarHandle',
   VARIABLE: 'Variable'
 };
+/**
+ * Represents a single operation used to processing and normalize runtime
+ * request results.
+ */
+
+/**
+ * Argument in the provided operation to be derived via the results of
+ * other requests in the batch.
+ */
+
 
 module.exports = RelayConcreteNode;

package/lib/RelayConnectionConstants.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayConnectionConstants
  * 

package/lib/RelayConnectionTransform.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * 
  * @providesModule RelayConnectionTransform
@@ -25,6 +23,8 @@ var _require = require('./RelayConnectionConstants'),
     FIRST = _require.FIRST,
     KEY = _require.KEY,
     LAST = _require.LAST;
+// TODO T21875029 ../../../relay-runtime/RelayRuntime
+
 
 var _require2 = require('relay-runtime'),
     ConnectionInterface = _require2.ConnectionInterface;
@@ -38,6 +38,14 @@ var _require3 = require('graphql'),
     GraphQLUnionType = _require3.GraphQLUnionType,
     parse = _require3.parse;
 
+var _require4 = require('./GraphQLCompilerPublic'),
+    getLiteralArgumentValues = _require4.getLiteralArgumentValues,
+    IRTransformer = _require4.IRTransformer,
+    SchemaUtils = _require4.SchemaUtils;
+
+// TODO T21875029 ../../../relay-runtime/handlers/connection/RelayConnectionHandler
+
+
 var CONNECTION = 'connection';
 
 /**
@@ -50,16 +58,16 @@ var CONNECTION = 'connection';
  * - Inserts a sub-fragment on the field to ensure that standard connection
  *   fields are fetched (e.g. cursors, node ids, page info).
  */
-function transform(context) {
-  return require('./RelayIRTransformer').transform(context, {
+function relayConnectionTransform(context) {
+  return IRTransformer.transform(context, {
     Fragment: visitFragmentOrRoot,
     LinkedField: visitLinkedField,
     Root: visitFragmentOrRoot
-  }, function () {
+  }, function (node) {
     return {
       path: [],
       connectionMetadata: [],
-      definitionName: null
+      definitionName: node.name
     };
   });
 }
@@ -70,11 +78,8 @@ var SCHEMA_EXTENSION = 'directive @connection(key: String!, filters: [String]) o
  * @internal
  */
 function visitFragmentOrRoot(node, options) {
-  var passedOptions = (0, _extends3['default'])({}, options, {
-    definitionName: node.name
-  });
-  var transformedNode = this.traverse(node, passedOptions);
-  var connectionMetadata = passedOptions.connectionMetadata;
+  var transformedNode = this.traverse(node, options);
+  var connectionMetadata = options.connectionMetadata;
   if (connectionMetadata.length) {
     return (0, _extends3['default'])({}, transformedNode, {
       metadata: (0, _extends3['default'])({}, transformedNode.metadata, {
@@ -89,7 +94,7 @@ function visitFragmentOrRoot(node, options) {
  * @internal
  */
 function visitLinkedField(field, options) {
-  var isPlural = require('./GraphQLSchemaUtils').getNullableType(field.type) instanceof GraphQLList;
+  var isPlural = SchemaUtils.getNullableType(field.type) instanceof GraphQLList;
   options.path.push(isPlural ? null : field.alias || field.name);
   var transformedField = this.traverse(field, options);
   var connectionDirective = field.directives.find(function (directive) {
@@ -101,7 +106,6 @@ function visitLinkedField(field, options) {
   }
   var definitionName = options.definitionName;
 
-  require('fbjs/lib/invariant')(definitionName, 'RelayConnectionTransform: Transform error, expected a name to have ' + 'been set by the parent operation or fragment definition.');
   validateConnectionSelection(definitionName, transformedField);
   validateConnectionType(definitionName, transformedField.type);
 
@@ -130,9 +134,9 @@ function visitLinkedField(field, options) {
   });
   options.path.pop();
 
-  var _getRelayLiteralArgum = require('./getRelayLiteralArgumentValues')(connectionDirective.args),
-      key = _getRelayLiteralArgum.key,
-      filters = _getRelayLiteralArgum.filters;
+  var _getLiteralArgumentVa = getLiteralArgumentValues(connectionDirective.args),
+      key = _getLiteralArgumentVa.key,
+      filters = _getLiteralArgumentVa.filters;
 
   require('fbjs/lib/invariant')(typeof key === 'string', 'RelayConnectionTransform: Expected the %s argument to @%s to ' + 'be a string literal for field %s', KEY, CONNECTION, field.name);
   var postfix = '' + (field.alias || field.name);
@@ -187,7 +191,7 @@ function generateConnectionFragment(context, type, direction) {
       PAGE_INFO = _ConnectionInterface$.PAGE_INFO,
       START_CURSOR = _ConnectionInterface$.START_CURSOR;
 
-  var compositeType = assertCompositeType(require('./GraphQLSchemaUtils').getNullableType(type));
+  var compositeType = assertCompositeType(SchemaUtils.getNullableType(type));
 
   var pageInfo = PAGE_INFO;
   if (direction === 'forward') {
@@ -201,7 +205,7 @@ function generateConnectionFragment(context, type, direction) {
   var ast = parse(fragmentString);
   var fragmentAST = ast.definitions[0];
   require('fbjs/lib/invariant')(fragmentAST && fragmentAST.kind === 'FragmentDefinition', 'RelayConnectionTransform: Expected a fragment definition AST.');
-  var fragment = require('./RelayParser').transform(context.schema, fragmentAST);
+  var fragment = require('./RelayParser').transform(context.clientSchema, fragmentAST);
   require('fbjs/lib/invariant')(fragment && fragment.kind === 'Fragment', 'RelayConnectionTransform: Expected a connection fragment.');
   return {
     directives: [],
@@ -261,46 +265,38 @@ function validateConnectionType(definitionName, type) {
       PAGE_INFO = _ConnectionInterface$3.PAGE_INFO,
       START_CURSOR = _ConnectionInterface$3.START_CURSOR;
 
-  var typeWithFields = require('./GraphQLSchemaUtils').assertTypeWithFields(require('./GraphQLSchemaUtils').getNullableType(type));
+  var typeWithFields = SchemaUtils.assertTypeWithFields(SchemaUtils.getNullableType(type));
   var typeFields = typeWithFields.getFields();
   var edges = typeFields[EDGES];
 
   require('fbjs/lib/invariant')(edges, 'RelayConnectionTransform: Expected type `%s` to have an %s field in ' + 'document `%s`.', type, EDGES, definitionName);
 
-  var edgesType = require('./GraphQLSchemaUtils').getNullableType(edges.type);
+  var edgesType = SchemaUtils.getNullableType(edges.type);
   require('fbjs/lib/invariant')(edgesType instanceof GraphQLList, 'RelayConnectionTransform: Expected `%s` field on type `%s` to be a ' + 'list type in document `%s`.', EDGES, type, definitionName);
-  var edgeType = require('./GraphQLSchemaUtils').getNullableType(edgesType.ofType);
+  var edgeType = SchemaUtils.getNullableType(edgesType.ofType);
   require('fbjs/lib/invariant')(edgeType instanceof GraphQLObjectType, 'RelayConnectionTransform: Expected %s field on type `%s` to be a list ' + 'of objects in document `%s`.', EDGES, type, definitionName);
 
   var node = edgeType.getFields()[NODE];
   require('fbjs/lib/invariant')(node, 'RelayConnectionTransform: Expected type `%s` to have an %s.%s field in ' + 'document `%s`.', type, EDGES, NODE, definitionName);
-  var nodeType = require('./GraphQLSchemaUtils').getNullableType(node.type);
-  if (!(nodeType instanceof GraphQLInterfaceType || nodeType instanceof GraphQLUnionType || nodeType instanceof GraphQLObjectType)) {
-    require('fbjs/lib/invariant')(false, 'RelayConnectionTransform: Expected type `%s` to have an %s.%s field' + 'for which the type is an interface, object, or union in document `%s`.', type, EDGES, NODE, definitionName);
-  }
+  var nodeType = SchemaUtils.getNullableType(node.type);
+  require('fbjs/lib/invariant')(nodeType instanceof GraphQLInterfaceType || nodeType instanceof GraphQLUnionType || nodeType instanceof GraphQLObjectType, 'RelayConnectionTransform: Expected type `%s` to have an %s.%s field' + 'for which the type is an interface, object, or union in document `%s`.', type, EDGES, NODE, definitionName);
 
   var cursor = edgeType.getFields()[CURSOR];
-  if (!cursor || !(require('./GraphQLSchemaUtils').getNullableType(cursor.type) instanceof GraphQLScalarType)) {
-    require('fbjs/lib/invariant')(false, 'RelayConnectionTransform: Expected type `%s` to have an ' + '%s.%s field for which the type is a scalar in document `%s`.', type, EDGES, CURSOR, definitionName);
-  }
+  require('fbjs/lib/invariant')(cursor && SchemaUtils.getNullableType(cursor.type) instanceof GraphQLScalarType, 'RelayConnectionTransform: Expected type `%s` to have an ' + '%s.%s field for which the type is a scalar in document `%s`.', type, EDGES, CURSOR, definitionName);
 
   var pageInfo = typeFields[PAGE_INFO];
   require('fbjs/lib/invariant')(pageInfo, 'RelayConnectionTransform: Expected type `%s` to have a %s field ' + 'in document `%s`.', type, PAGE_INFO, definitionName);
-  var pageInfoType = require('./GraphQLSchemaUtils').getNullableType(pageInfo.type);
-  if (!(pageInfoType instanceof GraphQLObjectType)) {
-    require('fbjs/lib/invariant')(false, 'RelayConnectionTransform: Expected type `%s` to have a %s field for ' + 'which the type is an object in document `%s`.', type, PAGE_INFO, definitionName);
-  }
+  var pageInfoType = SchemaUtils.getNullableType(pageInfo.type);
+  require('fbjs/lib/invariant')(pageInfoType instanceof GraphQLObjectType, 'RelayConnectionTransform: Expected type `%s` to have a %s field for ' + 'which the type is an object in document `%s`.', type, PAGE_INFO, definitionName);
 
   [END_CURSOR, HAS_NEXT_PAGE, HAS_PREV_PAGE, START_CURSOR].forEach(function (fieldName) {
     var pageInfoField = pageInfoType.getFields()[fieldName];
-    if (!pageInfoField || !(require('./GraphQLSchemaUtils').getNullableType(pageInfoField.type) instanceof GraphQLScalarType)) {
-      require('fbjs/lib/invariant')(false, 'RelayConnectionTransform: Expected type `%s` to have an ' + '%s field for which the type is an scalar in document `%s`.', pageInfo.type, fieldName, definitionName);
-    }
+    require('fbjs/lib/invariant')(pageInfoField && SchemaUtils.getNullableType(pageInfoField.type) instanceof GraphQLScalarType, 'RelayConnectionTransform: Expected type `%s` to have an ' + '%s field for which the type is an scalar in document `%s`.', pageInfo.type, fieldName, definitionName);
   });
 }
 
 module.exports = {
   CONNECTION: CONNECTION,
   SCHEMA_EXTENSION: SCHEMA_EXTENSION,
-  transform: transform
+  transform: relayConnectionTransform
 };

package/lib/RelayDefaultHandleKey.js

@@ -1,10 +1,8 @@
 /**
  * Copyright (c) 2013-present, Facebook, Inc.
- * All rights reserved.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
  * @providesModule RelayDefaultHandleKey
  *