relay-runtime 20.1.1 → 21.0.1

package/index.js.flow

@@ -9,8 +9,14 @@
  * @oncall relay
  */
 
+/**
+ * LLM/AI Agent: Relay documentation is available in node_modules/relay-runtime/llm-docs/
+ */
+
 'use strict';
 
+/* eslint relay-internal/esm-compatible-cjs: error */
+
 const {isErrorResult, isValueResult} = require('./experimental');
 const ConnectionHandler = require('./handlers/connection/ConnectionHandler');
 const ConnectionInterface = require('./handlers/connection/ConnectionInterface');
@@ -36,11 +42,13 @@ const {
 const createFragmentSpecResolver = require('./store/createFragmentSpecResolver');
 const createRelayContext = require('./store/createRelayContext');
 const createRelayLoggingContext = require('./store/createRelayLoggingContext');
+const defaultGetDataID = require('./store/defaultGetDataID');
 const isRelayModernEnvironment = require('./store/isRelayModernEnvironment');
 const {
   isSuspenseSentinel,
   suspenseSentinel,
 } = require('./store/live-resolvers/LiveResolverSuspenseSentinel');
+const NormalizationEngine = require('./store/NormalizationEngine');
 const normalizeResponse = require('./store/normalizeResponse');
 const readInlineData = require('./store/readInlineData');
 const RelayConcreteVariables = require('./store/RelayConcreteVariables');
@@ -262,6 +270,79 @@ if (__DEV__) {
   }
 }
 
+const {
+  areEqualSelectors,
+  createNormalizationSelector,
+  createReaderSelector,
+  getDataIDsFromFragment,
+  getDataIDsFromObject,
+  getPluralSelector,
+  getSelector,
+  getSelectorsFromObject,
+  getSingularSelector,
+  getVariablesFromFragment,
+  getVariablesFromObject,
+  getVariablesFromPluralFragment,
+  getVariablesFromSingularFragment,
+} = RelayModernSelector;
+
+const {createOperationDescriptor, createRequestDescriptor} =
+  RelayModernOperationDescriptor;
+
+const {
+  getArgumentValues,
+  getModuleComponentKey,
+  getModuleOperationKey,
+  getStorageKey,
+  FRAGMENTS_KEY,
+  FRAGMENT_OWNER_KEY,
+  ID_KEY,
+  REF_KEY,
+  REFS_KEY,
+  ROOT_ID,
+  ROOT_TYPE,
+  TYPENAME_KEY,
+} = RelayStoreUtils;
+
+const {
+  getNode,
+  getFragment,
+  getInlineDataFragment,
+  getPaginationFragment,
+  getRefetchableFragment,
+  getRequest,
+  graphql,
+  isFragment,
+  isInlineDataFragment,
+  isRequest,
+} = GraphQLTag;
+
+const {readFragment} = ResolverFragments;
+
+const {DEFAULT_HANDLE_KEY} = RelayDefaultHandleKey;
+
+const {MutationTypes, RangeOperations} = RelayDeclarativeMutationConfig;
+
+const {VIEWER_ID, VIEWER_TYPE} = ViewerPattern;
+
+const __internal = {
+  ResolverFragments,
+  OperationTracker: RelayOperationTracker,
+  createRelayContext: createRelayContext,
+  createRelayLoggingContext: createRelayLoggingContext,
+  defaultGetDataID: defaultGetDataID,
+  getOperationVariables: RelayConcreteVariables.getOperationVariables,
+  getLocalVariables: RelayConcreteVariables.getLocalVariables,
+  fetchQuery: fetchQueryInternal.fetchQuery,
+  fetchQueryDeduped: fetchQueryInternal.fetchQueryDeduped,
+  getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
+  getObservableForActiveRequest:
+    fetchQueryInternal.getObservableForActiveRequest,
+  NormalizationEngine: NormalizationEngine,
+  normalizeResponse: normalizeResponse,
+  withProvidedVariables: withProvidedVariables,
+};
+
 /**
  * The public interface to Relay Runtime.
  */
@@ -276,59 +357,55 @@ module.exports = {
   ReplaySubject: RelayReplaySubject,
   Store: RelayModernStore,
 
-  areEqualSelectors: RelayModernSelector.areEqualSelectors,
+  areEqualSelectors,
   createFragmentSpecResolver: createFragmentSpecResolver,
-  createNormalizationSelector: RelayModernSelector.createNormalizationSelector,
-  createOperationDescriptor:
-    RelayModernOperationDescriptor.createOperationDescriptor,
-  createReaderSelector: RelayModernSelector.createReaderSelector,
-  createRequestDescriptor:
-    RelayModernOperationDescriptor.createRequestDescriptor,
-  getArgumentValues: RelayStoreUtils.getArgumentValues,
-  getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
-  getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
-  getNode: GraphQLTag.getNode,
-  getFragment: GraphQLTag.getFragment,
-  getInlineDataFragment: GraphQLTag.getInlineDataFragment,
-  getModuleComponentKey: RelayStoreUtils.getModuleComponentKey,
-  getModuleOperationKey: RelayStoreUtils.getModuleOperationKey,
-  getPaginationFragment: GraphQLTag.getPaginationFragment,
-  getPluralSelector: RelayModernSelector.getPluralSelector,
-  getRefetchableFragment: GraphQLTag.getRefetchableFragment,
-  getRequest: GraphQLTag.getRequest,
+  createNormalizationSelector,
+  createOperationDescriptor,
+  createReaderSelector,
+  createRequestDescriptor,
+  getArgumentValues,
+  getDataIDsFromFragment,
+  getDataIDsFromObject,
+  getNode,
+  getFragment,
+  getInlineDataFragment,
+  getModuleComponentKey,
+  getModuleOperationKey,
+  getPaginationFragment,
+  getPluralSelector,
+  getRefetchableFragment,
+  getRequest,
   getRequestIdentifier: getRequestIdentifier,
-  getSelector: RelayModernSelector.getSelector,
-  getSelectorsFromObject: RelayModernSelector.getSelectorsFromObject,
-  getSingularSelector: RelayModernSelector.getSingularSelector,
-  getStorageKey: RelayStoreUtils.getStorageKey,
-  getVariablesFromFragment: RelayModernSelector.getVariablesFromFragment,
-  getVariablesFromObject: RelayModernSelector.getVariablesFromObject,
-  getVariablesFromPluralFragment:
-    RelayModernSelector.getVariablesFromPluralFragment,
-  getVariablesFromSingularFragment:
-    RelayModernSelector.getVariablesFromSingularFragment,
+  getSelector,
+  getSelectorsFromObject,
+  getSingularSelector,
+  getStorageKey,
+  getVariablesFromFragment,
+  getVariablesFromObject,
+  getVariablesFromPluralFragment,
+  getVariablesFromSingularFragment,
   handlePotentialSnapshotErrors,
-  graphql: GraphQLTag.graphql,
+  graphql,
   isErrorResult: isErrorResult,
   isValueResult: isValueResult,
-  isFragment: GraphQLTag.isFragment,
-  isInlineDataFragment: GraphQLTag.isInlineDataFragment,
+  isFragment,
+  isInlineDataFragment,
   isSuspenseSentinel,
   suspenseSentinel,
-  isRequest: GraphQLTag.isRequest,
+  isRequest,
   readInlineData,
-  readFragment: ResolverFragments.readFragment,
+  readFragment,
 
   // Declarative mutation API
-  MutationTypes: RelayDeclarativeMutationConfig.MutationTypes,
-  RangeOperations: RelayDeclarativeMutationConfig.RangeOperations,
+  MutationTypes,
+  RangeOperations,
 
   // Extensions
   DefaultHandlerProvider: RelayDefaultHandlerProvider,
   ConnectionHandler,
   MutationHandlers,
-  VIEWER_ID: ViewerPattern.VIEWER_ID,
-  VIEWER_TYPE: ViewerPattern.VIEWER_TYPE,
+  VIEWER_ID,
+  VIEWER_TYPE,
 
   // Helpers (can be implemented via the above API)
   applyOptimisticMutation,
@@ -351,15 +428,15 @@ module.exports = {
   RelayConcreteNode: RelayConcreteNode,
   RelayError: RelayError,
   RelayFeatureFlags: RelayFeatureFlags,
-  DEFAULT_HANDLE_KEY: RelayDefaultHandleKey.DEFAULT_HANDLE_KEY,
-  FRAGMENTS_KEY: RelayStoreUtils.FRAGMENTS_KEY,
-  FRAGMENT_OWNER_KEY: RelayStoreUtils.FRAGMENT_OWNER_KEY,
-  ID_KEY: RelayStoreUtils.ID_KEY,
-  REF_KEY: RelayStoreUtils.REF_KEY,
-  REFS_KEY: RelayStoreUtils.REFS_KEY,
-  ROOT_ID: RelayStoreUtils.ROOT_ID,
-  ROOT_TYPE: RelayStoreUtils.ROOT_TYPE,
-  TYPENAME_KEY: RelayStoreUtils.TYPENAME_KEY,
+  DEFAULT_HANDLE_KEY,
+  FRAGMENTS_KEY,
+  FRAGMENT_OWNER_KEY,
+  ID_KEY,
+  REF_KEY,
+  REFS_KEY,
+  ROOT_ID,
+  ROOT_TYPE,
+  TYPENAME_KEY,
 
   deepFreeze: deepFreeze,
   generateClientID: generateClientID,
@@ -377,19 +454,5 @@ module.exports = {
   getPaginationVariables: getPaginationVariables,
   getPendingOperationsForFragment: getPendingOperationsForFragment,
   getValueAtPath: getValueAtPath,
-  __internal: {
-    ResolverFragments,
-    OperationTracker: RelayOperationTracker,
-    createRelayContext: createRelayContext,
-    createRelayLoggingContext: createRelayLoggingContext,
-    getOperationVariables: RelayConcreteVariables.getOperationVariables,
-    getLocalVariables: RelayConcreteVariables.getLocalVariables,
-    fetchQuery: fetchQueryInternal.fetchQuery,
-    fetchQueryDeduped: fetchQueryInternal.fetchQueryDeduped,
-    getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
-    getObservableForActiveRequest:
-      fetchQueryInternal.getObservableForActiveRequest,
-    normalizeResponse: normalizeResponse,
-    withProvidedVariables: withProvidedVariables,
-  },
+  __internal,
 };

package/lib/experimental.js

@@ -14,10 +14,10 @@ function isErrorResult(input) {
   return input.ok === false;
 }
 module.exports = {
-  resolverDataInjector: resolverDataInjector,
-  isValueResult: isValueResult,
   isErrorResult: isErrorResult,
-  observeQuery: observeQuery,
+  isValueResult: isValueResult,
   observeFragment: observeFragment,
+  observeQuery: observeQuery,
+  resolverDataInjector: resolverDataInjector,
   waitForFragmentData: waitForFragmentData
 };

package/lib/index.js

@@ -26,10 +26,12 @@ var _require2 = require('./store/ClientID'),
 var createFragmentSpecResolver = require('./store/createFragmentSpecResolver');
 var createRelayContext = require('./store/createRelayContext');
 var createRelayLoggingContext = require('./store/createRelayLoggingContext');
+var defaultGetDataID = require('./store/defaultGetDataID');
 var isRelayModernEnvironment = require('./store/isRelayModernEnvironment');
 var _require3 = require('./store/live-resolvers/LiveResolverSuspenseSentinel'),
   isSuspenseSentinel = _require3.isSuspenseSentinel,
   suspenseSentinel = _require3.suspenseSentinel;
+var NormalizationEngine = require('./store/NormalizationEngine');
 var normalizeResponse = require('./store/normalizeResponse');
 var readInlineData = require('./store/readInlineData');
 var RelayConcreteVariables = require('./store/RelayConcreteVariables');
@@ -78,6 +80,65 @@ if (process.env.NODE_ENV !== "production") {
     throw new Error("relay-runtime requires ".concat([mapStr, setStr, promiseStr, objStr].filter(Boolean).join(', and '), " to exist. ") + 'Use a polyfill to provide these for older browsers.');
   }
 }
+var areEqualSelectors = RelayModernSelector.areEqualSelectors,
+  createNormalizationSelector = RelayModernSelector.createNormalizationSelector,
+  createReaderSelector = RelayModernSelector.createReaderSelector,
+  getDataIDsFromFragment = RelayModernSelector.getDataIDsFromFragment,
+  getDataIDsFromObject = RelayModernSelector.getDataIDsFromObject,
+  getPluralSelector = RelayModernSelector.getPluralSelector,
+  getSelector = RelayModernSelector.getSelector,
+  getSelectorsFromObject = RelayModernSelector.getSelectorsFromObject,
+  getSingularSelector = RelayModernSelector.getSingularSelector,
+  getVariablesFromFragment = RelayModernSelector.getVariablesFromFragment,
+  getVariablesFromObject = RelayModernSelector.getVariablesFromObject,
+  getVariablesFromPluralFragment = RelayModernSelector.getVariablesFromPluralFragment,
+  getVariablesFromSingularFragment = RelayModernSelector.getVariablesFromSingularFragment;
+var createOperationDescriptor = RelayModernOperationDescriptor.createOperationDescriptor,
+  createRequestDescriptor = RelayModernOperationDescriptor.createRequestDescriptor;
+var getArgumentValues = RelayStoreUtils.getArgumentValues,
+  getModuleComponentKey = RelayStoreUtils.getModuleComponentKey,
+  getModuleOperationKey = RelayStoreUtils.getModuleOperationKey,
+  getStorageKey = RelayStoreUtils.getStorageKey,
+  FRAGMENTS_KEY = RelayStoreUtils.FRAGMENTS_KEY,
+  FRAGMENT_OWNER_KEY = RelayStoreUtils.FRAGMENT_OWNER_KEY,
+  ID_KEY = RelayStoreUtils.ID_KEY,
+  REF_KEY = RelayStoreUtils.REF_KEY,
+  REFS_KEY = RelayStoreUtils.REFS_KEY,
+  ROOT_ID = RelayStoreUtils.ROOT_ID,
+  ROOT_TYPE = RelayStoreUtils.ROOT_TYPE,
+  TYPENAME_KEY = RelayStoreUtils.TYPENAME_KEY;
+var getNode = GraphQLTag.getNode,
+  getFragment = GraphQLTag.getFragment,
+  getInlineDataFragment = GraphQLTag.getInlineDataFragment,
+  getPaginationFragment = GraphQLTag.getPaginationFragment,
+  getRefetchableFragment = GraphQLTag.getRefetchableFragment,
+  getRequest = GraphQLTag.getRequest,
+  graphql = GraphQLTag.graphql,
+  isFragment = GraphQLTag.isFragment,
+  isInlineDataFragment = GraphQLTag.isInlineDataFragment,
+  isRequest = GraphQLTag.isRequest;
+var readFragment = ResolverFragments.readFragment;
+var DEFAULT_HANDLE_KEY = RelayDefaultHandleKey.DEFAULT_HANDLE_KEY;
+var MutationTypes = RelayDeclarativeMutationConfig.MutationTypes,
+  RangeOperations = RelayDeclarativeMutationConfig.RangeOperations;
+var VIEWER_ID = ViewerPattern.VIEWER_ID,
+  VIEWER_TYPE = ViewerPattern.VIEWER_TYPE;
+var __internal = {
+  ResolverFragments: ResolverFragments,
+  OperationTracker: RelayOperationTracker,
+  createRelayContext: createRelayContext,
+  createRelayLoggingContext: createRelayLoggingContext,
+  defaultGetDataID: defaultGetDataID,
+  getOperationVariables: RelayConcreteVariables.getOperationVariables,
+  getLocalVariables: RelayConcreteVariables.getLocalVariables,
+  fetchQuery: fetchQueryInternal.fetchQuery,
+  fetchQueryDeduped: fetchQueryInternal.fetchQueryDeduped,
+  getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
+  getObservableForActiveRequest: fetchQueryInternal.getObservableForActiveRequest,
+  NormalizationEngine: NormalizationEngine,
+  normalizeResponse: normalizeResponse,
+  withProvidedVariables: withProvidedVariables
+};
 module.exports = {
   Environment: RelayModernEnvironment,
   Network: RelayNetwork,
@@ -87,51 +148,51 @@ module.exports = {
   Record: RelayModernRecord,
   ReplaySubject: RelayReplaySubject,
   Store: RelayModernStore,
-  areEqualSelectors: RelayModernSelector.areEqualSelectors,
+  areEqualSelectors: areEqualSelectors,
   createFragmentSpecResolver: createFragmentSpecResolver,
-  createNormalizationSelector: RelayModernSelector.createNormalizationSelector,
-  createOperationDescriptor: RelayModernOperationDescriptor.createOperationDescriptor,
-  createReaderSelector: RelayModernSelector.createReaderSelector,
-  createRequestDescriptor: RelayModernOperationDescriptor.createRequestDescriptor,
-  getArgumentValues: RelayStoreUtils.getArgumentValues,
-  getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
-  getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
-  getNode: GraphQLTag.getNode,
-  getFragment: GraphQLTag.getFragment,
-  getInlineDataFragment: GraphQLTag.getInlineDataFragment,
-  getModuleComponentKey: RelayStoreUtils.getModuleComponentKey,
-  getModuleOperationKey: RelayStoreUtils.getModuleOperationKey,
-  getPaginationFragment: GraphQLTag.getPaginationFragment,
-  getPluralSelector: RelayModernSelector.getPluralSelector,
-  getRefetchableFragment: GraphQLTag.getRefetchableFragment,
-  getRequest: GraphQLTag.getRequest,
+  createNormalizationSelector: createNormalizationSelector,
+  createOperationDescriptor: createOperationDescriptor,
+  createReaderSelector: createReaderSelector,
+  createRequestDescriptor: createRequestDescriptor,
+  getArgumentValues: getArgumentValues,
+  getDataIDsFromFragment: getDataIDsFromFragment,
+  getDataIDsFromObject: getDataIDsFromObject,
+  getNode: getNode,
+  getFragment: getFragment,
+  getInlineDataFragment: getInlineDataFragment,
+  getModuleComponentKey: getModuleComponentKey,
+  getModuleOperationKey: getModuleOperationKey,
+  getPaginationFragment: getPaginationFragment,
+  getPluralSelector: getPluralSelector,
+  getRefetchableFragment: getRefetchableFragment,
+  getRequest: getRequest,
   getRequestIdentifier: getRequestIdentifier,
-  getSelector: RelayModernSelector.getSelector,
-  getSelectorsFromObject: RelayModernSelector.getSelectorsFromObject,
-  getSingularSelector: RelayModernSelector.getSingularSelector,
-  getStorageKey: RelayStoreUtils.getStorageKey,
-  getVariablesFromFragment: RelayModernSelector.getVariablesFromFragment,
-  getVariablesFromObject: RelayModernSelector.getVariablesFromObject,
-  getVariablesFromPluralFragment: RelayModernSelector.getVariablesFromPluralFragment,
-  getVariablesFromSingularFragment: RelayModernSelector.getVariablesFromSingularFragment,
+  getSelector: getSelector,
+  getSelectorsFromObject: getSelectorsFromObject,
+  getSingularSelector: getSingularSelector,
+  getStorageKey: getStorageKey,
+  getVariablesFromFragment: getVariablesFromFragment,
+  getVariablesFromObject: getVariablesFromObject,
+  getVariablesFromPluralFragment: getVariablesFromPluralFragment,
+  getVariablesFromSingularFragment: getVariablesFromSingularFragment,
   handlePotentialSnapshotErrors: handlePotentialSnapshotErrors,
-  graphql: GraphQLTag.graphql,
+  graphql: graphql,
   isErrorResult: isErrorResult,
   isValueResult: isValueResult,
-  isFragment: GraphQLTag.isFragment,
-  isInlineDataFragment: GraphQLTag.isInlineDataFragment,
+  isFragment: isFragment,
+  isInlineDataFragment: isInlineDataFragment,
   isSuspenseSentinel: isSuspenseSentinel,
   suspenseSentinel: suspenseSentinel,
-  isRequest: GraphQLTag.isRequest,
+  isRequest: isRequest,
   readInlineData: readInlineData,
-  readFragment: ResolverFragments.readFragment,
-  MutationTypes: RelayDeclarativeMutationConfig.MutationTypes,
-  RangeOperations: RelayDeclarativeMutationConfig.RangeOperations,
+  readFragment: readFragment,
+  MutationTypes: MutationTypes,
+  RangeOperations: RangeOperations,
   DefaultHandlerProvider: RelayDefaultHandlerProvider,
   ConnectionHandler: ConnectionHandler,
   MutationHandlers: MutationHandlers,
-  VIEWER_ID: ViewerPattern.VIEWER_ID,
-  VIEWER_TYPE: ViewerPattern.VIEWER_TYPE,
+  VIEWER_ID: VIEWER_ID,
+  VIEWER_TYPE: VIEWER_TYPE,
   applyOptimisticMutation: applyOptimisticMutation,
   commitLocalUpdate: commitLocalUpdate,
   commitMutation: commitMutation,
@@ -146,15 +207,15 @@ module.exports = {
   RelayConcreteNode: RelayConcreteNode,
   RelayError: RelayError,
   RelayFeatureFlags: RelayFeatureFlags,
-  DEFAULT_HANDLE_KEY: RelayDefaultHandleKey.DEFAULT_HANDLE_KEY,
-  FRAGMENTS_KEY: RelayStoreUtils.FRAGMENTS_KEY,
-  FRAGMENT_OWNER_KEY: RelayStoreUtils.FRAGMENT_OWNER_KEY,
-  ID_KEY: RelayStoreUtils.ID_KEY,
-  REF_KEY: RelayStoreUtils.REF_KEY,
-  REFS_KEY: RelayStoreUtils.REFS_KEY,
-  ROOT_ID: RelayStoreUtils.ROOT_ID,
-  ROOT_TYPE: RelayStoreUtils.ROOT_TYPE,
-  TYPENAME_KEY: RelayStoreUtils.TYPENAME_KEY,
+  DEFAULT_HANDLE_KEY: DEFAULT_HANDLE_KEY,
+  FRAGMENTS_KEY: FRAGMENTS_KEY,
+  FRAGMENT_OWNER_KEY: FRAGMENT_OWNER_KEY,
+  ID_KEY: ID_KEY,
+  REF_KEY: REF_KEY,
+  REFS_KEY: REFS_KEY,
+  ROOT_ID: ROOT_ID,
+  ROOT_TYPE: ROOT_TYPE,
+  TYPENAME_KEY: TYPENAME_KEY,
   deepFreeze: deepFreeze,
   generateClientID: generateClientID,
   generateUniqueClientID: generateUniqueClientID,
@@ -171,18 +232,5 @@ module.exports = {
   getPaginationVariables: getPaginationVariables,
   getPendingOperationsForFragment: getPendingOperationsForFragment,
   getValueAtPath: getValueAtPath,
-  __internal: {
-    ResolverFragments: ResolverFragments,
-    OperationTracker: RelayOperationTracker,
-    createRelayContext: createRelayContext,
-    createRelayLoggingContext: createRelayLoggingContext,
-    getOperationVariables: RelayConcreteVariables.getOperationVariables,
-    getLocalVariables: RelayConcreteVariables.getLocalVariables,
-    fetchQuery: fetchQueryInternal.fetchQuery,
-    fetchQueryDeduped: fetchQueryInternal.fetchQueryDeduped,
-    getPromiseForActiveRequest: fetchQueryInternal.getPromiseForActiveRequest,
-    getObservableForActiveRequest: fetchQueryInternal.getObservableForActiveRequest,
-    normalizeResponse: normalizeResponse,
-    withProvidedVariables: withProvidedVariables
-  }
+  __internal: __internal
 };

package/lib/multi-actor-environment/ActorIdentifier.js

@@ -6,12 +6,12 @@ function assertInternalActorIdentifier(actorIdentifier) {
   !(actorIdentifier === INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE) ? process.env.NODE_ENV !== "production" ? invariant(false, 'Expected to use only internal version of the `actorIdentifier`. "%s" was provided.', actorIdentifier) : invariant(false) : void 0;
 }
 module.exports = {
+  INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE: INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE,
   assertInternalActorIdentifier: assertInternalActorIdentifier,
   getActorIdentifier: function getActorIdentifier(actorID) {
     return actorID;
   },
   getDefaultActorIdentifier: function getDefaultActorIdentifier() {
     throw new Error('Not Implemented');
-  },
-  INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE: INTERNAL_ACTOR_IDENTIFIER_DO_NOT_USE
+  }
 };

package/lib/multi-actor-environment/MultiActorEnvironment.js

@@ -14,7 +14,7 @@ var RelayRecordSource = require('../store/RelayRecordSource');
 var ActorSpecificEnvironment = require('./ActorSpecificEnvironment');
 var MultiActorEnvironment = /*#__PURE__*/function () {
   function MultiActorEnvironment(config) {
-    var _config$getDataID, _config$logFn, _config$relayFieldLog, _config$treatMissingF, _config$isServer, _config$missingFieldH, _config$defaultRender, _config$normalizeResp;
+    var _config$getDataID, _config$logFn, _config$relayFieldLog, _config$treatMissingF, _config$deferDeduplic, _config$isServer, _config$missingFieldH, _config$defaultRender, _config$normalizeResp;
     this._actorEnvironments = new Map();
     this._operationLoader = config.operationLoader;
     this._createNetworkForActor = config.createNetworkForActor;
@@ -26,6 +26,7 @@ var MultiActorEnvironment = /*#__PURE__*/function () {
     this._relayFieldLogger = (_config$relayFieldLog = config.relayFieldLogger) !== null && _config$relayFieldLog !== void 0 ? _config$relayFieldLog : defaultRelayFieldLogger;
     this._shouldProcessClientComponents = config.shouldProcessClientComponents;
     this._treatMissingFieldsAsNull = (_config$treatMissingF = config.treatMissingFieldsAsNull) !== null && _config$treatMissingF !== void 0 ? _config$treatMissingF : false;
+    this._deferDeduplicatedFields = (_config$deferDeduplic = config.deferDeduplicatedFields) !== null && _config$deferDeduplic !== void 0 ? _config$deferDeduplic : false;
     this._isServer = (_config$isServer = config.isServer) !== null && _config$isServer !== void 0 ? _config$isServer : false;
     this._missingFieldHandlers = (_config$missingFieldH = config.missingFieldHandlers) !== null && _config$missingFieldH !== void 0 ? _config$missingFieldH : [];
     this._createStoreForActor = config.createStoreForActor;
@@ -288,6 +289,7 @@ var MultiActorEnvironment = /*#__PURE__*/function () {
           return _this4.forActor(actorIdentifier).getStore();
         },
         treatMissingFieldsAsNull: _this4._treatMissingFieldsAsNull,
+        deferDeduplicatedFields: _this4._deferDeduplicatedFields,
         updater: updater,
         log: _this4._logFn,
         normalizeResponse: _this4._normalizeResponse

package/lib/mutations/commitMutation.js

@@ -54,6 +54,14 @@ function commitMutation(environment, config) {
     updater: updater,
     uploadables: uploadables
   }).subscribe({
+    complete: function complete() {
+      var onCompleted = config.onCompleted;
+      if (onCompleted) {
+        var snapshot = environment.lookup(operation.fragment);
+        onCompleted(snapshot.data, errors.length !== 0 ? errors : null);
+      }
+    },
+    error: onError,
     next: function next(payload) {
       var _config$onNext;
       if (Array.isArray(payload)) {
@@ -69,14 +77,6 @@ function commitMutation(environment, config) {
       }
       (_config$onNext = config.onNext) === null || _config$onNext === void 0 ? void 0 : _config$onNext.call(config);
     },
-    complete: function complete() {
-      var onCompleted = config.onCompleted;
-      if (onCompleted) {
-        var snapshot = environment.lookup(operation.fragment);
-        onCompleted(snapshot.data, errors.length !== 0 ? errors : null);
-      }
-    },
-    error: onError,
     unsubscribe: onUnsubscribe
   });
   return {

package/lib/mutations/validateMutation.js

@@ -21,12 +21,12 @@ if (process.env.NODE_ENV !== "production") {
   validateMutation = function validateMutation(optimisticResponse, mutation, variables) {
     var operationName = mutation.operation.name;
     var context = {
+      extraDiff: {},
+      missingDiff: {},
+      moduleImportPaths: new Set(),
       path: 'ROOT',
-      visitedPaths: new Set(),
       variables: variables || {},
-      missingDiff: {},
-      extraDiff: {},
-      moduleImportPaths: new Set()
+      visitedPaths: new Set()
     };
     validateSelections(optimisticResponse, mutation.operation.selections, context);
     validateOptimisticResponse(optimisticResponse, context);

package/lib/query/GraphQLTag.js

@@ -73,15 +73,15 @@ function getInlineDataFragment(taggedNode) {
 }
 module.exports = {
   getFragment: getFragment,
+  getInlineDataFragment: getInlineDataFragment,
   getNode: getNode,
   getPaginationFragment: getPaginationFragment,
   getRefetchableFragment: getRefetchableFragment,
   getRequest: getRequest,
   getUpdatableQuery: getUpdatableQuery,
-  getInlineDataFragment: getInlineDataFragment,
   graphql: graphql,
   isFragment: isFragment,
+  isInlineDataFragment: isInlineDataFragment,
   isRequest: isRequest,
-  isUpdatableQuery: isUpdatableQuery,
-  isInlineDataFragment: isInlineDataFragment
+  isUpdatableQuery: isUpdatableQuery
 };

package/lib/query/fetchQuery.js

@@ -31,10 +31,22 @@ function fetchQuery(environment, query, variables, options) {
       }
     case 'store-or-network':
       {
-        if (environment.check(operation).status === 'available') {
-          return RelayObservable.from(environment.lookup(operation.fragment)).map(readData);
+        var queryAvailability = environment.check(operation);
+        var shouldFetch = queryAvailability.status !== 'available';
+        var observable;
+        if (!shouldFetch) {
+          observable = RelayObservable.from(environment.lookup(operation.fragment)).map(readData);
+        } else {
+          observable = getNetworkObservable(environment, operation).map(readData);
         }
-        return getNetworkObservable(environment, operation).map(readData);
+        environment.__log({
+          name: 'fetchquery.fetch',
+          operation: operation,
+          fetchPolicy: fetchPolicy,
+          queryAvailability: queryAvailability,
+          shouldFetch: shouldFetch
+        });
+        return observable;
       }
     default:
       fetchPolicy;