react-relay 14.1.0 → 16.0.0

package/lib/relay-hooks/HooksImplementation.js

@@ -1,28 +1,14 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * 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
- */
 'use strict';
 
 var warning = require("fbjs/lib/warning");
-
 var implementation = null;
-
 function inject(impl) {
   process.env.NODE_ENV !== "production" ? warning(implementation !== null, 'Relay HooksImplementation was injected twice.') : void 0;
   implementation = impl;
 }
-
 function get() {
   return implementation;
 }
-
 module.exports = {
   inject: inject,
   get: get

package/lib/relay-hooks/InternalLogger.js

@@ -1,17 +1,6 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * 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
- */
 'use strict';
 
 var loggerImpl = function loggerImpl(eventData) {};
-
 module.exports = {
   setLoggerImplementation: function setLoggerImplementation(loggerFn) {
     loggerImpl = loggerFn;

package/lib/relay-hooks/LRUCache.js

@@ -1,90 +1,51 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * 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
- */
 'use strict';
 
 var invariant = require('invariant');
-
-/**
- * JS maps (both plain objects and Map) maintain key insertion
- * order, which means there is an easy way to simulate LRU behavior
- * that should also perform quite well:
- *
- * To insert a new value, first delete the key from the inner _map,
- * then _map.set(k, v). By deleting and reinserting, you ensure that the
- * map sees the key as the last inserted key.
- *
- * Get does the same: if the key is present, delete and reinsert it.
- */
 var LRUCache = /*#__PURE__*/function () {
   function LRUCache(capacity) {
     this._capacity = capacity;
     !(this._capacity > 0) ? process.env.NODE_ENV !== "production" ? invariant(false, 'LRUCache: Unable to create instance of cache with zero or negative capacity.') : invariant(false) : void 0;
     this._map = new Map();
   }
-
   var _proto = LRUCache.prototype;
-
   _proto.set = function set(key, value) {
     this._map["delete"](key);
-
     this._map.set(key, value);
-
     if (this._map.size > this._capacity) {
       var firstKey = this._map.keys().next();
-
       if (!firstKey.done) {
         this._map["delete"](firstKey.value);
       }
     }
   };
-
   _proto.get = function get(key) {
     var value = this._map.get(key);
-
     if (value != null) {
       this._map["delete"](key);
-
       this._map.set(key, value);
     }
-
     return value;
   };
-
   _proto.has = function has(key) {
     return this._map.has(key);
   };
-
   _proto["delete"] = function _delete(key) {
     this._map["delete"](key);
   };
-
   _proto.size = function size() {
     return this._map.size;
   };
-
   _proto.capacity = function capacity() {
     return this._capacity - this._map.size;
   };
-
   _proto.clear = function clear() {
     this._map.clear();
   };
-
   return LRUCache;
 }();
-
 function create(capacity) {
   return new LRUCache(capacity);
 }
-
 module.exports = {
   create: create
 };

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

@@ -1,127 +1,90 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * 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
- */
 'use strict';
 
 var preloadQuery_DEPRECATED = require('./preloadQuery_DEPRECATED');
-
 var ProfilerContext = require('./ProfilerContext');
-
 var useRelayEnvironment = require('./useRelayEnvironment');
-
 var React = require('react');
-
 var _require = require('react'),
-    useContext = _require.useContext,
-    useEffect = _require.useEffect,
-    useMemo = _require.useMemo;
-
+  useContext = _require.useContext,
+  useEffect = _require.useEffect,
+  useMemo = _require.useMemo;
 var _require2 = require('relay-runtime'),
-    stableCopy = _require2.stableCopy;
-
+  stableCopy = _require2.stableCopy;
 function stableStringify(value) {
   var _JSON$stringify;
-
   return (_JSON$stringify = JSON.stringify(stableCopy(value))) !== null && _JSON$stringify !== void 0 ? _JSON$stringify : 'null';
 }
-
 function prepareEntryPoint(environmentProvider, entryPoint, entryPointParams) {
-  // Start loading the code for the entrypoint
   var loadingPromise = null;
-
   if (entryPoint.root.getModuleIfRequired() == null) {
     loadingPromise = entryPoint.root.load();
   }
-
   var preloadProps = entryPoint.getPreloadProps(entryPointParams);
   var queries = preloadProps.queries,
-      entryPoints = preloadProps.entryPoints,
-      extraProps = preloadProps.extraProps;
+    entryPoints = preloadProps.entryPoints,
+    extraProps = preloadProps.extraProps;
   var preloadedQueries = {};
   var preloadedEntryPoints = {};
-
   if (queries != null) {
     var queriesPropNames = Object.keys(queries);
     queriesPropNames.forEach(function (queryPropName) {
       var _queries$queryPropNam = queries[queryPropName],
-          environmentProviderOptions = _queries$queryPropNam.environmentProviderOptions,
-          options = _queries$queryPropNam.options,
-          parameters = _queries$queryPropNam.parameters,
-          variables = _queries$queryPropNam.variables;
+        environmentProviderOptions = _queries$queryPropNam.environmentProviderOptions,
+        options = _queries$queryPropNam.options,
+        parameters = _queries$queryPropNam.parameters,
+        variables = _queries$queryPropNam.variables;
       var environment = environmentProvider.getEnvironment(environmentProviderOptions);
       preloadedQueries[queryPropName] = preloadQuery_DEPRECATED(environment, parameters, variables, options, environmentProviderOptions);
     });
   }
-
   if (entryPoints != null) {
     var entryPointPropNames = Object.keys(entryPoints);
     entryPointPropNames.forEach(function (entryPointPropName) {
       var entryPointDescription = entryPoints[entryPointPropName];
-
       if (entryPointDescription == null) {
         return;
       }
-
       var nestedEntryPoint = entryPointDescription.entryPoint,
-          nestedParams = entryPointDescription.entryPointParams;
+        nestedParams = entryPointDescription.entryPointParams;
       preloadedEntryPoints[entryPointPropName] = prepareEntryPoint(environmentProvider, nestedEntryPoint, nestedParams);
     });
   }
-
   return {
     entryPoints: preloadedEntryPoints,
     extraProps: extraProps !== null && extraProps !== void 0 ? extraProps : null,
     getComponent: function getComponent() {
       var component = entryPoint.root.getModuleIfRequired();
-
       if (component == null) {
         var _loadingPromise;
-
         loadingPromise = (_loadingPromise = loadingPromise) !== null && _loadingPromise !== void 0 ? _loadingPromise : entryPoint.root.load();
         throw loadingPromise;
-      } // $FlowFixMe[incompatible-cast] - trust me Flow, its entryPoint component
-
-
+      }
       return component;
     },
     queries: preloadedQueries,
     rootModuleID: entryPoint.root.getModuleId()
   };
 }
-
 function LazyLoadEntryPointContainer_DEPRECATED(_ref) {
   var entryPoint = _ref.entryPoint,
-      entryPointParams = _ref.entryPointParams,
-      props = _ref.props,
-      environmentProvider = _ref.environmentProvider;
+    entryPointParams = _ref.entryPointParams,
+    props = _ref.props,
+    environmentProvider = _ref.environmentProvider;
   var environment = useRelayEnvironment();
-  var getPreloadProps = entryPoint.getPreloadProps; // IMPORTANT: Loading the component may suspend (throw), so the props
-  // *must* be computed first to fetch the component's data-dependencies in
-  // parallel with the component itself (the code).
-
+  var getPreloadProps = entryPoint.getPreloadProps;
   var entryPointParamsHash = stableStringify(entryPointParams);
-
   var _useMemo = useMemo(function () {
-    return prepareEntryPoint(environmentProvider !== null && environmentProvider !== void 0 ? environmentProvider : {
-      getEnvironment: function getEnvironment() {
-        return environment;
-      }
-    }, entryPoint, entryPointParams); // NOTE: stableParams encodes the information from params
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [environment, environmentProvider, getPreloadProps, entryPointParamsHash]),
-      getComponent = _useMemo.getComponent,
-      queries = _useMemo.queries,
-      entryPoints = _useMemo.entryPoints,
-      extraProps = _useMemo.extraProps,
-      rootModuleID = _useMemo.rootModuleID;
-
+      return prepareEntryPoint(environmentProvider !== null && environmentProvider !== void 0 ? environmentProvider : {
+        getEnvironment: function getEnvironment() {
+          return environment;
+        }
+      }, entryPoint, entryPointParams);
+    }, [environment, environmentProvider, getPreloadProps, entryPointParamsHash]),
+    getComponent = _useMemo.getComponent,
+    queries = _useMemo.queries,
+    entryPoints = _useMemo.entryPoints,
+    extraProps = _useMemo.extraProps,
+    rootModuleID = _useMemo.rootModuleID;
   var Component = useMemo(function () {
     return getComponent();
   }, [getComponent]);
@@ -140,5 +103,4 @@ function LazyLoadEntryPointContainer_DEPRECATED(_ref) {
     queries: queries
   });
 }
-
 module.exports = LazyLoadEntryPointContainer_DEPRECATED;

package/lib/relay-hooks/MatchContainer.js

@@ -1,126 +1,29 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * 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
- */
 'use strict';
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
-
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-
 var React = require('react');
-
 var useMemo = React.useMemo;
-/**
- * Renders the results of a data-driven dependency fetched with the `@match`
- * directive. The `@match` directive can be used to specify a mapping of
- * result types to the containers used to render those types. The result
- * value is an opaque object that described which component was selected
- * and a reference to its data. Use <MatchContainer/> to render these
- * values.
- *
- * ## Example
- *
- * For example, consider a piece of media content that might be text or
- * an image, where for clients that don't support images the application
- * should fall back to rendering the image caption as text. @match can be
- * used to dynamically select whether to render a given media item as
- * an image or text (on the server) and then fetch the corresponding
- * React component and its data dependencies (information about the
- * image or about the text).
- *
- * ```
- * // Media.react.js
- *
- * // Define a React component that uses <MatchContainer /> to render the
- * // results of a @module selection
- * function Media(props) {
- *   const {media, ...restProps} = props;
- *
- *   const loader = moduleReference => {
- *      // given the data returned by your server for the @module directive,
- *      // return the React component (or throw a Suspense promise if
- *      // it is loading asynchronously).
- *      todo_returnModuleOrThrowPromise(moduleReference);
- *   };
- *   return <MatchContainer
- *     loader={loader}
- *     match={media.mediaAttachment}
- *     props={restProps}
- *   />;
- * }
- *
- * module.exports = createSuspenseFragmentContainer(
- *   Media,
- *   {
- *     media: graphql`
- *       fragment Media_media on Media {
- *         # ...
- *         mediaAttachment @match {
- *            ...ImageContainer_image @module(name: "ImageContainer.react")
- *            ...TextContainer_text @module(name: "TextContainer.react")
- *         }
- *       }
- *     `
- *   },
- * );
- * ```
- *
- * ## API
- *
- * MatchContainer accepts the following props:
- * - `match`: The results (an opaque object) of a `@match` field.
- * - `props`: Props that should be passed through to the dynamically
- *   selected component. Note that any of the components listed in
- *   `@module()` could be selected, so all components should accept
- *   the value passed here.
- * - `loader`: A function to load a module given a reference (whatever
- *   your server returns for the `js(moduleName: String)` field).
- *
- */
-// Note: this type is intentionally non-exact, it is expected that the
-// object may contain sibling fields.
-
 function MatchContainer(_ref2) {
   var _ref;
-
   var fallback = _ref2.fallback,
-      loader = _ref2.loader,
-      match = _ref2.match,
-      props = _ref2.props;
-
+    loader = _ref2.loader,
+    match = _ref2.match,
+    props = _ref2.props;
   if (match != null && typeof match !== 'object') {
     throw new Error('MatchContainer: Expected `match` value to be an object or null/undefined.');
-  } // NOTE: the MatchPointer type has a $fragmentSpreads field to ensure that only
-  // an object that contains a FragmentSpread can be passed. If the fragment
-  // spread matches, then the metadata fields below (__id, __fragments, etc.)
-  // will be present. But they can be missing if all the fragment spreads use
-  // @module and none of the types matched. The cast here is necessary because
-  // fragment Flow types don't describe metadata fields, only the actual schema
-  // fields the developer selected.
-
-
+  }
   var _ref3 = (_ref = match) !== null && _ref !== void 0 ? _ref : {},
-      __id = _ref3.__id,
-      __fragments = _ref3.__fragments,
-      __fragmentOwner = _ref3.__fragmentOwner,
-      __fragmentPropName = _ref3.__fragmentPropName,
-      __module_component = _ref3.__module_component;
-
+    __id = _ref3.__id,
+    __fragments = _ref3.__fragments,
+    __fragmentOwner = _ref3.__fragmentOwner,
+    __fragmentPropName = _ref3.__fragmentPropName,
+    __module_component = _ref3.__module_component;
   if (__fragmentOwner != null && typeof __fragmentOwner !== 'object' || __fragmentPropName != null && typeof __fragmentPropName !== 'string' || __fragments != null && typeof __fragments !== 'object' || __id != null && typeof __id !== 'string') {
     throw new Error("MatchContainer: Invalid 'match' value, expected an object that has a " + "'...SomeFragment' spread.");
   }
-
   var LoadedContainer = __module_component != null ? loader(__module_component) : null;
   var fragmentProps = useMemo(function () {
-    // TODO: Perform this transformation in RelayReader so that unchanged
-    // output of subscriptions already has a stable identity.
     if (__fragmentPropName != null && __id != null && __fragments != null) {
       var fragProps = {};
       fragProps[__fragmentPropName] = {
@@ -130,17 +33,12 @@ function MatchContainer(_ref2) {
       };
       return fragProps;
     }
-
     return null;
   }, [__id, __fragments, __fragmentOwner, __fragmentPropName]);
-
   if (LoadedContainer != null && fragmentProps != null) {
-    // $FlowFixMe[incompatible-type]
-    // $FlowFixMe[cannot-spread-indexer]
     return /*#__PURE__*/React.createElement(LoadedContainer, (0, _extends2["default"])({}, props, fragmentProps));
   } else {
     return fallback !== null && fallback !== void 0 ? fallback : null;
   }
 }
-
 module.exports = MatchContainer;

package/lib/relay-hooks/NestedRelayEntryPointBuilderUtils.js

@@ -0,0 +1,9 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NestedRelayEntryPoint = NestedRelayEntryPoint;
+function NestedRelayEntryPoint(params) {
+  return params;
+}

package/lib/relay-hooks/ProfilerContext.js

@@ -1,20 +1,6 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * 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
- */
-// This contextual profiler can be used to wrap a react sub-tree. It will bind
-// the RelayProfiler during the render phase of these components. Allows
-// collecting metrics for a specific part of your application.
 'use strict';
 
 var React = require('react');
-
 var ProfilerContext = React.createContext({
   wrapPrepareQueryResource: function wrapPrepareQueryResource(cb) {
     return cb();