relay-runtime 0.0.0-main-e0f88a3b → 0.0.0-main-2087b512

package/store/RelayRecordSource.js.flow

@@ -12,8 +12,6 @@
 
 'use strict';
 
-const RelayRecordState = require('./RelayRecordState');
-
 import type {DataID} from '../util/RelayRuntimeTypes';
 import type {RecordState} from './RelayRecordState';
 import type {
@@ -22,6 +20,8 @@ import type {
   RecordObjectMap,
 } from './RelayStoreTypes';
 
+const RelayRecordState = require('./RelayRecordState');
+
 const {EXISTENT, NONEXISTENT, UNKNOWN} = RelayRecordState;
 
 /**

package/store/RelayReferenceMarker.js.flow

@@ -12,19 +12,6 @@
 
 'use strict';
 
-const RelayConcreteNode = require('../util/RelayConcreteNode');
-const RelayFeatureFlags = require('../util/RelayFeatureFlags');
-const RelayModernRecord = require('./RelayModernRecord');
-const RelayStoreReactFlightUtils = require('./RelayStoreReactFlightUtils');
-const RelayStoreUtils = require('./RelayStoreUtils');
-
-const cloneRelayHandleSourceField = require('./cloneRelayHandleSourceField');
-const getOperation = require('../util/getOperation');
-const invariant = require('invariant');
-
-const {getLocalVariables} = require('./RelayConcreteVariables');
-const {generateTypeID} = require('./TypeID');
-
 import type {
   NormalizationFlightField,
   NormalizationLinkedField,
@@ -37,11 +24,22 @@ import type {
   DataIDSet,
   NormalizationSelector,
   OperationLoader,
+  ReactFlightReachableExecutableDefinitions,
   Record,
   RecordSource,
-  ReactFlightReachableExecutableDefinitions,
 } from './RelayStoreTypes';
 
+const getOperation = require('../util/getOperation');
+const RelayConcreteNode = require('../util/RelayConcreteNode');
+const RelayFeatureFlags = require('../util/RelayFeatureFlags');
+const cloneRelayHandleSourceField = require('./cloneRelayHandleSourceField');
+const {getLocalVariables} = require('./RelayConcreteVariables');
+const RelayModernRecord = require('./RelayModernRecord');
+const RelayStoreReactFlightUtils = require('./RelayStoreReactFlightUtils');
+const RelayStoreUtils = require('./RelayStoreUtils');
+const {generateTypeID} = require('./TypeID');
+const invariant = require('invariant');
+
 const {
   ACTOR_CHANGE,
   CONDITION,

package/store/RelayResponseNormalizer.js.flow

@@ -12,12 +12,31 @@
 
 'use strict';
 
-const RelayFeatureFlags = require('../util/RelayFeatureFlags');
-const RelayModernRecord = require('./RelayModernRecord');
-
-const areEqual = require('areEqual');
-const invariant = require('invariant');
-const warning = require('warning');
+import type {ActorIdentifier} from '../multi-actor-environment/ActorIdentifier';
+import type {PayloadData} from '../network/RelayNetworkTypes';
+import type {
+  NormalizationActorChange,
+  NormalizationDefer,
+  NormalizationFlightField,
+  NormalizationLinkedField,
+  NormalizationModuleImport,
+  NormalizationNode,
+  NormalizationScalarField,
+  NormalizationStream,
+} from '../util/NormalizationNode';
+import type {DataID, Variables} from '../util/RelayRuntimeTypes';
+import type {
+  FollowupPayload,
+  HandleFieldPayload,
+  IncrementalDataPlaceholder,
+  MutableRecordSource,
+  NormalizationSelector,
+  ReactFlightPayloadDeserializer,
+  ReactFlightReachableExecutableDefinitions,
+  ReactFlightServerErrorHandler,
+  Record,
+  RelayResponsePayload,
+} from './RelayStoreTypes';
 
 const {
   ACTOR_IDENTIFIER_FIELD_NAME,
@@ -25,9 +44,9 @@ const {
 } = require('../multi-actor-environment/ActorUtils');
 const {
   ACTOR_CHANGE,
-  CONDITION,
   CLIENT_COMPONENT,
   CLIENT_EXTENSION,
+  CONDITION,
   DEFER,
   FLIGHT_FIELD,
   FRAGMENT_SPREAD,
@@ -40,52 +59,31 @@ const {
   STREAM,
   TYPE_DISCRIMINATOR,
 } = require('../util/RelayConcreteNode');
+const RelayFeatureFlags = require('../util/RelayFeatureFlags');
 const {generateClientID, isClientID} = require('./ClientID');
 const {getLocalVariables} = require('./RelayConcreteVariables');
+const RelayModernRecord = require('./RelayModernRecord');
 const {createNormalizationSelector} = require('./RelayModernSelector');
 const {
-  refineToReactFlightPayloadData,
   REACT_FLIGHT_EXECUTABLE_DEFINITIONS_STORAGE_KEY,
   REACT_FLIGHT_TREE_STORAGE_KEY,
   REACT_FLIGHT_TYPE_NAME,
+  refineToReactFlightPayloadData,
 } = require('./RelayStoreReactFlightUtils');
 const {
+  ROOT_ID,
+  ROOT_TYPE,
+  TYPENAME_KEY,
   getArgumentValues,
   getHandleStorageKey,
   getModuleComponentKey,
   getModuleOperationKey,
   getStorageKey,
-  TYPENAME_KEY,
-  ROOT_ID,
-  ROOT_TYPE,
 } = require('./RelayStoreUtils');
-const {generateTypeID, TYPE_SCHEMA_TYPE} = require('./TypeID');
-
-import type {ActorIdentifier} from '../multi-actor-environment/ActorIdentifier';
-import type {PayloadData} from '../network/RelayNetworkTypes';
-import type {
-  NormalizationActorChange,
-  NormalizationDefer,
-  NormalizationFlightField,
-  NormalizationLinkedField,
-  NormalizationModuleImport,
-  NormalizationNode,
-  NormalizationScalarField,
-  NormalizationStream,
-} from '../util/NormalizationNode';
-import type {DataID, Variables} from '../util/RelayRuntimeTypes';
-import type {
-  FollowupPayload,
-  HandleFieldPayload,
-  IncrementalDataPlaceholder,
-  MutableRecordSource,
-  NormalizationSelector,
-  ReactFlightPayloadDeserializer,
-  ReactFlightReachableExecutableDefinitions,
-  ReactFlightServerErrorHandler,
-  Record,
-  RelayResponsePayload,
-} from './RelayStoreTypes';
+const {TYPE_SCHEMA_TYPE, generateTypeID} = require('./TypeID');
+const areEqual = require('areEqual');
+const invariant = require('invariant');
+const warning = require('warning');
 
 export type GetDataID = (
   fieldValue: interface {[string]: mixed},

package/store/RelayStoreReactFlightUtils.js.flow

@@ -12,13 +12,12 @@
 
 'use strict';
 
-const invariant = require('invariant');
-
-const {getType} = require('./RelayModernRecord');
-
 import type {ReactFlightPayloadData} from '../network/RelayNetworkTypes';
 import type {ReactFlightClientResponse, Record} from './RelayStoreTypes';
 
+const {getType} = require('./RelayModernRecord');
+const invariant = require('invariant');
+
 // Reachable (client) executable definitions encountered while server component
 // rendering
 const REACT_FLIGHT_EXECUTABLE_DEFINITIONS_STORAGE_KEY = 'executableDefinitions';

package/store/RelayStoreSubscriptions.js.flow

@@ -12,18 +12,11 @@
 
 'use strict';
 
-const RelayFeatureFlags = require('../util/RelayFeatureFlags');
-const RelayReader = require('./RelayReader');
-
-const deepFreeze = require('../util/deepFreeze');
-const hasOverlappingIDs = require('./hasOverlappingIDs');
-const recycleNodesInto = require('../util/recycleNodesInto');
-
 import type {Disposable} from '../util/RelayRuntimeTypes';
 import type {
+  DataIDSet,
   LogFunction,
   OperationDescriptor,
-  DataIDSet,
   RecordSource,
   RequestDescriptor,
   Snapshot,
@@ -31,6 +24,12 @@ import type {
 } from './RelayStoreTypes';
 import type {ResolverCache} from './ResolverCache';
 
+const deepFreeze = require('../util/deepFreeze');
+const recycleNodesInto = require('../util/recycleNodesInto');
+const RelayFeatureFlags = require('../util/RelayFeatureFlags');
+const hasOverlappingIDs = require('./hasOverlappingIDs');
+const RelayReader = require('./RelayReader');
+
 type Subscription = {|
   callback: (snapshot: Snapshot) => void,
   snapshot: Snapshot,

package/store/RelayStoreTypes.js.flow

@@ -21,17 +21,18 @@ import type {
   INetwork,
   PayloadData,
   PayloadError,
-  ReactFlightServerTree,
   ReactFlightServerError,
+  ReactFlightServerTree,
   UploadableMap,
 } from '../network/RelayNetworkTypes';
 import type RelayObservable from '../network/RelayObservable';
+import type {RequestIdentifier} from '../util/getRequestIdentifier';
 import type {
+  NormalizationArgument,
   NormalizationLinkedField,
   NormalizationRootNode,
   NormalizationScalarField,
   NormalizationSelectableNode,
-  NormalizationArgument,
 } from '../util/NormalizationNode';
 import type {ReaderFragment} from '../util/ReaderNode';
 import type {
@@ -45,7 +46,6 @@ import type {
   RenderPolicy,
   Variables,
 } from '../util/RelayRuntimeTypes';
-import type {RequestIdentifier} from '../util/getRequestIdentifier';
 import type {InvalidationState} from './RelayModernStore';
 import type RelayOperationTracker from './RelayOperationTracker';
 import type {RecordState} from './RelayRecordState';
@@ -53,6 +53,12 @@ import type {RecordState} from './RelayRecordState';
 export opaque type FragmentReference = empty;
 export type OperationTracker = RelayOperationTracker;
 
+export type MutationParameters = {|
+  +response: {...},
+  +variables: interface {},
+  +rawResponse?: {...},
+|};
+
 /*
  * An individual cached graph object.
  */

package/store/RelayStoreUtils.js.flow

@@ -12,24 +12,23 @@
 
 'use strict';
 
-const RelayConcreteNode = require('../util/RelayConcreteNode');
-
-const getRelayHandleKey = require('../util/getRelayHandleKey');
-const invariant = require('invariant');
-const stableCopy = require('../util/stableCopy');
-
 import type {
-  NormalizationHandle,
   NormalizationArgument,
   NormalizationField,
+  NormalizationHandle,
 } from '../util/NormalizationNode';
 import type {
+  ReaderActorChange,
   ReaderArgument,
   ReaderField,
-  ReaderActorChange,
 } from '../util/ReaderNode';
 import type {Variables} from '../util/RelayRuntimeTypes';
 
+const getRelayHandleKey = require('../util/getRelayHandleKey');
+const RelayConcreteNode = require('../util/RelayConcreteNode');
+const stableCopy = require('../util/stableCopy');
+const invariant = require('invariant');
+
 export type Arguments = interface {+[string]: mixed};
 
 const {VARIABLE, LITERAL, OBJECT_VALUE, LIST_VALUE} = RelayConcreteNode;

package/store/ResolverCache.js.flow

@@ -12,27 +12,25 @@
 
 'use strict';
 
-const RelayModernRecord = require('./RelayModernRecord');
+import type {ReaderRelayResolver} from '../util/ReaderNode';
+import type {DataID, Variables} from '../util/RelayRuntimeTypes';
+import type {
+  MutableRecordSource,
+  Record,
+  SingularReaderSelector,
+} from './RelayStoreTypes';
 
 const recycleNodesInto = require('../util/recycleNodesInto');
-const warning = require('warning');
-
 const {generateClientID} = require('./ClientID');
+const RelayModernRecord = require('./RelayModernRecord');
 const {
-  RELAY_RESOLVER_VALUE_KEY,
-  RELAY_RESOLVER_INVALIDATION_KEY,
   RELAY_RESOLVER_INPUTS_KEY,
+  RELAY_RESOLVER_INVALIDATION_KEY,
   RELAY_RESOLVER_READER_SELECTOR_KEY,
+  RELAY_RESOLVER_VALUE_KEY,
   getStorageKey,
 } = require('./RelayStoreUtils');
-
-import type {ReaderRelayResolver} from '../util/ReaderNode';
-import type {DataID, Variables} from '../util/RelayRuntimeTypes';
-import type {
-  MutableRecordSource,
-  Record,
-  SingularReaderSelector,
-} from './RelayStoreTypes';
+const warning = require('warning');
 
 type ResolverID = string;
 

package/store/ResolverFragments.js.flow

@@ -12,17 +12,16 @@
 
 'use strict';
 
-const invariant = require('invariant');
-
-const {getFragment} = require('../query/GraphQLTag');
-const {getSelector} = require('./RelayModernSelector');
-
 import type {GraphQLTaggedNode} from '../query/GraphQLTag';
 import type {
   FragmentReference,
   SingularReaderSelector,
 } from './RelayStoreTypes';
 
+const {getFragment} = require('../query/GraphQLTag');
+const {getSelector} = require('./RelayModernSelector');
+const invariant = require('invariant');
+
 // When we call the user-supplied resolver function, it will in turn call
 // `readFragment`, but that's a global function -- it needs information
 // about what resolver is being executed, which is supplied by putting the

package/store/ViewerPattern.js.flow

@@ -12,11 +12,11 @@
 
 'use strict';
 
+import type {DataID} from 'relay-runtime/util/RelayRuntimeTypes';
+
 const {generateClientID} = require('./ClientID');
 const {ROOT_ID} = require('./RelayStoreUtils');
 
-import type {DataID} from 'relay-runtime/util/RelayRuntimeTypes';
-
 const VIEWER_ID: DataID = generateClientID(ROOT_ID, 'viewer');
 const VIEWER_TYPE = 'Viewer';
 

package/store/cloneRelayHandleSourceField.js.flow

@@ -12,12 +12,6 @@
 
 'use strict';
 
-const areEqual = require('areEqual');
-const invariant = require('invariant');
-
-const {LINKED_FIELD} = require('../util/RelayConcreteNode');
-const {getHandleStorageKey} = require('./RelayStoreUtils');
-
 import type {
   NormalizationLinkedField,
   NormalizationSelection,
@@ -25,6 +19,11 @@ import type {
 import type {NormalizationLinkedHandle} from '../util/NormalizationNode';
 import type {Variables} from '../util/RelayRuntimeTypes';
 
+const {LINKED_FIELD} = require('../util/RelayConcreteNode');
+const {getHandleStorageKey} = require('./RelayStoreUtils');
+const areEqual = require('areEqual');
+const invariant = require('invariant');
+
 /**
  * @private
  *

package/store/cloneRelayScalarHandleSourceField.js.flow

@@ -12,12 +12,6 @@
 
 'use strict';
 
-const areEqual = require('areEqual');
-const invariant = require('invariant');
-
-const {SCALAR_FIELD} = require('../util/RelayConcreteNode');
-const {getHandleStorageKey} = require('./RelayStoreUtils');
-
 import type {
   NormalizationScalarField,
   NormalizationSelection,
@@ -25,6 +19,11 @@ import type {
 import type {NormalizationScalarHandle} from '../util/NormalizationNode';
 import type {Variables} from '../util/RelayRuntimeTypes';
 
+const {SCALAR_FIELD} = require('../util/RelayConcreteNode');
+const {getHandleStorageKey} = require('./RelayStoreUtils');
+const areEqual = require('areEqual');
+const invariant = require('invariant');
+
 /**
  * @private
  *

package/store/createFragmentSpecResolver.js.flow

@@ -12,10 +12,6 @@
 
 'use strict';
 
-const RelayModernFragmentSpecResolver = require('./RelayModernFragmentSpecResolver');
-
-const warning = require('warning');
-
 import type {
   FragmentMap,
   FragmentSpecResolver,
@@ -23,6 +19,9 @@ import type {
   RelayContext,
 } from './RelayStoreTypes';
 
+const RelayModernFragmentSpecResolver = require('./RelayModernFragmentSpecResolver');
+const warning = require('warning');
+
 function createFragmentSpecResolver(
   context: RelayContext,
   containerName: string,

package/store/createRelayContext.js.flow

@@ -12,11 +12,11 @@
 
 'use strict';
 
-const invariant = require('invariant');
-
 import type {RelayContext} from './RelayStoreTypes.js';
 import typeof {createContext} from 'react';
 
+const invariant = require('invariant');
+
 // Ideally, we'd just import the type of the react module, but this causes Flow
 // problems.
 type React = {

package/store/normalizeRelayPayload.js.flow

@@ -12,19 +12,18 @@
 
 'use strict';
 
-const RelayModernRecord = require('./RelayModernRecord');
-const RelayRecordSource = require('./RelayRecordSource');
-const RelayResponseNormalizer = require('./RelayResponseNormalizer');
-
-const {ROOT_TYPE} = require('./RelayStoreUtils');
-
 import type {PayloadData, PayloadError} from '../network/RelayNetworkTypes';
 import type {NormalizationOptions} from './RelayResponseNormalizer';
 import type {
-  RelayResponsePayload,
   NormalizationSelector,
+  RelayResponsePayload,
 } from './RelayStoreTypes';
 
+const RelayModernRecord = require('./RelayModernRecord');
+const RelayRecordSource = require('./RelayRecordSource');
+const RelayResponseNormalizer = require('./RelayResponseNormalizer');
+const {ROOT_TYPE} = require('./RelayStoreUtils');
+
 function normalizeRelayPayload(
   selector: NormalizationSelector,
   payload: PayloadData,

package/store/readInlineData.js.flow

@@ -12,13 +12,12 @@
 
 'use strict';
 
-const invariant = require('invariant');
+import type {GraphQLTaggedNode} from '../query/GraphQLTag';
+import type {FragmentReference} from './RelayStoreTypes';
 
 const {getInlineDataFragment} = require('../query/GraphQLTag');
 const {FRAGMENTS_KEY} = require('./RelayStoreUtils');
-
-import type {GraphQLTaggedNode} from '../query/GraphQLTag';
-import type {FragmentReference} from './RelayStoreTypes';
+const invariant = require('invariant');
 
 /**
  * Reads an @inline data fragment that was spread into the parent fragment.

package/subscription/requestSubscription.js.flow

@@ -12,17 +12,6 @@
 
 'use strict';
 
-const RelayDeclarativeMutationConfig = require('../mutations/RelayDeclarativeMutationConfig');
-const RelayFeatureFlags = require('../util/RelayFeatureFlags');
-
-const warning = require('warning');
-
-const {getRequest} = require('../query/GraphQLTag');
-const {
-  createOperationDescriptor,
-} = require('../store/RelayModernOperationDescriptor');
-const {createReaderSelector} = require('../store/RelayModernSelector');
-
 import type {DeclarativeMutationConfig} from '../mutations/RelayDeclarativeMutationConfig';
 import type {GraphQLTaggedNode} from '../query/GraphQLTag';
 import type {
@@ -35,6 +24,15 @@ import type {
   Variables,
 } from '../util/RelayRuntimeTypes';
 
+const RelayDeclarativeMutationConfig = require('../mutations/RelayDeclarativeMutationConfig');
+const {getRequest} = require('../query/GraphQLTag');
+const {
+  createOperationDescriptor,
+} = require('../store/RelayModernOperationDescriptor');
+const {createReaderSelector} = require('../store/RelayModernSelector');
+const RelayFeatureFlags = require('../util/RelayFeatureFlags');
+const warning = require('warning');
+
 export type SubscriptionParameters = {|
   +response: {...},
   +variables: interface {},

package/util/RelayFeatureFlags.js.flow

@@ -15,6 +15,7 @@
 import type {Disposable} from '../util/RelayRuntimeTypes';
 
 type FeatureFlags = {|
+  DELAY_CLEANUP_OF_PENDING_PRELOAD_QUERIES: boolean,
   ENABLE_VARIABLE_CONNECTION_KEY: boolean,
   ENABLE_PARTIAL_RENDERING_DEFAULT: boolean,
   ENABLE_REACT_FLIGHT_COMPONENT_FIELD: boolean,
@@ -33,6 +34,7 @@ type FeatureFlags = {|
 |};
 
 const RelayFeatureFlags: FeatureFlags = {
+  DELAY_CLEANUP_OF_PENDING_PRELOAD_QUERIES: false,
   ENABLE_VARIABLE_CONNECTION_KEY: false,
   ENABLE_PARTIAL_RENDERING_DEFAULT: true,
   ENABLE_REACT_FLIGHT_COMPONENT_FIELD: false,

package/util/RelayReplaySubject.js.flow

@@ -12,12 +12,11 @@
 
 'use strict';
 
-const RelayObservable = require('../network/RelayObservable');
+import type {Observer, Sink, Subscription} from '../network/RelayObservable';
 
+const RelayObservable = require('../network/RelayObservable');
 const invariant = require('invariant');
 
-import type {Observer, Sink, Subscription} from '../network/RelayObservable';
-
 type Event<T> =
   | {
       kind: 'next',

package/util/StringInterner.js.flow

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ *
+ * @flow strict
+ * @format
+ */
+
+'use strict';
+
+const internTable = new Map();
+let nextIndex = 1;
+const digits = new Set('0123456789');
+
+// Character used as the prefix for interned strings. The specific character is
+// chosen to reduce the likelihood that non-interned input strings need to be
+// escaped (choosing eg a-Z would increase the likelihood we need to escape)
+const INTERN_PREFIX = '\t';
+// Character used as the prefix of escaped strings. As above, this is also
+// chosen to be unlikely in normal input strings.
+const ESCAPE_PREFIX = '\v';
+
+// Escape a string so that it cannot conflict with an interned string
+function escape(str: string): string {
+  if (
+    // "\t<digit>..." -> "\v\t<digit>..."
+    (str[0] === INTERN_PREFIX && digits.has(str[1])) ||
+    // "\v..." -> "\v\v..."
+    str[0] === ESCAPE_PREFIX
+  ) {
+    return ESCAPE_PREFIX + str;
+  }
+  return str;
+}
+
+// Interns the input string if its length equals or exceeds the given `limit`,
+// returning a shorter replacement string that is uniquely associated with the
+// input: multiple calls to intern() for the equivalent input strings (and limit)
+// will always return the exact same string.
+// Strings shorter than the limit are not interned but are escaped if they
+// could conflict with interned strings.
+function intern(str: string, limit: ?number): string {
+  if (limit == null || str.length < limit) {
+    return escape(str);
+  }
+  let internedString = internTable.get(str);
+  if (internedString != null) {
+    return internedString;
+  }
+  internedString = INTERN_PREFIX + nextIndex++;
+  internTable.set(str, internedString);
+  return internedString;
+}
+
+module.exports = {intern};

package/util/createPayloadFor3DField.js.flow

@@ -13,14 +13,14 @@
 
 'use strict';
 
+import type {JSResourceReference} from 'JSResourceReference';
+import type {NormalizationSplitOperation} from './NormalizationNode';
+
 const {
   getModuleComponentKey,
   getModuleOperationKey,
 } = require('../store/RelayStoreUtils');
 
-import type {NormalizationSplitOperation} from './NormalizationNode';
-import type {JSResourceReference} from 'JSResourceReference';
-
 export opaque type Local3DPayload<
   +DocumentName: string,
   +Response: {...},