relay-compiler 0.0.0-main-4d287de9 → 0.0.0-main-9a79039d

package/lib/transforms/RefetchableFragmentTransform.js

@@ -1,249 +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
- */
-// flowlint ambiguous-object-type:error
-'use strict';
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-
-var _require = require('../core/CompilerError'),
-    createUserError = _require.createUserError,
-    eachWithCombinedError = _require.eachWithCombinedError;
-
-var getLiteralArgumentValues = require('../core/getLiteralArgumentValues');
-
-var inferRootArgumentDefinitions = require('../core/inferRootArgumentDefinitions');
-
-var IRVisitor = require('../core/IRVisitor');
-
-var _require2 = require('./query-generators'),
-    buildRefetchOperation = _require2.buildRefetchOperation;
-
-var SCHEMA_EXTENSION = "\n  directive @refetchable(\n    queryName: String!\n  ) on FRAGMENT_DEFINITION\n";
-/**
- * This transform synthesizes "refetch" queries for fragments that
- * are trivially refetchable. This is comprised of three main stages:
- *
- * 1. Validating that fragments marked with @refetchable qualify for
- *    refetch query generation; mainly this means that the fragment
- *    type is able to be refetched in some canonical way.
- * 2. Determining the variable definitions to use for each generated
- *    query. GraphQL does not have a notion of fragment-local variables
- *    at all, and although Relay adds this concept developers are still
- *    allowed to reference global variables. This necessitates a
- *    visiting all reachable fragments for each @refetchable fragment,
- *    and finding the union of all global variables expceted to be defined.
- * 3. Building the refetch queries, a straightforward copying transform from
- *    Fragment to Root IR nodes.
- */
-
-function refetchableFragmentTransform(context) {
-  var schema = context.getSchema();
-  var refetchOperations = buildRefetchMap(context);
-  var nextContext = context;
-  eachWithCombinedError(refetchOperations, function (_ref) {
-    var refetchName = _ref[0],
-        fragment = _ref[1];
-
-    var _buildRefetchOperatio = buildRefetchOperation(schema, fragment, refetchName),
-        identifierField = _buildRefetchOperatio.identifierField,
-        path = _buildRefetchOperatio.path,
-        node = _buildRefetchOperatio.node,
-        transformedFragment = _buildRefetchOperatio.transformedFragment;
-
-    var connectionMetadata = extractConnectionMetadata(context.getSchema(), transformedFragment);
-    nextContext = nextContext.replace((0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedFragment), {}, {
-      metadata: (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedFragment.metadata || {}), {}, {
-        refetch: {
-          connection: connectionMetadata !== null && connectionMetadata !== void 0 ? connectionMetadata : null,
-          operation: refetchName,
-          fragmentPathInResult: path,
-          identifierField: identifierField
-        }
-      })
-    }));
-    nextContext = nextContext.add((0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, node), {}, {
-      metadata: (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, node.metadata || {}), {}, {
-        derivedFrom: transformedFragment.name,
-        isRefetchableQuery: true
-      })
-    }));
-  });
-  return nextContext;
-}
-/**
- * Walk the documents of a compiler context and create a mapping of
- * refetch operation names to the source fragment from which the refetch
- * operation should be derived.
- */
-
-
-function buildRefetchMap(context) {
-  var refetchOperations = new Map();
-  eachWithCombinedError(context.documents(), function (node) {
-    if (node.kind !== 'Fragment') {
-      return;
-    }
-
-    var refetchName = getRefetchQueryName(node);
-
-    if (refetchName === null) {
-      return;
-    }
-
-    var previousOperation = refetchOperations.get(refetchName);
-
-    if (previousOperation != null) {
-      throw createUserError("Duplicate definition for @refetchable operation '".concat(refetchName, "' from fragments '").concat(node.name, "' and '").concat(previousOperation.name, "'"), [node.loc, previousOperation.loc]);
-    }
-
-    refetchOperations.set(refetchName, node);
-  });
-  var transformed = inferRootArgumentDefinitions(context);
-  return new Map(Array.from(refetchOperations.entries(), function (_ref2) {
-    var name = _ref2[0],
-        fragment = _ref2[1];
-    return [name, transformed.getFragment(fragment.name)];
-  }));
-}
-/**
- * Validate that any @connection usage is valid for refetching:
- * - Variables are used for both the "count" and "cursor" arguments
- *   (after/first or before/last)
- * - Exactly one connection
- * - Has a stable path to the connection data
- *
- * Returns connection metadata to add to the transformed fragment or undefined
- * if there is no connection.
- */
-
-
-function extractConnectionMetadata(schema, fragment) {
-  var fields = [];
-  var connectionField = null;
-  var path = null;
-  IRVisitor.visit(fragment, {
-    LinkedField: {
-      enter: function enter(field) {
-        fields.push(field);
-
-        if (field.connection === true || field.handles && field.handles.some(function (handle) {
-          return handle.name === 'connection';
-        })) {
-          // Disallow multiple @connections
-          if (connectionField != null) {
-            throw createUserError("Invalid use of @refetchable with @connection in fragment '".concat(fragment.name, "', at most once @connection can appear in a refetchable fragment."), [field.loc]);
-          } // Disallow connections within plurals
-
-
-          var pluralOnPath = fields.find(function (pathField) {
-            return schema.isList(schema.getNullableType(pathField.type));
-          });
-
-          if (pluralOnPath) {
-            throw createUserError("Invalid use of @refetchable with @connection in fragment '".concat(fragment.name, "', refetchable connections cannot appear inside plural fields."), [field.loc, pluralOnPath.loc]);
-          }
-
-          connectionField = field;
-          path = fields.map(function (pathField) {
-            return pathField.alias;
-          });
-        }
-      },
-      leave: function leave() {
-        fields.pop();
-      }
-    }
-  });
-
-  if (connectionField == null || path == null) {
-    return;
-  } // Validate arguments: if either of before/last appear they must both appear
-  // and use variables (not scalar values)
-
-
-  var backward = null;
-  var before = findArgument(connectionField, 'before');
-  var last = findArgument(connectionField, 'last');
-
-  if (before || last) {
-    if (!before || !last || before.value.kind !== 'Variable' || last.value.kind !== 'Variable') {
-      throw createUserError("Invalid use of @refetchable with @connection in fragment '".concat(fragment.name, "', refetchable connections must use variables for the before and last arguments."), [connectionField.loc, before && before.value.kind !== 'Variable' ? before.value.loc : null, last && last.value.kind !== 'Variable' ? last.value.loc : null].filter(Boolean));
-    }
-
-    backward = {
-      count: last.value.variableName,
-      cursor: before.value.variableName
-    };
-  } // Validate arguments: if either of after/first appear they must both appear
-  // and use variables (not scalar values)
-
-
-  var forward = null;
-  var after = findArgument(connectionField, 'after');
-  var first = findArgument(connectionField, 'first');
-
-  if (after || first) {
-    if (!after || !first || after.value.kind !== 'Variable' || first.value.kind !== 'Variable') {
-      throw createUserError("Invalid use of @refetchable with @connection in fragment '".concat(fragment.name, "', refetchable connections must use variables for the after and first arguments."), [connectionField.loc, after && after.value.kind !== 'Variable' ? after.value.loc : null, first && first.value.kind !== 'Variable' ? first.value.loc : null].filter(Boolean));
-    }
-
-    forward = {
-      count: first.value.variableName,
-      cursor: after.value.variableName
-    };
-  }
-
-  return {
-    forward: forward,
-    backward: backward,
-    path: path
-  };
-}
-
-function getRefetchQueryName(fragment) {
-  var refetchableDirective = fragment.directives.find(function (directive) {
-    return directive.name === 'refetchable';
-  });
-
-  if (refetchableDirective == null) {
-    return null;
-  }
-
-  var refetchArguments = getLiteralArgumentValues(refetchableDirective.args);
-  var queryName = refetchArguments.queryName;
-
-  if (queryName == null) {
-    throw createUserError("Expected the 'queryName' argument of @refetchable to be provided", [refetchableDirective.loc]);
-  } else if (typeof queryName !== 'string') {
-    var _queryNameArg$loc;
-
-    var queryNameArg = refetchableDirective.args.find(function (arg) {
-      return arg.name === 'queryName';
-    });
-    throw createUserError("Expected the 'queryName' argument of @refetchable to be a string, got '".concat(String(queryName), "'."), [(_queryNameArg$loc = queryNameArg === null || queryNameArg === void 0 ? void 0 : queryNameArg.loc) !== null && _queryNameArg$loc !== void 0 ? _queryNameArg$loc : refetchableDirective.loc]);
-  }
-
-  return queryName;
-}
-
-function findArgument(field, argumentName) {
-  var _field$args$find;
-
-  return (_field$args$find = field.args.find(function (arg) {
-    return arg.name === argumentName;
-  })) !== null && _field$args$find !== void 0 ? _field$args$find : null;
-}
-
-module.exports = {
-  SCHEMA_EXTENSION: SCHEMA_EXTENSION,
-  transform: refetchableFragmentTransform
-};

package/lib/transforms/RelayDirectiveTransform.js

@@ -1,83 +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
- */
-// flowlint ambiguous-object-type:error
-'use strict';
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-
-var getLiteralArgumentValues = require('../core/getLiteralArgumentValues');
-
-var IRTransformer = require('../core/IRTransformer');
-
-var invariant = require('invariant');
-
-var RELAY = 'relay';
-var SCHEMA_EXTENSION = "\ndirective @relay(\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) on FRAGMENT_DEFINITION | FRAGMENT_SPREAD\n";
-/**
- * A transform that extracts `@relay(plural: Boolean)` directives and converts
- * them to metadata that can be accessed at runtime.
- */
-
-function relayDirectiveTransform(context) {
-  return IRTransformer.transform(context, {
-    Fragment: visitRelayMetadata(fragmentMetadata),
-    FragmentSpread: visitRelayMetadata(fragmentSpreadMetadata)
-  });
-}
-
-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, _objectSpread2["default"])((0, _objectSpread2["default"])({}, node), {}, {
-      directives: node.directives.filter(function (directive) {
-        return directive !== relayDirective;
-      }),
-      // $FlowFixMe[cannot-spread-indexer]
-      metadata: (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, node.metadata || {}), metadata)
-    }));
-  };
-}
-
-function fragmentMetadata(_ref2) {
-  var mask = _ref2.mask,
-      plural = _ref2.plural;
-  !(plural === undefined || typeof plural === 'boolean') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayDirectiveTransform: Expected the "plural" argument to @relay ' + 'to be a boolean literal if specified.') : invariant(false) : void 0;
-  !(mask === undefined || typeof mask === 'boolean') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayDirectiveTransform: Expected the "mask" argument to @relay ' + 'to be a boolean literal if specified.') : invariant(false) : void 0;
-  return {
-    mask: mask,
-    plural: plural
-  };
-}
-
-function fragmentSpreadMetadata(_ref3) {
-  var mask = _ref3.mask;
-  !(mask === undefined || typeof mask === 'boolean') ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayDirectiveTransform: Expected the "mask" argument to @relay ' + 'to be a boolean literal if specified.') : invariant(false) : void 0;
-  return {
-    mask: mask
-  };
-}
-
-module.exports = {
-  RELAY: RELAY,
-  SCHEMA_EXTENSION: SCHEMA_EXTENSION,
-  transform: relayDirectiveTransform
-};

package/lib/transforms/RequiredFieldTransform.js

@@ -1,369 +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
- */
-// flowlint ambiguous-object-type:error
-'use strict';
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
-
-var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-var _require = require('../core/CompilerError'),
-    createCompilerError = _require.createCompilerError,
-    createUserError = _require.createUserError;
-
-var IRTransformer = require('../core/IRTransformer');
-
-var partitionArray = require('../util/partitionArray');
-
-var _require2 = require('relay-runtime'),
-    RelayFeatureFlags = _require2.RelayFeatureFlags;
-
-var SCHEMA_EXTENSION = "\n  enum RequiredFieldAction {\n    NONE\n    LOG\n    THROW\n  }\n  directive @required(\n    action: RequiredFieldAction!\n  ) on FIELD\n";
-/**
- * This transform rewrites ScalarField and LinkedField nodes with a @required
- * directive into fields with the directives stripped and sets the `required`
- * and `path` metadata values.
- */
-
-function requiredFieldTransform(context) {
-  var schema = context.getSchema();
-  return IRTransformer.transform(context, {
-    LinkedField: visitLinkedField,
-    ScalarField: vistitScalarField,
-    InlineFragment: visitInlineFragment,
-    Fragment: visitFragment,
-    Root: visitRoot
-  }, function (node) {
-    return {
-      schema: schema,
-      documentName: node.name,
-      path: [],
-      pathRequiredMap: new Map(),
-      currentNodeRequiredChildren: new Map(),
-      requiredChildrenMap: new Map(),
-      parentAbstractInlineFragment: null
-    };
-  });
-}
-
-function visitFragment(fragment, state) {
-  return addChildrenCanBubbleMetadata(this.traverse(fragment, state), state);
-}
-
-function visitRoot(root, state) {
-  return addChildrenCanBubbleMetadata(this.traverse(root, state), state);
-}
-
-function visitInlineFragment(fragment, state) {
-  var _state$parentAbstract;
-
-  // Ideally we could allow @required when the direct parent inline fragment was
-  // on a concrete type, but we would need to solve this bug in our Flow type
-  // generation first: T65695438
-  var parentAbstractInlineFragment = (_state$parentAbstract = state.parentAbstractInlineFragment) !== null && _state$parentAbstract !== void 0 ? _state$parentAbstract : getAbstractInlineFragment(fragment, state.schema);
-  return this.traverse(fragment, (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, state), {}, {
-    parentAbstractInlineFragment: parentAbstractInlineFragment
-  }));
-}
-
-function getAbstractInlineFragment(fragment, schema) {
-  var typeCondition = fragment.typeCondition;
-
-  if (schema.isAbstractType(typeCondition)) {
-    return fragment;
-  }
-
-  return null;
-} // Convert action to a number so that we can numerically compare their severity.
-
-
-function getActionSeverity(action) {
-  switch (action) {
-    case 'NONE':
-      return 0;
-
-    case 'LOG':
-      return 1;
-
-    case 'THROW':
-      return 2;
-
-    default:
-      action;
-      throw createCompilerError("Unhandled action type ".concat(action));
-  }
-}
-
-function visitLinkedField(field, state) {
-  var path = [].concat((0, _toConsumableArray2["default"])(state.path), [field.alias]);
-  var newState = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, state), {}, {
-    currentNodeRequiredChildren: new Map(),
-    path: path,
-    parentAbstractInlineFragment: null
-  });
-  var newField = this.traverse(field, newState);
-  var pathName = path.join('.');
-  assertCompatibleRequiredChildren(field, pathName, newState);
-  newField = applyDirectives(newField, pathName, state.documentName);
-  assertCompatibleNullability(newField, pathName, newState.pathRequiredMap);
-  var directiveMetadata = getRequiredDirectiveMetadata(newField);
-
-  if (directiveMetadata != null) {
-    assertParentIsNotInvalidInlineFragmet(state.schema, directiveMetadata, state.parentAbstractInlineFragment);
-    state.currentNodeRequiredChildren.set(field.alias, newField);
-    var severity = getActionSeverity(directiveMetadata.action); // Assert that all @required children have at least this severity.
-
-    newState.currentNodeRequiredChildren.forEach(function (childField) {
-      var childMetadata = getRequiredDirectiveMetadata(childField);
-
-      if (childMetadata == null) {
-        return;
-      }
-
-      if (getActionSeverity(childMetadata.action) < severity) {
-        throw createUserError("The @required field [1] may not have an `action` less severe than that of its @required parent [2]. [1] should probably be `action: ".concat(directiveMetadata.action, "`."), [childMetadata.actionLoc, directiveMetadata.actionLoc]);
-      }
-    });
-  }
-
-  state.requiredChildrenMap.set(pathName, newState.currentNodeRequiredChildren);
-  return addChildrenCanBubbleMetadata(newField, newState);
-}
-
-function vistitScalarField(field, state) {
-  var pathName = [].concat((0, _toConsumableArray2["default"])(state.path), [field.alias]).join('.');
-  var newField = applyDirectives(field, pathName, state.documentName);
-  var directiveMetadata = getRequiredDirectiveMetadata(newField);
-
-  if (directiveMetadata != null) {
-    assertParentIsNotInvalidInlineFragmet(state.schema, directiveMetadata, state.parentAbstractInlineFragment);
-    state.currentNodeRequiredChildren.set(field.alias, newField);
-  }
-
-  assertCompatibleNullability(newField, pathName, state.pathRequiredMap);
-  return newField;
-}
-
-function addChildrenCanBubbleMetadata(node, state) {
-  var _iterator = (0, _createForOfIteratorHelper2["default"])(state.currentNodeRequiredChildren.values()),
-      _step;
-
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var child = _step.value;
-      var requiredMetadata = getRequiredDirectiveMetadata(child);
-
-      if (requiredMetadata != null && requiredMetadata.action !== 'THROW') {
-        var metadata = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, node.metadata), {}, {
-          childrenCanBubbleNull: true
-        });
-        return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, node), {}, {
-          metadata: metadata
-        });
-      }
-    }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
-  }
-
-  return node;
-}
-
-function assertParentIsNotInvalidInlineFragmet(schema, directiveMetadata, parentAbstractInlineFragment) {
-  if (parentAbstractInlineFragment == null) {
-    return;
-  }
-
-  var typeCondition = parentAbstractInlineFragment.typeCondition;
-
-  if (schema.isUnion(typeCondition)) {
-    throw createUserError('The @required directive [1] may not be used anywhere within an inline fragment on a union type [2].', [directiveMetadata.directiveLoc, parentAbstractInlineFragment.loc]);
-  } else if (schema.isInterface(typeCondition)) {
-    throw createUserError('The @required directive [1] may not be used anywhere within an inline fragment on an interface type [2].', [directiveMetadata.directiveLoc, parentAbstractInlineFragment.loc]);
-  } else {
-    throw createCompilerError('Unexpected abstract inline fragment type.', [parentAbstractInlineFragment.loc]);
-  }
-} // Check that this field's nullability matches all other instances.
-
-
-function assertCompatibleNullability(field, pathName, pathRequiredMap) {
-  var existingField = pathRequiredMap.get(pathName);
-
-  if (existingField == null) {
-    pathRequiredMap.set(pathName, field);
-    return;
-  }
-
-  var requiredMetadata = getRequiredDirectiveMetadata(field);
-  var existingRequiredMetadata = getRequiredDirectiveMetadata(existingField);
-
-  if ((requiredMetadata === null || requiredMetadata === void 0 ? void 0 : requiredMetadata.action) === (existingRequiredMetadata === null || existingRequiredMetadata === void 0 ? void 0 : existingRequiredMetadata.action)) {
-    return;
-  }
-
-  if (requiredMetadata == null) {
-    throw createUserError("The field \"".concat(field.alias, "\" is @required in [1] but not in [2]."), [existingField.loc, field.loc]);
-  }
-
-  if (existingRequiredMetadata == null) {
-    throw createUserError("The field \"".concat(field.alias, "\" is @required in [1] but not in [2]."), [field.loc, existingField.loc]);
-  }
-
-  throw createUserError("The field \"".concat(field.alias, "\" has a different @required action in [1] than in [2]."), [requiredMetadata.actionLoc, existingRequiredMetadata.actionLoc]);
-} // Metadata is untyped, so we use this utility function to do the type coersion.
-
-
-function getRequiredDirectiveMetadata(field) {
-  var _field$metadata;
-
-  return (_field$metadata = field.metadata) === null || _field$metadata === void 0 ? void 0 : _field$metadata.required;
-} // Check that this field has the same required children as all other instances.
-
-
-function assertCompatibleRequiredChildren(field, fieldPath, _ref) {
-  var currentNodeRequiredChildren = _ref.currentNodeRequiredChildren,
-      pathRequiredMap = _ref.pathRequiredMap,
-      requiredChildrenMap = _ref.requiredChildrenMap;
-  var previouslyRequiredChildren = requiredChildrenMap.get(fieldPath);
-
-  if (previouslyRequiredChildren == null) {
-    return;
-  } // Check if this field has a required child field which was previously omitted.
-
-
-  var _iterator2 = (0, _createForOfIteratorHelper2["default"])(currentNodeRequiredChildren),
-      _step2;
-
-  try {
-    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-      var _step2$value = _step2.value,
-          path = _step2$value[0],
-          childField = _step2$value[1];
-
-      if (!previouslyRequiredChildren.has(path)) {
-        var otherParent = pathRequiredMap.get(fieldPath);
-
-        if (otherParent == null) {
-          throw createCompilerError("Could not find other parent node at path \"".concat(fieldPath, "\"."), [childField.loc]);
-        }
-
-        throw createMissingRequiredFieldError(childField, otherParent);
-      }
-    } // Check if a previous reference to this field had a required child field which we are missing.
-
-  } catch (err) {
-    _iterator2.e(err);
-  } finally {
-    _iterator2.f();
-  }
-
-  var _iterator3 = (0, _createForOfIteratorHelper2["default"])(previouslyRequiredChildren),
-      _step3;
-
-  try {
-    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-      var _step3$value = _step3.value,
-          _path = _step3$value[0],
-          _childField = _step3$value[1];
-
-      if (!currentNodeRequiredChildren.has(_path)) {
-        throw createMissingRequiredFieldError(_childField, field);
-      }
-    }
-  } catch (err) {
-    _iterator3.e(err);
-  } finally {
-    _iterator3.f();
-  }
-}
-
-function createMissingRequiredFieldError(requiredChild, missingParent) {
-  var alias = requiredChild.alias;
-  return createUserError("The field \"".concat(alias, "\" is marked as @required in [1] but is missing in [2]."), [requiredChild.loc, missingParent.loc]);
-} // TODO T74397896: Remove prefix gating once @required is rolled out more broadly.
-
-
-function featureIsEnabled(documentName) {
-  var featureFlag = RelayFeatureFlags.ENABLE_REQUIRED_DIRECTIVES;
-
-  if (typeof featureFlag === 'boolean') {
-    return featureFlag;
-  } else if (featureFlag === 'LIMITED') {
-    return documentName.startsWith('RelayRequiredTest');
-  } else if (typeof featureFlag === 'string') {
-    return featureFlag.split('|').some(function (prefix) {
-      return documentName.startsWith(prefix);
-    });
-  }
-
-  return false;
-} // Strip and validate @required directives, and convert them to metadata.
-
-
-function applyDirectives(field, pathName, documentName) {
-  var _partitionArray = partitionArray(field.directives, function (directive) {
-    return directive.name === 'required';
-  }),
-      requiredDirectives = _partitionArray[0],
-      otherDirectives = _partitionArray[1];
-
-  if (requiredDirectives.length === 0) {
-    return field;
-  }
-
-  if (!featureIsEnabled(documentName)) {
-    throw new createUserError( // Purposefully don't include details in this error message, since we
-    // don't want folks adopting this feature until it's been tested more.
-    'The @required directive is experimental and not yet supported for use in product code', requiredDirectives.map(function (x) {
-      return x.loc;
-    }));
-  }
-
-  if (requiredDirectives.length > 1) {
-    throw new createUserError('Did not expect multiple @required directives.', requiredDirectives.map(function (x) {
-      return x.loc;
-    }));
-  }
-
-  var requiredDirective = requiredDirectives[0];
-  var arg = requiredDirective.args[0]; // I would expect this check to be handled by the schema validation, but...
-
-  if (arg == null) {
-    throw createUserError('The @required directive requires an `action` argument.', [requiredDirective.loc]);
-  }
-
-  if (arg.value.kind !== 'Literal') {
-    throw createUserError('Expected @required `action` argument to be a literal.', [arg.value.loc]);
-  }
-
-  return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field), {}, {
-    directives: otherDirectives,
-    metadata: (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, field.metadata), {}, {
-      required: {
-        action: arg.value.value,
-        actionLoc: arg.loc,
-        directiveLoc: requiredDirective.loc,
-        path: pathName
-      }
-    })
-  });
-} // Transform @required directive to metadata
-
-
-module.exports = {
-  SCHEMA_EXTENSION: SCHEMA_EXTENSION,
-  transform: requiredFieldTransform
-};