relay-runtime 0.0.0-main-1e923be9 → 0.0.0-main-764af24d

package/store/RelayModernSelector.js.flow

@@ -402,14 +402,7 @@ function getVariablesFromPluralFragment(
   return variables;
 }
 
-/**
- * @public
- *
- * Determine if two selectors are equal (represent the same selection). Note
- * that this function returns `false` when the two queries/fragments are
- * different objects, even if they select the same fields.
- */
-function areEqualSelectors(
+function areEqualSingularSelectors(
   thisSelector: SingularReaderSelector,
   thatSelector: SingularReaderSelector,
 ): boolean {
@@ -421,6 +414,37 @@ function areEqualSelectors(
   );
 }
 
+/**
+ * @public
+ *
+ * Determine if two selectors are equal (represent the same selection). Note
+ * that this function returns `false` when the two queries/fragments are
+ * different objects, even if they select the same fields.
+ */
+function areEqualSelectors(
+  a: ?(SingularReaderSelector | PluralReaderSelector),
+  b: ?(SingularReaderSelector | PluralReaderSelector),
+): boolean {
+  if (
+    a?.kind === 'SingularReaderSelector' &&
+    b?.kind === 'SingularReaderSelector'
+  ) {
+    return areEqualSingularSelectors(a, b);
+  } else if (
+    a?.kind === 'PluralReaderSelector' &&
+    b?.kind === 'PluralReaderSelector'
+  ) {
+    return (
+      a.selectors.length === b.selectors.length &&
+      a.selectors.every((s, i) => areEqualSingularSelectors(s, b.selectors[i]))
+    );
+  } else if (a == null && b == null) {
+    return true;
+  } else {
+    return false;
+  }
+}
+
 function createReaderSelector(
   fragment: ReaderFragment,
   dataID: DataID,

package/store/RelayStoreTypes.js.flow

@@ -44,8 +44,9 @@ import type {
   CacheConfig,
   DataID,
   Disposable,
-  OperationType,
   RenderPolicy,
+  UpdatableQuery,
+  UpdatableQueryType,
   Variables,
 } from '../util/RelayRuntimeTypes';
 import type {InvalidationState} from './RelayModernStore';
@@ -466,8 +467,8 @@ export interface RecordSourceProxy {
   get(dataID: DataID): ?RecordProxy;
   getRoot(): RecordProxy;
   invalidateStore(): void;
-  readUpdatableQuery_EXPERIMENTAL<TQuery: OperationType>(
-    query: GraphQLTaggedNode,
+  readUpdatableQuery_EXPERIMENTAL<TQuery: UpdatableQueryType>(
+    query: UpdatableQuery<TQuery['variables'], TQuery['response']>,
     variables: TQuery['variables'],
   ): TQuery['response'];
 }

package/util/RelayConcreteNode.js.flow

@@ -31,6 +31,11 @@ export type ConcreteRequest = {|
   +params: RequestParameters,
 |};
 
+export type ConcreteUpdatableQuery = {|
+  +kind: 'UpdatableQuery',
+  +fragment: ReaderFragment,
+|};
+
 export type NormalizationRootNode =
   | ConcreteRequest
   | NormalizationSplitOperation;
@@ -68,7 +73,8 @@ export type GeneratedNode =
   | ConcreteRequest
   | ReaderFragment
   | ReaderInlineDataFragment
-  | NormalizationSplitOperation;
+  | NormalizationSplitOperation
+  | ConcreteUpdatableQuery;
 
 const RelayConcreteNode = {
   ACTOR_CHANGE: 'ActorChange',
@@ -101,6 +107,7 @@ const RelayConcreteNode = {
   SPLIT_OPERATION: 'SplitOperation',
   STREAM: 'Stream',
   TYPE_DISCRIMINATOR: 'TypeDiscriminator',
+  UPDATABLE_QUERY: 'UpdatableQuery',
   VARIABLE: 'Variable',
 };
 

package/util/RelayRuntimeTypes.js.flow

@@ -17,7 +17,10 @@
  */
 
 import type {ReaderFragment, ReaderInlineDataFragment} from './ReaderNode';
-import type {ConcreteRequest} from './RelayConcreteNode';
+import type {
+  ConcreteRequest,
+  ConcreteUpdatableQuery,
+} from './RelayConcreteNode';
 
 /**
  * Represents any resource that must be explicitly disposed of. The most common
@@ -41,6 +44,14 @@ export type OperationType = {|
   +rawResponse?: {...},
 |};
 
+/**
+ * Generated updatable query flow types are subtypes of this.
+ */
+export type UpdatableQueryType = {|
+  +variables: Variables,
+  +response: mixed,
+|};
+
 export type VariablesOf<T: OperationType> = T['variables'];
 
 /**
@@ -84,6 +95,14 @@ declare export opaque type Operation<
   TRawResponse,
 >: ConcreteRequest;
 
+/**
+ * Return type of graphql tag literals for updatable queries.
+ */
+declare export opaque type UpdatableQuery<
+  -TVariables: Variables,
+  +TData,
+>: ConcreteUpdatableQuery;
+
 /**
  * Return type of graphql tag literals for queries.
  */