relay-compiler 9.0.0 → 10.1.0

package/lib/transforms/TestOperationTransform.js

@@ -13,7 +13,11 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
 
 var IRTransformer = require('../core/IRTransformer');
 
@@ -40,10 +44,10 @@ function getTypeDetails(schema, fieldType) {
   var isPlural = schema.isList(nullableType);
   var type = schema.getRawType(nullableType);
   return {
-    type: schema.getTypeString(type),
     enumValues: schema.isEnum(type) ? schema.getEnumValues(schema.assertEnumType(type)) : null,
+    nullable: isNullable,
     plural: isPlural,
-    nullable: isNullable
+    type: schema.getTypeString(type)
   };
 }
 
@@ -57,7 +61,6 @@ function visitRoot(node) {
     return node;
   }
 
-  var context = this.getContext();
   var queue = [{
     selections: node.selections,
     path: null
@@ -72,15 +75,7 @@ function visitRoot(node) {
     currentSelections.forEach(function (selection) {
       switch (selection.kind) {
         case 'FragmentSpread':
-          var fragment = context.get(selection.name);
-
-          if (fragment != null) {
-            queue.unshift({
-              selections: fragment.selections,
-              path: path
-            });
-          }
-
+          // We don't expect to have fragment spreads at this point (it's operations only transform step)
           break;
 
         case 'ScalarField':
@@ -95,7 +90,7 @@ function visitRoot(node) {
             var _nextPath = path === null ? selection.alias : "".concat(path, ".").concat(selection.alias);
 
             selectionsTypeInfo[_nextPath] = getTypeDetails(schema, selection.type);
-            queue.unshift({
+            queue.push({
               selections: selection.selections,
               path: _nextPath
             });
@@ -103,18 +98,21 @@ function visitRoot(node) {
           }
 
         case 'Condition':
-        case 'ClientExtension':
         case 'Defer':
         case 'InlineDataFragmentSpread':
         case 'InlineFragment':
         case 'ModuleImport':
         case 'Stream':
-          queue.unshift({
+          queue.push({
             selections: selection.selections,
             path: path
           });
           break;
 
+        case 'ClientExtension':
+          // Clinet extensions are not part of the schema. We should not generate type info.
+          break;
+
         default:
           selection;
           break;
@@ -124,14 +122,22 @@ function visitRoot(node) {
 
   while (queue.length > 0) {
     _loop();
-  }
+  } // Sort selectionsTypeInfo
 
-  return (0, _objectSpread2["default"])({}, node, {
+
+  var keys = Object.keys(selectionsTypeInfo).sort(function (a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+  });
+  var sortedSelectionsTypeInfo = {};
+  keys.forEach(function (key) {
+    sortedSelectionsTypeInfo[key] = selectionsTypeInfo[key];
+  });
+  return _objectSpread(_objectSpread({}, node), {}, {
     directives: node.directives.filter(function (directive) {
       return directive !== testDirective;
     }),
-    metadata: (0, _objectSpread2["default"])({}, node.metadata || {}, {
-      relayTestingSelectionTypeInfo: selectionsTypeInfo
+    metadata: _objectSpread(_objectSpread({}, node.metadata || {}), {}, {
+      relayTestingSelectionTypeInfo: sortedSelectionsTypeInfo
     })
   });
 }

package/lib/transforms/ValidateGlobalVariablesTransform.js

@@ -10,6 +10,12 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 var inferRootArgumentDefinitions = require('../core/inferRootArgumentDefinitions');
 
 var _require = require('../core/CompilerError'),
@@ -33,12 +39,12 @@ function validateGlobalVariablesTransform(context) {
     var usedArguments = argumentDefinitionsToMap(nodeWithUsedArguments.argumentDefinitions); // All used arguments must be defined
 
     var undefinedVariables = [];
-    var _iteratorNormalCompletion = true;
-    var _didIteratorError = false;
-    var _iteratorError = undefined;
+
+    var _iterator = _createForOfIteratorHelper(usedArguments.values()),
+        _step;
 
     try {
-      for (var _iterator = usedArguments.values()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
         var argDef = _step.value;
 
         if (!definedArguments.has(argDef.name)) {
@@ -46,18 +52,9 @@ function validateGlobalVariablesTransform(context) {
         }
       }
     } catch (err) {
-      _didIteratorError = true;
-      _iteratorError = err;
+      _iterator.e(err);
     } finally {
-      try {
-        if (!_iteratorNormalCompletion && _iterator["return"] != null) {
-          _iterator["return"]();
-        }
-      } finally {
-        if (_didIteratorError) {
-          throw _iteratorError;
-        }
-      }
+      _iterator.f();
     }
 
     if (undefinedVariables.length !== 0) {
@@ -73,28 +70,19 @@ function validateGlobalVariablesTransform(context) {
 
 function argumentDefinitionsToMap(argDefs) {
   var map = new Map();
-  var _iteratorNormalCompletion2 = true;
-  var _didIteratorError2 = false;
-  var _iteratorError2 = undefined;
+
+  var _iterator2 = _createForOfIteratorHelper(argDefs),
+      _step2;
 
   try {
-    for (var _iterator2 = argDefs[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
       var argDef = _step2.value;
       map.set(argDef.name, argDef);
     }
   } catch (err) {
-    _didIteratorError2 = true;
-    _iteratorError2 = err;
+    _iterator2.e(err);
   } finally {
-    try {
-      if (!_iteratorNormalCompletion2 && _iterator2["return"] != null) {
-        _iterator2["return"]();
-      }
-    } finally {
-      if (_didIteratorError2) {
-        throw _iteratorError2;
-      }
-    }
+    _iterator2.f();
   }
 
   return map;

package/lib/transforms/ValidateRequiredArgumentsTransform.js

@@ -10,6 +10,12 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 var IRValidator = require('../core/IRValidator');
 
 var _require = require('../core/CompilerError'),
@@ -86,12 +92,12 @@ function validateRequiredArgumentsOnNode(schema, node, definitionArgs, rootNode)
   var nodeArgsSet = new Set(node.args.map(function (arg) {
     return arg.name;
   }));
-  var _iteratorNormalCompletion = true;
-  var _didIteratorError = false;
-  var _iteratorError = undefined;
+
+  var _iterator = _createForOfIteratorHelper(definitionArgs),
+      _step;
 
   try {
-    for (var _iterator = definitionArgs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
       var arg = _step.value;
 
       if (arg.defaultValue == null && schema.isNonNull(arg.type) && !nodeArgsSet.has(arg.name)) {
@@ -99,18 +105,9 @@ function validateRequiredArgumentsOnNode(schema, node, definitionArgs, rootNode)
       }
     }
   } catch (err) {
-    _didIteratorError = true;
-    _iteratorError = err;
+    _iterator.e(err);
   } finally {
-    try {
-      if (!_iteratorNormalCompletion && _iterator["return"] != null) {
-        _iterator["return"]();
-      }
-    } finally {
-      if (_didIteratorError) {
-        throw _iteratorError;
-      }
-    }
+    _iterator.f();
   }
 }
 

package/lib/transforms/ValidateServerOnlyDirectivesTransform.js

@@ -10,6 +10,12 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 var IRValidator = require('../core/IRValidator');
 
 var _require = require('../core/CompilerError'),
@@ -44,56 +50,36 @@ function stopVisit() {} // Only visits selections as an optimization to not look
 
 
 function visitLinkedField(node, state) {
-  var _iteratorNormalCompletion = true;
-  var _didIteratorError = false;
-  var _iteratorError = undefined;
+  var _iterator = _createForOfIteratorHelper(node.selections),
+      _step;
 
   try {
-    for (var _iterator = node.selections[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
       var selection = _step.value;
       this.visit(selection, state);
     }
   } catch (err) {
-    _didIteratorError = true;
-    _iteratorError = err;
+    _iterator.e(err);
   } finally {
-    try {
-      if (!_iteratorNormalCompletion && _iterator["return"] != null) {
-        _iterator["return"]();
-      }
-    } finally {
-      if (_didIteratorError) {
-        throw _iteratorError;
-      }
-    }
+    _iterator.f();
   }
 }
 
 function visitClientExtension(node, state) {
-  var _iteratorNormalCompletion2 = true;
-  var _didIteratorError2 = false;
-  var _iteratorError2 = undefined;
+  var _iterator2 = _createForOfIteratorHelper(node.selections),
+      _step2;
 
   try {
-    for (var _iterator2 = node.selections[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
       var selection = _step2.value;
       this.visit(selection, {
         rootClientSelection: selection
       });
     }
   } catch (err) {
-    _didIteratorError2 = true;
-    _iteratorError2 = err;
+    _iterator2.e(err);
   } finally {
-    try {
-      if (!_iteratorNormalCompletion2 && _iterator2["return"] != null) {
-        _iterator2["return"]();
-      }
-    } finally {
-      if (_didIteratorError2) {
-        throw _iteratorError2;
-      }
-    }
+    _iterator2.f();
   }
 }
 

package/lib/transforms/ValidateUnusedVariablesTransform.js

@@ -10,6 +10,12 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 var inferRootArgumentDefinitions = require('../core/inferRootArgumentDefinitions');
 
 var _require = require('../core/CompilerError'),
@@ -34,28 +40,19 @@ function validateUnusedVariablesTransform(context) {
     }));
     var nodeWithUsedArguments = contextWithUsedArguments.getRoot(node.name);
     var usedArguments = argumentDefinitionsToMap(nodeWithUsedArguments.argumentDefinitions);
-    var _iteratorNormalCompletion = true;
-    var _didIteratorError = false;
-    var _iteratorError = undefined;
+
+    var _iterator = _createForOfIteratorHelper(usedArguments.keys()),
+        _step;
 
     try {
-      for (var _iterator = usedArguments.keys()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
         var usedArgumentName = _step.value;
         rootArgumentLocations["delete"](usedArgumentName);
       }
     } catch (err) {
-      _didIteratorError = true;
-      _iteratorError = err;
+      _iterator.e(err);
     } finally {
-      try {
-        if (!_iteratorNormalCompletion && _iterator["return"] != null) {
-          _iterator["return"]();
-        }
-      } finally {
-        if (_didIteratorError) {
-          throw _iteratorError;
-        }
-      }
+      _iterator.f();
     }
 
     var ignoreErrorDirective = node.directives.find(function (_ref) {
@@ -77,28 +74,19 @@ function validateUnusedVariablesTransform(context) {
 
 function argumentDefinitionsToMap(argDefs) {
   var map = new Map();
-  var _iteratorNormalCompletion2 = true;
-  var _didIteratorError2 = false;
-  var _iteratorError2 = undefined;
+
+  var _iterator2 = _createForOfIteratorHelper(argDefs),
+      _step2;
 
   try {
-    for (var _iterator2 = argDefs[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
       var argDef = _step2.value;
       map.set(argDef.name, argDef);
     }
   } catch (err) {
-    _didIteratorError2 = true;
-    _iteratorError2 = err;
+    _iterator2.e(err);
   } finally {
-    try {
-      if (!_iteratorNormalCompletion2 && _iterator2["return"] != null) {
-        _iterator2["return"]();
-      }
-    } finally {
-      if (_didIteratorError2) {
-        throw _iteratorError2;
-      }
-    }
+    _iterator2.f();
   }
 
   return map;

package/lib/transforms/query-generators/FetchableQueryGenerator.js

@@ -0,0 +1,161 @@
+/**
+ * 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
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+var SchemaUtils = require('../../core/SchemaUtils');
+
+var _require = require('../../core/CompilerError'),
+    createUserError = _require.createUserError;
+
+var _require2 = require('./utils'),
+    buildFragmentSpread = _require2.buildFragmentSpread,
+    buildOperationArgumentDefinitions = _require2.buildOperationArgumentDefinitions;
+
+function buildRefetchOperation(schema, fragment, queryName) {
+  var fetchableIdentifierField = null;
+
+  if (schema.isObject(fragment.type)) {
+    var objectType = schema.assertObjectType(fragment.type);
+    fetchableIdentifierField = schema.getFetchableFieldName(objectType);
+  }
+
+  if (fetchableIdentifierField == null) {
+    return null;
+  }
+
+  var identifierField = schema.getFieldConfig(schema.expectField(fragment.type, fetchableIdentifierField));
+
+  if (!schema.isId(schema.getRawType(identifierField.type))) {
+    var typeName = schema.getTypeString(fragment.type);
+    throw createUserError("Invalid use of @refetchable on fragment '".concat(fragment.name, "', the type ") + "'".concat(typeName, "' is @fetchable but the identifying field '").concat(fetchableIdentifierField, "' ") + "does not have type 'ID'.", [fragment.loc]);
+  }
+
+  var queryType = schema.expectQueryType();
+  var fetchFieldName = "fetch__".concat(schema.getTypeString(fragment.type));
+  var fetchField = schema.getFieldConfig(schema.expectField(queryType, fetchFieldName));
+
+  if (!(fetchField != null && schema.isObject(fetchField.type) && schema.areEqualTypes(fetchField.type, fragment.type) && schema.areEqualTypes(schema.getNullableType(fetchField.args[0].type), schema.expectIdType()))) {
+    var _typeName = schema.getTypeString(fragment.type);
+
+    throw createUserError("Invalid use of @refetchable on fragment '".concat(fragment.name, "', the type ") + "'".concat(_typeName, "' is @fetchable but there is no corresponding '").concat(fetchFieldName, "'") + "field or it is invalid (expected '".concat(fetchFieldName, "(id: ID!): ").concat(_typeName, "')."), [fragment.loc]);
+  } // name and type of the node(_: ID) field parameter
+
+
+  var idArgName = fetchField.args[0].name;
+  var idArgType = fetchField.args[0].type; // name and type of the query variable
+
+  var idVariableType = SchemaUtils.getNonNullIdInput(schema);
+  var idVariableName = 'id';
+  var argumentDefinitions = buildOperationArgumentDefinitions(fragment.argumentDefinitions);
+  var idArgument = argumentDefinitions.find(function (argDef) {
+    return argDef.name === idVariableName;
+  });
+
+  if (idArgument != null) {
+    throw createUserError("Invalid use of @refetchable on fragment `".concat(fragment.name, "`, this ") + 'fragment already has an `$id` variable in scope.', [idArgument.loc]);
+  }
+
+  var argumentDefinitionsWithId = [].concat((0, _toConsumableArray2["default"])(argumentDefinitions), [{
+    defaultValue: null,
+    kind: 'LocalArgumentDefinition',
+    loc: {
+      kind: 'Derived',
+      source: fragment.loc
+    },
+    name: idVariableName,
+    type: idVariableType
+  }]);
+  return {
+    identifierField: fetchableIdentifierField,
+    path: [fetchFieldName],
+    node: {
+      argumentDefinitions: argumentDefinitionsWithId,
+      directives: [],
+      kind: 'Root',
+      loc: {
+        kind: 'Derived',
+        source: fragment.loc
+      },
+      metadata: null,
+      name: queryName,
+      operation: 'query',
+      selections: [{
+        alias: fetchFieldName,
+        args: [{
+          kind: 'Argument',
+          loc: {
+            kind: 'Derived',
+            source: fragment.loc
+          },
+          name: idArgName,
+          type: schema.assertInputType(idArgType),
+          value: {
+            kind: 'Variable',
+            loc: {
+              kind: 'Derived',
+              source: fragment.loc
+            },
+            variableName: idVariableName,
+            type: idVariableType
+          }
+        }],
+        connection: false,
+        directives: [],
+        handles: null,
+        kind: 'LinkedField',
+        loc: {
+          kind: 'Derived',
+          source: fragment.loc
+        },
+        metadata: null,
+        name: fetchFieldName,
+        selections: [buildFragmentSpread(fragment)],
+        type: fragment.type
+      }],
+      type: queryType
+    },
+    transformedFragment: enforceIDField(schema, fragment, fetchableIdentifierField)
+  };
+}
+
+function enforceIDField(schema, fragment, fetchableIdentifierField) {
+  var idSelection = fragment.selections.find(function (selection) {
+    return selection.kind === 'ScalarField' && selection.name === fetchableIdentifierField && selection.alias === fetchableIdentifierField && schema.areEqualTypes(schema.getNullableType(selection.type), schema.expectIdType());
+  });
+
+  if (idSelection) {
+    return fragment;
+  }
+
+  var idField = SchemaUtils.generateIDField(schema, fragment.type); // idField is uniquely owned here, safe to mutate
+
+  idField.alias = fetchableIdentifierField; // idField is uniquely owned here, safe to mutate
+
+  idField.name = fetchableIdentifierField;
+  return _objectSpread(_objectSpread({}, fragment), {}, {
+    selections: [].concat((0, _toConsumableArray2["default"])(fragment.selections), [idField])
+  });
+}
+
+module.exports = {
+  description: '@fetchable types',
+  buildRefetchOperation: buildRefetchOperation
+};

package/lib/transforms/query-generators/NodeQueryGenerator.js

@@ -12,12 +12,18 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
 var SchemaUtils = require('../../core/SchemaUtils');
 
+var nullthrows = require('nullthrows');
+
 var _require = require('../../core/CompilerError'),
     createUserError = _require.createUserError;
 
@@ -80,6 +86,7 @@ function buildRefetchOperation(schema, fragment, queryName) {
     type: idVariableType
   }]);
   return {
+    identifierField: 'id',
     path: [NODE_FIELD_NAME],
     node: {
       argumentDefinitions: argumentDefinitionsWithId,
@@ -140,8 +147,20 @@ function enforceIDField(schema, fragment) {
     return fragment;
   }
 
-  return (0, _objectSpread2["default"])({}, fragment, {
-    selections: [].concat((0, _toConsumableArray2["default"])(fragment.selections), [SchemaUtils.generateIDField(schema.expectIdType())])
+  var idField = schema.getFieldByName(fragment.type, 'id');
+  var nodeType = schema.assertCompositeType(nullthrows(schema.getTypeFromString(NODE_TYPE_NAME)));
+  var generatedIDSelection = idField ? SchemaUtils.generateIDField(schema, fragment.type) : {
+    kind: 'InlineFragment',
+    directives: [],
+    loc: {
+      kind: 'Generated'
+    },
+    metadata: null,
+    selections: [SchemaUtils.generateIDField(schema, nodeType)],
+    typeCondition: nodeType
+  };
+  return _objectSpread(_objectSpread({}, fragment), {}, {
+    selections: [].concat((0, _toConsumableArray2["default"])(fragment.selections), [generatedIDSelection])
   });
 }
 

package/lib/transforms/query-generators/QueryQueryGenerator.js

@@ -22,6 +22,7 @@ function buildRefetchOperation(schema, fragment, queryName) {
   }
 
   return {
+    identifierField: null,
     path: [],
     node: {
       argumentDefinitions: buildOperationArgumentDefinitions(fragment.argumentDefinitions),
@@ -42,6 +43,6 @@ function buildRefetchOperation(schema, fragment, queryName) {
 }
 
 module.exports = {
-  description: 'the query type',
+  description: 'the Query type',
   buildRefetchOperation: buildRefetchOperation
 };

package/lib/transforms/query-generators/ViewerQueryGenerator.js

@@ -36,6 +36,7 @@ function buildRefetchOperation(schema, fragment, queryName) {
   }
 
   return {
+    identifierField: null,
     path: [VIEWER_FIELD_NAME],
     node: {
       argumentDefinitions: buildOperationArgumentDefinitions(fragment.argumentDefinitions),