relay-compiler 1.3.0 → 1.5.0

package/lib/RelayProfiler.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 RelayProfiler
  * 
@@ -78,9 +76,11 @@ var RelayProfiler = {
    * `attachHandler` and `detachHandler` methods.
    */
   instrumentMethods: function instrumentMethods(object, names) {
-    require('fbjs/lib/forEachObject')(names, function (name, key) {
-      object[key] = RelayProfiler.instrument(name, object[key]);
-    });
+    for (var _key in names) {
+      if (names.hasOwnProperty(_key)) {
+        object[_key] = RelayProfiler.instrument(names[_key], object[_key]);
+      }
+    }
   },
 
 

package/lib/RelayQueryCaching.js

@@ -1,12 +1,9 @@
 /**
  * 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 RelayQueryCaching
  * 
  * @format
  */

package/lib/RelayRelayDirectiveTransform.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 RelayRelayDirectiveTransform
  * 
@@ -17,48 +15,64 @@ var _extends3 = _interopRequireDefault(require('babel-runtime/helpers/extends'))
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
+var _require = require('./GraphQLCompilerPublic'),
+    CompilerContext = _require.CompilerContext,
+    IRTransformer = _require.IRTransformer,
+    getLiteralArgumentValues = _require.getLiteralArgumentValues;
+
 var RELAY = 'relay';
-var PLURAL = 'plural';
-var SCHEMA_EXTENSION = 'directive @relay(\n  # Marks a connection field as containing nodes without \'id\' fields.\n  # This is used to silence the warning when diffing connections.\n  isConnectionWithoutNodeID: Boolean,\n\n  # Marks a fragment as intended for pattern matching (as opposed to fetching).\n  # Used in Classic only.\n  pattern: Boolean,\n\n  # Marks a fragment as being backed by a GraphQLList.\n  plural: Boolean,\n\n  # Marks a fragment spread which should be unmasked if provided false\n  mask: Boolean = true,\n\n  # Selectively pass variables down into a fragment. Only used in Classic.\n  variables: [String!],\n) on FRAGMENT_DEFINITION | FRAGMENT_SPREAD | INLINE_FRAGMENT | FIELD';
+var SCHEMA_EXTENSION = 'directive @relay(\n  # Marks this fragment spread as being deferrable such that it loads after\n  # other portions of the view.\n  deferrable: Boolean,\n\n  # Marks a connection field as containing nodes without \'id\' fields.\n  # This is used to silence the warning when diffing connections.\n  isConnectionWithoutNodeID: Boolean,\n\n  # Marks a fragment as intended for pattern matching (as opposed to fetching).\n  # Used in Classic only.\n  pattern: Boolean,\n\n  # Marks a fragment as being backed by a GraphQLList.\n  plural: Boolean,\n\n  # Marks a fragment spread which should be unmasked if provided false\n  mask: Boolean = true,\n\n  # Selectively pass variables down into a fragment. Only used in Classic.\n  variables: [String!],\n) on FRAGMENT_DEFINITION | FRAGMENT_SPREAD | INLINE_FRAGMENT | FIELD';
 
 /**
  * A transform that extracts `@relay(plural: Boolean)` directives and converts
  * them to metadata that can be accessed at runtime.
  */
-function transform(context) {
-  return require('./RelayIRTransformer').transform(context, {
-    Fragment: visitFragment
-  }, function () {
-    return {};
-  } // empty state
-  );
+function relayRelayDirectiveTransform(context) {
+  return IRTransformer.transform(context, {
+    Fragment: visitRelayMetadata(fragmentMetadata),
+    FragmentSpread: visitRelayMetadata(fragmentSpreadMetadata)
+  });
 }
 
-function visitFragment(fragment) {
-  var relayDirective = fragment.directives.find(function (_ref) {
-    var name = _ref.name;
-    return name === RELAY;
-  });
-  if (!relayDirective) {
-    return fragment;
-  }
+function visitRelayMetadata(metadataFn) {
+  return function (node) {
+    var relayDirective = node.directives.find(function (_ref) {
+      var name = _ref.name;
+      return name === RELAY;
+    });
+    if (!relayDirective) {
+      return this.traverse(node);
+    }
+    var argValues = getLiteralArgumentValues(relayDirective.args);
+    var metadata = metadataFn(argValues);
+    return this.traverse((0, _extends3['default'])({}, node, {
+      directives: node.directives.filter(function (directive) {
+        return directive !== relayDirective;
+      }),
+      metadata: (0, _extends3['default'])({}, node.metadata || {}, metadata)
+    }));
+  };
+}
 
-  var _getRelayLiteralArgum = require('./getRelayLiteralArgumentValues')(relayDirective.args),
-      plural = _getRelayLiteralArgum.plural;
+function fragmentMetadata(_ref2) {
+  var plural = _ref2.plural;
 
-  require('fbjs/lib/invariant')(plural === undefined || typeof plural === 'boolean', 'RelayRelayDirectiveTransform: Expected the %s argument to @%s to be ' + 'a boolean literal or not specified.', PLURAL, RELAY);
-  return (0, _extends3['default'])({}, fragment, {
-    directives: fragment.directives.filter(function (directive) {
-      return directive !== relayDirective;
-    }),
-    metadata: (0, _extends3['default'])({}, fragment.metadata || {}, {
-      plural: plural
-    })
-  });
+  require('fbjs/lib/invariant')(plural === undefined || typeof plural === 'boolean', 'RelayRelayDirectiveTransform: Expected the "plural" argument to @relay ' + 'to be a boolean literal if specified.');
+  return { plural: plural };
+}
+
+function fragmentSpreadMetadata(_ref3) {
+  var mask = _ref3.mask,
+      deferrable = _ref3.deferrable;
+
+  require('fbjs/lib/invariant')(mask === undefined || typeof mask === 'boolean', 'RelayRelayDirectiveTransform: Expected the "mask" argument to @relay ' + 'to be a boolean literal if specified.');
+  require('fbjs/lib/invariant')(deferrable === undefined || typeof deferrable === 'boolean', 'RelayRelayDirectiveTransform: Expected the "deferrable" argument to ' + '@relay to be a boolean literal if specified.');
+  require('fbjs/lib/invariant')(!(deferrable === true && mask === false), 'RelayRelayDirectiveTransform: Cannot unmask a deferrable fragment spread.');
+  return { mask: mask, deferrable: deferrable };
 }
 
 module.exports = {
   RELAY: RELAY,
   SCHEMA_EXTENSION: SCHEMA_EXTENSION,
-  transform: transform
+  transform: relayRelayDirectiveTransform
 };

package/lib/RelayRuntimeTypes.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2013-present, Facebook, Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @providesModule RelayRuntimeTypes
+ * 
+ * @format
+ */
+
+'use strict';
+
+/**
+ * Basic types used throughout Relay.
+ */
+
+/**
+ * Represents any resource that must be explicitly disposed of. The most common
+ * use-case is as a return value for subscriptions, where calling `dispose()`
+ * would cancel the subscription.
+ */

package/lib/RelayShallowMock.js

@@ -1,12 +1,9 @@
 /**
  * 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 RelayShallowMock
  * 
  * @format
  */
@@ -18,7 +15,7 @@
  * Adds `unwrap` to the container that returns the component to test.
  *
  * @example
- * jest.mock('Relay', () => require('RelayShallowMock'));
+ * jest.mock('Relay', () => require('./RelayShallowMock'));
  * const renderer = require('ReactTestRenderer');
  * const MyContainer = require('MyContainer');
  *
@@ -48,7 +45,7 @@ var _inherits3 = _interopRequireDefault(require('babel-runtime/helpers/inherits'
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
-var Relay = require.requireActual('./RelayClassic');
+var Relay = require.requireActual('./RelayPublic');
 
 var RelayShallowMock = {
   createContainer: function createContainer(component, spec) {

package/lib/RelaySkipHandleFieldTransform.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 RelaySkipHandleFieldTransform
  * 
@@ -17,21 +15,23 @@ var _extends3 = _interopRequireDefault(require('babel-runtime/helpers/extends'))
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
+var _require = require('./GraphQLCompilerPublic'),
+    CompilerContext = _require.CompilerContext,
+    IRTransformer = _require.IRTransformer;
+
 /**
  * A transform that removes field `handles`. Intended for use when e.g.
  * printing queries to send to a GraphQL server.
  */
-function transform(context, schema) {
-  return require('./RelayIRTransformer').transform(context, {
+function relaySkipHandleFieldTransform(context) {
+  return IRTransformer.transform(context, {
     LinkedField: visitField,
     ScalarField: visitField
-  }, function () {
-    return true;
   });
 }
 
-function visitField(field, state) {
-  var transformedNode = this.traverse(field, state);
+function visitField(field) {
+  var transformedNode = this.traverse(field);
   if (transformedNode.handles) {
     return (0, _extends3['default'])({}, transformedNode, {
       handles: null
@@ -40,4 +40,6 @@ function visitField(field, state) {
   return transformedNode;
 }
 
-module.exports = { transform: transform };
+module.exports = {
+  transform: relaySkipHandleFieldTransform
+};

package/lib/RelayTaskQueue.js

@@ -1,12 +1,9 @@
 /**
  * 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 RelayTaskQueue
  * 
  * @format
  */

package/lib/RelayTransformUtils.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2013-present, Facebook, Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * 
+ * @providesModule RelayTransformUtils
+ * @format
+ */
+
+'use strict';
+
+function hasUnaliasedSelection(field, fieldName) {
+  return field.selections.some(function (selection) {
+    return selection.kind === 'ScalarField' && selection.alias == null && selection.name === fieldName;
+  });
+}
+
+module.exports = { hasUnaliasedSelection: hasUnaliasedSelection };

package/lib/RelayTypes.js

@@ -1,12 +1,9 @@
 /**
  * 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 RelayTypes
  * 
  * @format
  */

package/lib/RelayValidator.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 RelayValidator
@@ -17,10 +15,13 @@ var _toConsumableArray3 = _interopRequireDefault(require('babel-runtime/helpers/
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
-var _require = require('./GraphQLValidator'),
-    GLOBAL_RULES = _require.GLOBAL_RULES,
-    LOCAL_RULES = _require.LOCAL_RULES,
-    validate = _require.validate;
+var _require = require('./GraphQLCompilerPublic'),
+    Validator = _require.Validator;
+
+var GLOBAL_RULES = Validator.GLOBAL_RULES,
+    LOCAL_RULES = Validator.LOCAL_RULES,
+    validate = Validator.validate;
+
 
 function DisallowIdAsAliasValidationRule(context) {
   return {

package/lib/RelayViewerHandleTransform.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 RelayViewerHandleTransform
@@ -13,20 +11,26 @@
 
 'use strict';
 
+// TODO T21875029 ../../../relay-runtime/util/RelayDefaultHandleKey
+
 var _extends3 = _interopRequireDefault(require('babel-runtime/helpers/extends'));
 
 var _toConsumableArray3 = _interopRequireDefault(require('babel-runtime/helpers/toConsumableArray'));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
 
-var _require = require('./GraphQLSchemaUtils'),
-    getRawType = _require.getRawType;
+var _require = require('./RelayDefaultHandleKey'),
+    DEFAULT_HANDLE_KEY = _require.DEFAULT_HANDLE_KEY;
+
+var _require2 = require('graphql'),
+    GraphQLObjectType = _require2.GraphQLObjectType;
+
+var _require3 = require('./GraphQLCompilerPublic'),
+    IRTransformer = _require3.IRTransformer,
+    SchemaUtils = _require3.SchemaUtils;
 
-var _require2 = require('./RelayDefaultHandleKey'),
-    DEFAULT_HANDLE_KEY = _require2.DEFAULT_HANDLE_KEY;
+var getRawType = SchemaUtils.getRawType;
 
-var _require3 = require('graphql'),
-    GraphQLObjectType = _require3.GraphQLObjectType;
 
 var ID = 'id';
 var VIEWER_HANDLE = 'viewer';
@@ -35,20 +39,18 @@ var VIEWER_TYPE = 'Viewer';
 /**
  * A transform that adds a "viewer" handle to all fields whose type is `Viewer`.
  */
-function transform(context, schema) {
-  var viewerType = schema.getType(VIEWER_TYPE);
+function relayViewerHandleTransform(context) {
+  var viewerType = context.serverSchema.getType(VIEWER_TYPE);
   if (viewerType == null || !(viewerType instanceof GraphQLObjectType) || viewerType.getFields()[ID] != null) {
     return context;
   }
-  return require('./RelayIRTransformer').transform(context, {
+  return IRTransformer.transform(context, {
     LinkedField: visitLinkedField
-  }, function () {
-    return {};
   });
 }
 
-function visitLinkedField(field, state) {
-  var transformedNode = this.traverse(field, state);
+function visitLinkedField(field) {
+  var transformedNode = this.traverse(field);
   if (getRawType(field.type).name !== VIEWER_TYPE) {
     return transformedNode;
   }
@@ -69,4 +71,6 @@ function visitLinkedField(field, state) {
   return handles !== transformedNode.handles ? (0, _extends3['default'])({}, transformedNode, { handles: handles }) : transformedNode;
 }
 
-module.exports = { transform: transform };
+module.exports = {
+  transform: relayViewerHandleTransform
+};

package/lib/SkipClientFieldTransform.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 SkipClientFieldTransform
@@ -13,10 +11,6 @@
 
 'use strict';
 
-var _extends3 = _interopRequireDefault(require('babel-runtime/helpers/extends'));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }
-
 var _require = require('./GraphQLSchemaUtils'),
     assertTypeWithFields = _require.assertTypeWithFields,
     canHaveSelections = _require.canHaveSelections,
@@ -29,7 +23,7 @@ var _require2 = require('graphql'),
 
 /**
  * A transform that removes any selections that are not valid relative to the
- * given schema. The primary use case is for fields added via client
+ * server schema. The primary use case is for fields added via client
  * `extend type ...` definitions and for inline fragments / fragment spreads
  * whose types are added with client `type ...` type extensions.
  *
@@ -78,46 +72,37 @@ var _require2 = require('graphql'),
  * type, and (2) is removed because the `ClientType` type does not exist in the
  * base schema.
  */
-function transform(context, schema) {
-  return require('./RelayIRTransformer').transform(context, {
+function skipClientFieldTransform(context) {
+  return require('./GraphQLIRTransformer').transform(context, {
     FragmentSpread: visitFragmentSpread,
     InlineFragment: visitInlineFragment,
     LinkedField: visitField,
     ScalarField: visitField
-  }, buildState.bind(null, schema));
+  }, function (node) {
+    return buildState(context, node);
+  });
 }
 
 /**
  * @internal
  *
  * Build the initial state, returning null for fragments whose type is not
- * defined in the original schema.
+ * defined in the server schema.
  */
-function buildState(schema, node) {
-  var parentType = void 0;
+function buildState(context, node) {
+  var schema = context.serverSchema;
   if (node.kind === 'Fragment') {
-    parentType = schema.getType(node.type.name);
-  } else {
-    switch (node.operation) {
-      case 'query':
-        parentType = schema.getQueryType();
-        break;
-      case 'mutation':
-        parentType = schema.getMutationType();
-        break;
-      case 'subscription':
-        parentType = schema.getSubscriptionType();
-        break;
-    }
+    return schema.getType(node.type.name);
   }
-  if (parentType) {
-    return {
-      schema: schema,
-      parentType: parentType
-    };
-  } else {
-    return null;
+  switch (node.operation) {
+    case 'query':
+      return schema.getQueryType();
+    case 'mutation':
+      return schema.getMutationType();
+    case 'subscription':
+      return schema.getSubscriptionType();
   }
+  return null;
 }
 
 /**
@@ -125,21 +110,19 @@ function buildState(schema, node) {
  *
  * Skip fields that were added via `extend type ...`.
  */
-function visitField(field, state) {
+function visitField(field, parentType) {
   if (
   // Field is defined in the original parent type definition:
-  canHaveSelections(state.parentType) && assertTypeWithFields(state.parentType).getFields()[field.name] ||
+  canHaveSelections(parentType) && assertTypeWithFields(parentType).getFields()[field.name] ||
   // Allow metadata fields and fields defined on classic "fat" interfaces
   field.name === SchemaMetaFieldDef.name || field.name === TypeMetaFieldDef.name || field.name === TypeNameMetaFieldDef.name || field.directives.some(function (_ref) {
     var name = _ref.name;
     return name === 'fixme_fat_interface';
   })) {
     var rawType = getRawType(field.type);
-    var type = state.schema.getType(rawType.name);
-    require('fbjs/lib/invariant')(type, 'SkipClientFieldTransform: Expected type `%s` to be defined in ' + 'the original schema.', rawType.name);
-    return this.traverse(field, (0, _extends3['default'])({}, state, {
-      parentType: type
-    }));
+    var type = this.getContext().serverSchema.getType(rawType.name);
+    require('fbjs/lib/invariant')(type, 'SkipClientFieldTransform: Expected type `%s` to be defined in ' + 'the server schema.', rawType.name);
+    return this.traverse(field, type);
   }
   return null;
 }
@@ -150,12 +133,11 @@ function visitField(field, state) {
  * Skip fragment spreads where the referenced fragment is not defined in the
  * original schema.
  */
-function visitFragmentSpread(spread, state) {
+function visitFragmentSpread(spread, parentType) {
   var context = this.getContext();
-  var fragment = context.get(spread.name);
-  require('fbjs/lib/invariant')(fragment && fragment.kind === 'Fragment', 'SkipClientFieldTransform: Expected a fragment named `%s` to be defined.', spread.name);
-  if (state.schema.getType(fragment.type.name)) {
-    return this.traverse(spread, state);
+  var fragment = context.getFragment(spread.name);
+  if (context.serverSchema.getType(fragment.type.name)) {
+    return this.traverse(spread, parentType);
   }
   return null;
 }
@@ -165,14 +147,15 @@ function visitFragmentSpread(spread, state) {
  *
  * Skip inline fragments where the type is not in the schema.
  */
-function visitInlineFragment(fragment, state) {
-  var type = state.schema.getType(fragment.typeCondition.name);
+function visitInlineFragment(fragment, parentType) {
+  var schema = this.getContext().serverSchema;
+  var type = schema.getType(fragment.typeCondition.name);
   if (type) {
-    return this.traverse(fragment, (0, _extends3['default'])({}, state, {
-      parentType: type
-    }));
+    return this.traverse(fragment, type);
   }
   return null;
 }
 
-module.exports = { transform: transform };
+module.exports = {
+  transform: skipClientFieldTransform
+};