react-relay 13.0.0-rc.0 → 13.0.1

package/relay-hooks/__flowtests__/useFragment-flowtest.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.
@@ -12,52 +12,74 @@
 // flowlint ambiguous-object-type:error
 
 import type {
-  NonNullableData,
-  NonNullablePluralData,
-  NullableData,
-  NullablePluralData,
-} from './utils';
+  useFragmentFlowtest_user$data,
+  useFragmentFlowtest_user$key,
+} from './__generated__/useFragmentFlowtest_user.graphql';
+import typeof useFragmentFlowtest_user$fragment from './__generated__/useFragmentFlowtest_user.graphql';
+import type {
+  useFragmentFlowtest_users$data,
+  useFragmentFlowtest_users$key,
+} from './__generated__/useFragmentFlowtest_users.graphql';
+import typeof useFragmentFlowtest_users$fragment from './__generated__/useFragmentFlowtest_users.graphql';
 
 import useFragment from '../useFragment';
-import {
-  fragmentData,
-  fragmentInput,
-  keyAnotherNonNullable,
-  keyAnotherNullable,
-  keyNonNullable,
-  keyNonNullablePlural,
-  keyNullable,
-  keyNullablePlural,
-} from './utils';
+import {graphql} from 'relay-runtime';
+
+declare var Any: $FlowFixMe;
+
+const userFragment: useFragmentFlowtest_user$fragment = graphql`
+  fragment useFragmentFlowtest_user on User {
+    id
+  }
+`;
+
+const usersFragment: useFragmentFlowtest_users$fragment = graphql`
+  fragment useFragmentFlowtest_users on User @relay(plural: true) {
+    id
+  }
+`;
 
 /* eslint-disable react-hooks/rules-of-hooks */
 
 // Nullability of returned data type is correct
-(useFragment(fragmentInput, keyNonNullable): NonNullableData);
-(useFragment(fragmentInput, keyNullable): NullableData);
-(useFragment(fragmentInput, keyNonNullablePlural): NonNullablePluralData);
-(useFragment(fragmentInput, keyNullablePlural): NullablePluralData);
+(useFragment(
+  userFragment,
+  (Any: useFragmentFlowtest_user$key),
+): useFragmentFlowtest_user$data);
+(useFragment(
+  userFragment,
+  (Any: ?useFragmentFlowtest_user$key),
+): ?useFragmentFlowtest_user$data);
+(useFragment(
+  usersFragment,
+  (Any: useFragmentFlowtest_users$key),
+): useFragmentFlowtest_users$data);
+(useFragment(
+  usersFragment,
+  (Any: ?useFragmentFlowtest_users$key),
+): ?useFragmentFlowtest_users$data);
 
 // $FlowExpectedError: can't cast nullable to non-nullable
-(useFragment(fragmentInput, keyNullable): NonNullableData);
+(useFragment(
+  userFragment,
+  (Any: ?useFragmentFlowtest_user$key),
+): useFragmentFlowtest_user$data);
 // $FlowExpectedError: can't cast nullable plural to non-nullable plural
-(useFragment(fragmentInput, keyNullablePlural): NonNullablePluralData);
-
-// $FlowExpectedError: actual type of returned data is correct
-(useFragment(fragmentInput, keyAnotherNonNullable): NonNullableData);
-// $FlowExpectedError
-(useFragment(fragmentInput, keyAnotherNullable): NullableData);
+(useFragment(
+  usersFragment,
+  (Any: ?useFragmentFlowtest_users$key),
+): useFragmentFlowtest_users$data);
 
 // $FlowExpectedError: Key should be one of the generated types
-(useFragment(fragmentInput, 'INVALID_KEY'): NullableData);
+useFragment(userFragment, 'INVALID_KEY');
 
 // $FlowExpectedError: Key should not be a user provided object
-useFragment(fragmentInput, {a: 123});
+useFragment(userFragment, {a: 123});
 
 // $FlowExpectedError: Key should not be an empty object
-useFragment(fragmentInput, {});
+useFragment(userFragment, {});
 
 // $FlowExpectedError: Key should be the `<name>$key` type from generated flow
-useFragment(fragmentInput, fragmentData);
+useFragment(userFragment, (Any: useFragmentFlowtest_user$data));
 
 /* eslint-enable react-hooks/rules-of-hooks */

package/relay-hooks/__flowtests__/usePaginationFragment-flowtest.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/__flowtests__/useRefetchableFragment-flowtest.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/__flowtests__/utils.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.
@@ -13,17 +13,26 @@
 
 'use strict';
 
-import type {Disposable, FragmentType, GraphQLTaggedNode} from 'relay-runtime';
+import type {Disposable, Fragment, FragmentType} from 'relay-runtime';
 
-declare export var fragmentInput: GraphQLTaggedNode;
+declare export var fragmentInput: Fragment<
+  Example_user$fragmentType,
+  Example_user$data,
+>;
+
+declare export opaque type Example_user$fragmentType: FragmentType;
+export type Example_user$data = NonNullableData;
+export type Example_user$key = {
+  +$data?: Example_user$data,
+  +$fragmentSpreads: Example_user$fragmentType,
+  ...
+};
 
 export type NonNullableData = {|
   +id: string,
   +count: number,
 |};
-
 export type NullableData = ?NonNullableData;
-
 export type NonNullablePluralData = $ReadOnlyArray<NonNullableData>;
 export type NullablePluralData = ?$ReadOnlyArray<NonNullableData>;
 
@@ -32,29 +41,13 @@ export type AnotherNonNullableData = {|
   +friends: ?number,
 |};
 
-declare export var keyNonNullable: {
-  +$data?: NonNullableData,
-  +$fragmentSpreads: FragmentType,
-  ...
-};
+declare export var keyNonNullable: Example_user$key;
 
-declare export var keyNonNullablePlural: $ReadOnlyArray<{
-  +$data?: NonNullablePluralData,
-  +$fragmentSpreads: FragmentType,
-  ...
-}>;
+declare export var keyNonNullablePlural: $ReadOnlyArray<Example_user$key>;
 
-declare export var keyNullablePlural: ?$ReadOnlyArray<{
-  +$data?: NonNullablePluralData,
-  +$fragmentSpreads: FragmentType,
-  ...
-}>;
+declare export var keyNullablePlural: ?$ReadOnlyArray<Example_user$key>;
 
-declare export var keyNullable: ?{
-  +$data?: NonNullableData,
-  +$fragmentSpreads: FragmentType,
-  ...
-};
+declare export var keyNullable: ?Example_user$key;
 
 declare export var keyAnotherNonNullable: {
   +$data: AnotherNonNullableData,

package/relay-hooks/loadEntryPoint.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/loadQuery.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/preloadQuery_DEPRECATED.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/prepareEntryPoint_DEPRECATED.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useBlockingPaginationFragment.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useEntryPointLoader.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useFetchTrackingRef.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useFragment.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.
@@ -13,7 +13,7 @@
 
 'use strict';
 
-import type {FragmentType, GraphQLTaggedNode} from 'relay-runtime';
+import type {Fragment, FragmentType, GraphQLTaggedNode} from 'relay-runtime';
 
 const {useTrackLoadQueryInRender} = require('./loadQuery');
 const useFragmentNode = require('./useFragmentNode');
@@ -21,45 +21,34 @@ const useStaticFragmentNodeWarning = require('./useStaticFragmentNodeWarning');
 const {useDebugValue} = require('react');
 const {getFragment} = require('relay-runtime');
 
+type HasSpread<TFragmentType> = {
+  +$fragmentSpreads: TFragmentType,
+  ...
+};
+
 // if the key is non-nullable, return non-nullable value
-declare function useFragment<
-  TKey: {+$data?: mixed, +$fragmentSpreads: FragmentType, ...},
->(
-  fragment: GraphQLTaggedNode,
-  key: TKey,
-): $Call<<TData>({+$data?: TData, ...}) => TData, TKey>;
+declare function useFragment<TFragmentType: FragmentType, TData>(
+  fragment: Fragment<TFragmentType, TData>,
+  key: HasSpread<TFragmentType>,
+): TData;
 
 // if the key is nullable, return nullable value
-declare function useFragment<
-  TKey: ?{+$data?: mixed, +$fragmentSpreads: FragmentType, ...},
->(
-  fragment: GraphQLTaggedNode,
-  key: TKey,
-): $Call<<TData>(?{+$data?: TData, ...}) => ?TData, TKey>;
+declare function useFragment<TFragmentType: FragmentType, TData>(
+  fragment: Fragment<TFragmentType, TData>,
+  key: ?HasSpread<TFragmentType>,
+): ?TData;
 
 // if the key is a non-nullable array of keys, return non-nullable array
-declare function useFragment<
-  TKey: $ReadOnlyArray<{
-    +$data?: mixed,
-    +$fragmentSpreads: FragmentType,
-    ...
-  }>,
->(
-  fragment: GraphQLTaggedNode,
-  key: TKey,
-): $Call<<TData>($ReadOnlyArray<{+$data?: TData, ...}>) => TData, TKey>;
+declare function useFragment<TFragmentType: FragmentType, TData>(
+  fragment: Fragment<TFragmentType, TData>,
+  key: $ReadOnlyArray<HasSpread<TFragmentType>>,
+): TData;
 
 // if the key is a nullable array of keys, return nullable array
-declare function useFragment<
-  TKey: ?$ReadOnlyArray<{
-    +$data?: mixed,
-    +$fragmentSpreads: FragmentType,
-    ...
-  }>,
->(
-  fragment: GraphQLTaggedNode,
-  key: TKey,
-): $Call<<TData>(?$ReadOnlyArray<{+$data?: TData, ...}>) => ?TData, TKey>;
+declare function useFragment<TFragmentType: FragmentType, TData>(
+  fragment: Fragment<TFragmentType, TData>,
+  key: ?$ReadOnlyArray<HasSpread<TFragmentType>>,
+): ?TData;
 
 function useFragment(fragment: GraphQLTaggedNode, key: mixed): mixed {
   // We need to use this hook in order to be able to track if

package/relay-hooks/useFragmentNode.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useIsMountedRef.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useIsOperationNodeActive.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useIsParentQueryActive.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useLazyLoadQuery.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.
@@ -16,10 +16,9 @@
 import type {
   CacheConfig,
   FetchPolicy,
-  GraphQLTaggedNode,
-  OperationType,
+  Query,
   RenderPolicy,
-  VariablesOf,
+  Variables,
 } from 'relay-runtime';
 
 const {useTrackLoadQueryInRender} = require('./loadQuery');
@@ -30,16 +29,16 @@ const {
   __internal: {fetchQuery},
 } = require('relay-runtime');
 
-function useLazyLoadQuery<TQuery: OperationType>(
-  gqlQuery: GraphQLTaggedNode,
-  variables: VariablesOf<TQuery>,
+function useLazyLoadQuery<TVariables: Variables, TData>(
+  gqlQuery: Query<TVariables, TData>,
+  variables: TVariables,
   options?: {|
     fetchKey?: string | number,
     fetchPolicy?: FetchPolicy,
     networkCacheConfig?: CacheConfig,
     UNSTABLE_renderPolicy?: RenderPolicy,
   |},
-): TQuery['response'] {
+): TData {
   // We need to use this hook in order to be able to track if
   // loadQuery was called during render
   useTrackLoadQueryInRender();

package/relay-hooks/useLazyLoadQueryNode.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useLoadMoreFunction.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useMemoOperationDescriptor.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useMemoVariables.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useMutation.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/usePaginationFragment.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/usePreloadedQuery.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useQueryLoader.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useRefetchableFragment.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useRefetchableFragmentNode.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useRelayEnvironment.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useStaticFragmentNodeWarning.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/relay-hooks/useSubscribeToInvalidationState.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.
@@ -13,7 +13,7 @@
 
 'use strict';
 
-import type {DataID, Disposable, InvalidationState} from 'relay-runtime';
+import type {DataID, Disposable} from 'relay-runtime';
 
 const useRelayEnvironment = require('./useRelayEnvironment');
 const {useEffect, useRef} = require('react');

package/relay-hooks/useSubscription.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.