react-relay 14.1.0 → 15.0.0

package/lib/ReactRelayTypes.js

@@ -6,5 +6,7 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';

package/lib/RelayContext.js

@@ -6,32 +6,30 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var isRelayEnvironment = require('./isRelayEnvironment');
-
 var invariant = require('invariant');
+
 /**
  * Asserts that the input is a matches the `RelayContext` type defined in
  * `RelayEnvironmentTypes` and returns it as that type.
  */
-
-
 function assertRelayContext(relay) {
   !isRelayContext(relay) ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayContext: Expected `context.relay` to be an object conforming to ' + 'the `RelayContext` interface, got `%s`.', relay) : invariant(false) : void 0;
   return relay;
 }
+
 /**
  * Determine if the input is a plain object that matches the `RelayContext`
  * type defined in `RelayEnvironmentTypes`.
  */
-
-
 function isRelayContext(context) {
   return typeof context === 'object' && context !== null && !Array.isArray(context) && isRelayEnvironment(context.environment);
 }
-
 module.exports = {
   assertRelayContext: assertRelayContext,
   isRelayContext: isRelayContext

package/lib/assertFragmentMap.js

@@ -6,18 +6,18 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var invariant = require('invariant');
+
 /**
  * Fail fast if the user supplies invalid fragments as input.
  */
-
-
 function assertFragmentMap(componentName, fragmentSpec) {
   !(fragmentSpec && typeof fragmentSpec === 'object') ? process.env.NODE_ENV !== "production" ? invariant(false, 'Could not create Relay Container for `%s`. ' + 'Expected a set of GraphQL fragments, got `%s` instead.', componentName, fragmentSpec) : invariant(false) : void 0;
-
   for (var key in fragmentSpec) {
     if (fragmentSpec.hasOwnProperty(key)) {
       var fragment = fragmentSpec[key];
@@ -25,5 +25,4 @@ function assertFragmentMap(componentName, fragmentSpec) {
     }
   }
 }
-
 module.exports = assertFragmentMap;

package/lib/buildReactRelayContainer.js

@@ -6,32 +6,24 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
-
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-
 var assertFragmentMap = require('./assertFragmentMap');
-
 var _require = require('./ReactRelayContainerUtils'),
-    getComponentName = _require.getComponentName,
-    getContainerName = _require.getContainerName;
-
+  getComponentName = _require.getComponentName,
+  getContainerName = _require.getContainerName;
 var ReactRelayContext = require('./ReactRelayContext');
-
 var ReactRelayQueryRendererContext = require('./ReactRelayQueryRendererContext');
-
-var readContext = require('./readContext');
-
 var invariant = require('invariant');
-
 var React = require('react');
-
 var _require2 = require('relay-runtime'),
-    getFragment = _require2.getFragment;
-
+  getFragment = _require2.getFragment;
+var useContext = React.useContext;
 /**
  * Helper to create the Relay HOCs with ref forwarding, setting the displayName
  * and reading the React context.
@@ -41,38 +33,31 @@ function buildReactRelayContainer(ComponentClass, fragmentSpec, createContainerW
   var containerName = getContainerName(ComponentClass);
   assertFragmentMap(getComponentName(ComponentClass), fragmentSpec);
   var fragments = {};
-
   for (var key in fragmentSpec) {
     fragments[key] = getFragment(fragmentSpec[key]);
   }
-
   var Container = createContainerWithFragments(ComponentClass, fragments);
   Container.displayName = containerName;
-
   function forwardRef(props, ref) {
     var _queryRendererContext;
-
-    var context = readContext(ReactRelayContext);
+    var context = useContext(ReactRelayContext);
     !(context != null) ? process.env.NODE_ENV !== "production" ? invariant(false, '`%s` tried to render a context that was not valid this means that ' + '`%s` was rendered outside of a query renderer.', containerName, containerName) : invariant(false) : void 0;
-    var queryRendererContext = readContext(ReactRelayQueryRendererContext);
+    var queryRendererContext = useContext(ReactRelayQueryRendererContext);
     return /*#__PURE__*/React.createElement(Container, (0, _extends2["default"])({}, props, {
       __relayContext: context,
       __rootIsQueryRenderer: (_queryRendererContext = queryRendererContext === null || queryRendererContext === void 0 ? void 0 : queryRendererContext.rootIsQueryRenderer) !== null && _queryRendererContext !== void 0 ? _queryRendererContext : false,
       componentRef: props.componentRef || ref
     }));
   }
-
   forwardRef.displayName = containerName;
   var ForwardContainer = React.forwardRef(forwardRef);
-
   if (process.env.NODE_ENV !== "production") {
     // Used by RelayModernTestUtils
     ForwardContainer.__ComponentClass = ComponentClass;
     ForwardContainer.displayName = containerName;
-  } // $FlowFixMe[incompatible-return]
-
+  }
 
+  // $FlowFixMe[incompatible-return]
   return ForwardContainer;
 }
-
 module.exports = buildReactRelayContainer;

package/lib/getRootVariablesForFragments.js

@@ -6,24 +6,22 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
-
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-
 var _require = require('relay-runtime'),
-    getSelector = _require.getSelector;
-
+  getSelector = _require.getSelector;
 function getRootVariablesForFragments(fragments, props) {
-  var rootVariables = {}; // NOTE: For extra safety, we make sure the rootVariables include the
+  var rootVariables = {};
+  // NOTE: For extra safety, we make sure the rootVariables include the
   // variables from all owners in this fragmentSpec, even though they
   // should all point to the same owner
-
   Object.keys(fragments).forEach(function (key) {
     var _selector$selectors$, _selector$selectors$2, _selector$owner$varia;
-
     var fragmentNode = fragments[key];
     var fragmentRef = props[key];
     var selector = getSelector(fragmentNode, fragmentRef);
@@ -32,5 +30,4 @@ function getRootVariablesForFragments(fragments, props) {
   });
   return rootVariables;
 }
-
 module.exports = getRootVariablesForFragments;

package/lib/hooks.js

@@ -6,42 +6,29 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var EntryPointContainer = require('./relay-hooks/EntryPointContainer.react');
-
 var loadEntryPoint = require('./relay-hooks/loadEntryPoint');
-
 var _require = require('./relay-hooks/loadQuery'),
-    loadQuery = _require.loadQuery;
-
+  loadQuery = _require.loadQuery;
+var ProfilerContext = require('./relay-hooks/ProfilerContext');
 var RelayEnvironmentProvider = require('./relay-hooks/RelayEnvironmentProvider');
-
 var useEntryPointLoader = require('./relay-hooks/useEntryPointLoader');
-
 var useFragment = require('./relay-hooks/useFragment');
-
 var useLazyLoadQuery = require('./relay-hooks/useLazyLoadQuery');
-
 var useMutation = require('./relay-hooks/useMutation');
-
 var usePaginationFragment = require('./relay-hooks/usePaginationFragment');
-
 var usePreloadedQuery = require('./relay-hooks/usePreloadedQuery');
-
 var useQueryLoader = require('./relay-hooks/useQueryLoader');
-
 var useRefetchableFragment = require('./relay-hooks/useRefetchableFragment');
-
 var useRelayEnvironment = require('./relay-hooks/useRelayEnvironment');
-
 var useSubscribeToInvalidationState = require('./relay-hooks/useSubscribeToInvalidationState');
-
 var useSubscription = require('./relay-hooks/useSubscription');
-
 var RelayRuntime = require('relay-runtime');
-
 /**
  * The public interface for Relay Hooks.
  * This will eventually become the main public interface for react-relay.
@@ -56,6 +43,7 @@ module.exports = {
   requestSubscription: RelayRuntime.requestSubscription,
   EntryPointContainer: EntryPointContainer,
   RelayEnvironmentProvider: RelayEnvironmentProvider,
+  ProfilerContext: ProfilerContext,
   fetchQuery: RelayRuntime.fetchQuery,
   loadQuery: loadQuery,
   loadEntryPoint: loadEntryPoint,

package/lib/index.js

@@ -6,56 +6,36 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var ReactRelayContext = require('./ReactRelayContext');
-
 var ReactRelayFragmentContainer = require('./ReactRelayFragmentContainer');
-
 var ReactRelayLocalQueryRenderer = require('./ReactRelayLocalQueryRenderer');
-
 var ReactRelayPaginationContainer = require('./ReactRelayPaginationContainer');
-
 var ReactRelayQueryRenderer = require('./ReactRelayQueryRenderer');
-
 var ReactRelayRefetchContainer = require('./ReactRelayRefetchContainer');
-
 var EntryPointContainer = require('./relay-hooks/EntryPointContainer.react');
-
 var loadEntryPoint = require('./relay-hooks/loadEntryPoint');
-
 var _require = require('./relay-hooks/loadQuery'),
-    loadQuery = _require.loadQuery;
-
+  loadQuery = _require.loadQuery;
+var ProfilerContext = require('./relay-hooks/ProfilerContext');
 var RelayEnvironmentProvider = require('./relay-hooks/RelayEnvironmentProvider');
-
 var useClientQuery = require('./relay-hooks/useClientQuery');
-
 var useEntryPointLoader = require('./relay-hooks/useEntryPointLoader');
-
 var useFragment = require('./relay-hooks/useFragment');
-
 var useLazyLoadQuery = require('./relay-hooks/useLazyLoadQuery');
-
 var useMutation = require('./relay-hooks/useMutation');
-
 var usePaginationFragment = require('./relay-hooks/usePaginationFragment');
-
 var usePreloadedQuery = require('./relay-hooks/usePreloadedQuery');
-
 var useQueryLoader = require('./relay-hooks/useQueryLoader');
-
 var useRefetchableFragment = require('./relay-hooks/useRefetchableFragment');
-
 var useRelayEnvironment = require('./relay-hooks/useRelayEnvironment');
-
 var useSubscribeToInvalidationState = require('./relay-hooks/useSubscribeToInvalidationState');
-
 var useSubscription = require('./relay-hooks/useSubscription');
-
 var RelayRuntime = require('relay-runtime');
-
 /**
  * The public interface to react-relay.
  * Currently contains both Relay Hooks and legacy Container APIs.
@@ -81,6 +61,7 @@ module.exports = {
   // Relay Hooks
   EntryPointContainer: EntryPointContainer,
   RelayEnvironmentProvider: RelayEnvironmentProvider,
+  ProfilerContext: ProfilerContext,
   fetchQuery: RelayRuntime.fetchQuery,
   loadQuery: loadQuery,
   loadEntryPoint: loadEntryPoint,

package/lib/isRelayEnvironment.js

@@ -6,16 +6,18 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
+
 /**
  * Determine if a given value is an object that implements the `Environment`
  * interface defined in `RelayEnvironmentTypes`.
  */
-
 function isRelayEnvironment(environment) {
-  return typeof environment === 'object' && environment !== null && // TODO: add applyMutation/sendMutation once ready in both cores
+  return typeof environment === 'object' && environment !== null &&
+  // TODO: add applyMutation/sendMutation once ready in both cores
   typeof environment.check === 'function' && typeof environment.lookup === 'function' && typeof environment.retain === 'function' && typeof environment.execute === 'function' && typeof environment.subscribe === 'function';
 }
-
 module.exports = isRelayEnvironment;

package/lib/jest-react/enqueueTask.js

@@ -4,24 +4,25 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @emails oncall+relay
  * @format
+ * @oncall relay
  */
+
 // This file is sync'd from https://github.com/facebook/react/tree/main/packages/jest-react
+
 'use strict';
 
 var didWarnAboutMessageChannel = false;
 var enqueueTaskImpl = null;
-
 function enqueueTask(task) {
   if (enqueueTaskImpl === null) {
     try {
       // read require off the module object to get around the bundlers.
       // we don't want them to detect a require and bundle a Node polyfill.
       var requireString = ('require' + Math.random()).slice(0, 7);
-      var nodeRequire = module && module[requireString]; // assuming we're in node, let's try to get node's
+      var nodeRequire = module && module[requireString];
+      // assuming we're in node, let's try to get node's
       // version of setImmediate, bypassing fake timers if any.
-
       enqueueTaskImpl = nodeRequire.call(module, 'timers').setImmediate;
     } catch (_unused) {
       // we're in a browser
@@ -31,23 +32,18 @@ function enqueueTask(task) {
         if (process.env.NODE_ENV !== "production") {
           if (didWarnAboutMessageChannel === false) {
             didWarnAboutMessageChannel = true;
-
             if (typeof MessageChannel === 'undefined') {
               console.error('This browser does not have a MessageChannel implementation, ' + 'so enqueuing tasks via await act(async () => ...) will fail. ' + 'Please file an issue at https://github.com/facebook/react/issues ' + 'if you encounter this warning.');
             }
           }
         }
         /*global MessageChannel*/
-
-
         var channel = new MessageChannel();
         channel.port1.onmessage = callback;
         channel.port2.postMessage(undefined);
       };
     }
   }
-
   return enqueueTaskImpl(task);
 }
-
 module.exports = enqueueTask;

package/lib/jest-react/index.js

@@ -9,5 +9,4 @@ Object.defineProperty(exports, "act", {
     return _internalAct.act;
   }
 });
-
 var _internalAct = require("./internalAct");

package/lib/jest-react/internalAct.js

@@ -4,55 +4,51 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @emails oncall+relay
  * @format
+ * @oncall relay
  */
 
 /* global jest */
+
 // This file is sync'd from https://github.com/facebook/react/tree/main/packages/jest-react
+
 // This version of `act` is only used by our tests. Unlike the public version
 // of `act`, it's designed to work identically in both production and
 // development. It may have slightly different behavior from the public
 // version, too, since our constraints in our test suite are not the same as
 // those of developers using React — we're testing React itself, as opposed to
 // building an app with React.
+
 'use strict';
 
 var enqueueTask = require('./enqueueTask');
+var Scheduler = require('scheduler/unstable_mock');
 
-var Scheduler = require('scheduler/unstable_mock'); // The subset of a Promise that React APIs rely on. This resolves a value.
+// The subset of a Promise that React APIs rely on. This resolves a value.
 // This doesn't require a return value neither from the handler nor the
 // then function.
 
-
 var actingUpdatesScopeDepth = 0;
-
 function act(scope) {
   if (Scheduler.unstable_flushAllWithoutAsserting === undefined) {
     throw Error('This version of `act` requires a special mock build of Scheduler.');
   }
-
   if (setTimeout._isMockFunction !== true) {
     throw Error("This version of `act` requires Jest's timer mocks " + '(i.e. jest.useFakeTimers).');
   }
-
   var previousIsActEnvironment = global.IS_REACT_ACT_ENVIRONMENT;
   var previousActingUpdatesScopeDepth = actingUpdatesScopeDepth;
   actingUpdatesScopeDepth++;
-
   if (process.env.NODE_ENV !== "production" && actingUpdatesScopeDepth === 1) {
     // Because this is not the "real" `act`, we set this to `false` so React
     // knows not to fire `act` warnings.
     global.IS_REACT_ACT_ENVIRONMENT = false;
   }
-
   var unwind = function unwind() {
     if (process.env.NODE_ENV !== "production" && actingUpdatesScopeDepth === 1) {
       global.IS_REACT_ACT_ENVIRONMENT = previousIsActEnvironment;
     }
-
     actingUpdatesScopeDepth--;
-
     if (process.env.NODE_ENV !== "production") {
       if (actingUpdatesScopeDepth > previousActingUpdatesScopeDepth) {
         // if it's _less than_ previousActingUpdatesScopeDepth, then we can
@@ -60,14 +56,13 @@ function act(scope) {
         console.error('You seem to have overlapping act() calls, this is not supported. ' + 'Be sure to await previous act() calls before making a new one. ');
       }
     }
-  }; // TODO: This would be way simpler if 1) we required a promise to be
+  };
+
+  // TODO: This would be way simpler if 1) we required a promise to be
   // returned and 2) we could use async/await. Since it's only our used in
   // our test suite, we should be able to.
-
-
   try {
     var result = scope();
-
     if (typeof result === 'object' && result !== null && typeof result.then === 'function') {
       var thenableResult = result;
       return {
@@ -88,16 +83,13 @@ function act(scope) {
       };
     } else {
       var returnValue = result;
-
       try {
         // TODO: Let's not support non-async scopes at all in our tests. Need to
         // migrate existing tests.
         var didFlushWork;
-
         do {
           didFlushWork = Scheduler.unstable_flushAllWithoutAsserting();
         } while (didFlushWork);
-
         return {
           then: function then(resolve, reject) {
             resolve(returnValue);
@@ -112,7 +104,6 @@ function act(scope) {
     throw error;
   }
 }
-
 function flushActWork(resolve, reject) {
   // Flush suspended fallbacks
   // $FlowFixMe: Flow doesn't know about global Jest object
@@ -120,7 +111,6 @@ function flushActWork(resolve, reject) {
   enqueueTask(function () {
     try {
       var didFlushWork = Scheduler.unstable_flushAllWithoutAsserting();
-
       if (didFlushWork) {
         flushActWork(resolve, reject);
       } else {
@@ -131,5 +121,4 @@ function flushActWork(resolve, reject) {
     }
   });
 }
-
 exports.act = act;

package/lib/legacy.js

@@ -6,23 +6,18 @@
  *
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var ReactRelayContext = require('./ReactRelayContext');
-
 var ReactRelayFragmentContainer = require('./ReactRelayFragmentContainer');
-
 var ReactRelayLocalQueryRenderer = require('./ReactRelayLocalQueryRenderer');
-
 var ReactRelayPaginationContainer = require('./ReactRelayPaginationContainer');
-
 var ReactRelayQueryRenderer = require('./ReactRelayQueryRenderer');
-
 var ReactRelayRefetchContainer = require('./ReactRelayRefetchContainer');
-
 var RelayRuntime = require('relay-runtime');
-
 /**
  * Legacy react-relay exports.
  * Should prefer using interface defined in ./hooks.js

package/lib/multi-actor/ActorChange.js

@@ -5,17 +5,15 @@
  * LICENSE file in the root directory of this source tree.
  *
  * 
- * @emails oncall+relay
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var RelayEnvironmentProvider = require('../relay-hooks/RelayEnvironmentProvider');
-
 var useRelayActorEnvironment = require('./useRelayActorEnvironment');
-
 var React = require('react');
-
 function ActorChange(props) {
   var actorEnvironment = useRelayActorEnvironment(props.actorChangePoint.__viewer);
   var getEnvironmentForActor = React.useCallback(function (actorIdentifier) {
@@ -26,5 +24,4 @@ function ActorChange(props) {
     getEnvironmentForActor: getEnvironmentForActor
   }, props.children(props.actorChangePoint.__fragmentRef, props.actorChangePoint.__viewer));
 }
-
 module.exports = ActorChange;

package/lib/multi-actor/index.js

@@ -5,7 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  *
  * 
- * @emails oncall+relay
  * @format
+ * @oncall relay
  */
+
 'use strict';

package/lib/multi-actor/useRelayActorEnvironment.js

@@ -4,19 +4,17 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @emails oncall+relay
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
+var ReactRelayContext = require('./../ReactRelayContext');
 var invariant = require('invariant');
-
 var _require = require('react'),
-    useContext = _require.useContext;
-
-var ReactRelayContext = require('react-relay/ReactRelayContext');
-
+  useContext = _require.useContext;
 function useRelayActorEnvironment(actorIdentifier) {
   var context = useContext(ReactRelayContext);
   !(context != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'useRelayActorEnvironment: Expected to have found a Relay environment provided by ' + 'a `RelayEnvironmentProvider` component. ' + 'This usually means that useRelayActorEnvironment was used in a ' + 'component that is not a descendant of a `RelayEnvironmentProvider`. ' + 'Please make sure a `RelayEnvironmentProvider` has been rendered somewhere ' + 'as a parent or ancestor of your component.') : invariant(false) : void 0;
@@ -24,5 +22,4 @@ function useRelayActorEnvironment(actorIdentifier) {
   !(getEnvironmentForActor != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'useRelayActorEnvironment: Expected to have a function `getEnvironmentForActor`.' + 'This usually means that `RelayEnvironmentProvider`. was not properly set up for use in the ' + 'multi actor application. Please make sure the provider has defined a `getEnvironmentForActor`.') : invariant(false) : void 0;
   return getEnvironmentForActor(actorIdentifier);
 }
-
 module.exports = useRelayActorEnvironment;

package/lib/relay-hooks/EntryPointContainer.react.js

@@ -4,33 +4,29 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @emails oncall+relay
  * 
  * @format
+ * @oncall relay
  */
+
 'use strict';
 
 var ProfilerContext = require('./ProfilerContext');
-
 var useRelayEnvironment = require('./useRelayEnvironment');
-
 var React = require('react');
-
 var _require = require('react'),
-    useContext = _require.useContext,
-    useEffect = _require.useEffect;
-
+  useContext = _require.useContext,
+  useEffect = _require.useEffect;
 var warning = require("fbjs/lib/warning");
-
 function EntryPointContainer(_ref) {
   var entryPointReference = _ref.entryPointReference,
-      props = _ref.props;
+    props = _ref.props;
   process.env.NODE_ENV !== "production" ? warning(entryPointReference.isDisposed === false, '<EntryPointContainer>: Expected entryPointReference to not be disposed ' + 'yet. This is because disposing the entrypoint marks it for future garbage ' + 'collection, and as such may no longer be present in the Relay store. ' + 'In the future, this will become a hard error.') : void 0;
   var getComponent = entryPointReference.getComponent,
-      queries = entryPointReference.queries,
-      entryPoints = entryPointReference.entryPoints,
-      extraProps = entryPointReference.extraProps,
-      rootModuleID = entryPointReference.rootModuleID;
+    queries = entryPointReference.queries,
+    entryPoints = entryPointReference.entryPoints,
+    extraProps = entryPointReference.extraProps,
+    rootModuleID = entryPointReference.rootModuleID;
   var Component = getComponent();
   var profilerContext = useContext(ProfilerContext);
   var environment = useRelayEnvironment();
@@ -48,5 +44,4 @@ function EntryPointContainer(_ref) {
     queries: queries
   });
 }
-
 module.exports = EntryPointContainer;

package/lib/relay-hooks/EntryPointTypes.flow.js

@@ -4,8 +4,11 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @emails oncall+relay
  * 
  * @format
+ * @oncall relay
  */
-'use strict';
+
+'use strict';
+
+/* eslint-disable no-unused-vars */