relay-runtime 11.0.2 → 13.0.0-rc.2

package/util/getAllRootVariables.js.flow

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ * @emails oncall+relay
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+import type {RequestParameters} from './RelayConcreteNode';
+import type {Variables} from './RelayRuntimeTypes';
+
+function getAllRootVariables(
+  userSuppliedVariables: Variables,
+  parameters: RequestParameters,
+): Variables {
+  const providedVariables = parameters.providedVariables;
+  if (providedVariables != null) {
+    const allVariables = {};
+    Object.assign(allVariables, userSuppliedVariables);
+    Object.keys(providedVariables).forEach((varName: string) => {
+      allVariables[varName] = providedVariables[varName].get();
+    });
+    return allVariables;
+  } else {
+    return userSuppliedVariables;
+  }
+}
+
+module.exports = getAllRootVariables;

package/util/getFragmentIdentifier.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,18 +13,17 @@
 
 'use strict';
 
-const RelayFeatureFlags = require('./RelayFeatureFlags');
-
-const isEmptyObject = require('./isEmptyObject');
-const stableCopy = require('./stableCopy');
+import type {ReaderFragment} from './ReaderNode';
 
 const {
   getDataIDsFromFragment,
-  getVariablesFromFragment,
   getSelector,
+  getVariablesFromFragment,
 } = require('../store/RelayModernSelector');
-
-import type {ReaderFragment} from './ReaderNode';
+const isEmptyObject = require('./isEmptyObject');
+const RelayFeatureFlags = require('./RelayFeatureFlags');
+const stableCopy = require('./stableCopy');
+const {intern} = require('./StringInterner');
 
 function getFragmentIdentifier(
   fragmentNode: ReaderFragment,
@@ -43,6 +42,19 @@ function getFragmentIdentifier(
   const dataIDs = getDataIDsFromFragment(fragmentNode, fragmentRef);
 
   if (RelayFeatureFlags.ENABLE_GETFRAGMENTIDENTIFIER_OPTIMIZATION) {
+    let ids =
+      typeof dataIDs === 'undefined'
+        ? 'missing'
+        : dataIDs == null
+        ? 'null'
+        : Array.isArray(dataIDs)
+        ? '[' + dataIDs.join(',') + ']'
+        : dataIDs;
+    ids =
+      RelayFeatureFlags.STRING_INTERN_LEVEL <= 1
+        ? ids
+        : intern(ids, RelayFeatureFlags.MAX_DATA_ID_LENGTH);
+
     return (
       fragmentOwnerIdentifier +
       '/' +
@@ -52,15 +64,15 @@ function getFragmentIdentifier(
         ? '{}'
         : JSON.stringify(stableCopy(fragmentVariables))) +
       '/' +
-      (typeof dataIDs === 'undefined'
-        ? 'missing'
-        : dataIDs == null
-        ? 'null'
-        : Array.isArray(dataIDs)
-        ? '[' + dataIDs.join(',') + ']'
-        : dataIDs)
+      ids
     );
   } else {
+    let ids = JSON.stringify(dataIDs) ?? 'missing';
+    ids =
+      RelayFeatureFlags.STRING_INTERN_LEVEL <= 1
+        ? ids
+        : intern(ids, RelayFeatureFlags.MAX_DATA_ID_LENGTH);
+
     return (
       fragmentOwnerIdentifier +
       '/' +
@@ -68,7 +80,7 @@ function getFragmentIdentifier(
       '/' +
       JSON.stringify(stableCopy(fragmentVariables)) +
       '/' +
-      (JSON.stringify(dataIDs) ?? 'missing')
+      ids
     );
   }
 }

package/util/getOperation.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,14 +13,14 @@
 
 'use strict';
 
-const {REQUEST, SPLIT_OPERATION} = require('./RelayConcreteNode');
-
 import type {
   NormalizationOperation,
   NormalizationRootNode,
   NormalizationSplitOperation,
 } from './NormalizationNode';
 
+const {REQUEST, SPLIT_OPERATION} = require('./RelayConcreteNode');
+
 /**
  * OperationLoaders can return either a NormalizationSplitOperation or
  * ConcreteRequest.

package/util/getPaginationMetadata.js.flow

@@ -0,0 +1,69 @@
+/**
+ * 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
+ * @flow strict-local
+ * @format
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+import type {ReaderFragment, ReaderPaginationMetadata} from './ReaderNode';
+import type {ConcreteRequest} from './RelayConcreteNode';
+
+const getRefetchMetadata = require('./getRefetchMetadata');
+const invariant = require('invariant');
+
+function getPaginationMetadata(
+  fragmentNode: ReaderFragment,
+  componentDisplayName: string,
+): {|
+  connectionPathInFragmentData: $ReadOnlyArray<string | number>,
+  identifierField: ?string,
+  paginationRequest: ConcreteRequest,
+  paginationMetadata: ReaderPaginationMetadata,
+  stream: boolean,
+|} {
+  const {refetchableRequest: paginationRequest, refetchMetadata} =
+    getRefetchMetadata(fragmentNode, componentDisplayName);
+
+  const paginationMetadata = refetchMetadata.connection;
+  invariant(
+    paginationMetadata != null,
+    'Relay: getPaginationMetadata(): Expected fragment `%s` to include a ' +
+      'connection when using `%s`. Did you forget to add a @connection ' +
+      'directive to the connection field in the fragment?',
+    componentDisplayName,
+    fragmentNode.name,
+  );
+  const connectionPathInFragmentData = paginationMetadata.path;
+
+  const connectionMetadata = (fragmentNode.metadata?.connection ?? [])[0];
+  invariant(
+    connectionMetadata != null,
+    'Relay: getPaginationMetadata(): Expected fragment `%s` to include a ' +
+      'connection when using `%s`. Did you forget to add a @connection ' +
+      'directive to the connection field in the fragment?',
+    componentDisplayName,
+    fragmentNode.name,
+  );
+  const identifierField = refetchMetadata.identifierField;
+  invariant(
+    identifierField == null || typeof identifierField === 'string',
+    'Relay: getRefetchMetadata(): Expected `identifierField` to be a string.',
+  );
+  return {
+    connectionPathInFragmentData,
+    identifierField,
+    paginationRequest,
+    paginationMetadata,
+    stream: connectionMetadata.stream === true,
+  };
+}
+
+module.exports = getPaginationMetadata;

package/util/getPaginationVariables.js.flow

@@ -0,0 +1,108 @@
+/**
+ * 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
+ * @flow strict-local
+ * @format
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+import type {ReaderPaginationMetadata} from './ReaderNode';
+import type {Variables} from './RelayRuntimeTypes';
+
+const invariant = require('invariant');
+const warning = require('warning');
+
+export type Direction = 'forward' | 'backward';
+
+function getPaginationVariables(
+  direction: Direction,
+  count: number,
+  cursor: ?string,
+  baseVariables: Variables,
+  extraVariables: Variables,
+  paginationMetadata: ReaderPaginationMetadata,
+): {[string]: mixed, ...} {
+  const {backward: backwardMetadata, forward: forwardMetadata} =
+    paginationMetadata;
+
+  if (direction === 'backward') {
+    invariant(
+      backwardMetadata != null &&
+        backwardMetadata.count != null &&
+        backwardMetadata.cursor != null,
+      'Relay: Expected backward pagination metadata to be available. ' +
+        "If you're seeing this, this is likely a bug in Relay.",
+    );
+    warning(
+      !extraVariables.hasOwnProperty(backwardMetadata.cursor),
+      'Relay: `UNSTABLE_extraVariables` provided by caller should not ' +
+        'contain cursor variable `%s`. This variable is automatically ' +
+        'determined by Relay.',
+      backwardMetadata.cursor,
+    );
+    warning(
+      !extraVariables.hasOwnProperty(backwardMetadata.count),
+      'Relay: `UNSTABLE_extraVariables` provided by caller should not ' +
+        'contain count variable `%s`. This variable is automatically ' +
+        'determined by Relay.',
+      backwardMetadata.count,
+    );
+    const paginationVariables = {
+      ...baseVariables,
+      ...extraVariables,
+      [backwardMetadata.cursor]: cursor,
+      [backwardMetadata.count]: count,
+    };
+    if (forwardMetadata && forwardMetadata.cursor) {
+      paginationVariables[forwardMetadata.cursor] = null;
+    }
+    if (forwardMetadata && forwardMetadata.count) {
+      paginationVariables[forwardMetadata.count] = null;
+    }
+    return paginationVariables;
+  }
+
+  invariant(
+    forwardMetadata != null &&
+      forwardMetadata.count != null &&
+      forwardMetadata.cursor != null,
+    'Relay: Expected forward pagination metadata to be available. ' +
+      "If you're seeing this, this is likely a bug in Relay.",
+  );
+  warning(
+    !extraVariables.hasOwnProperty(forwardMetadata.cursor),
+    'Relay: `UNSTABLE_extraVariables` provided by caller should not ' +
+      'contain cursor variable `%s`. This variable is automatically ' +
+      'determined by Relay.',
+    forwardMetadata.cursor,
+  );
+  warning(
+    !extraVariables.hasOwnProperty(forwardMetadata.count),
+    'Relay: `UNSTABLE_extraVariables` provided by caller should not ' +
+      'contain count variable `%s`. This variable is automatically ' +
+      'determined by Relay.',
+    forwardMetadata.count,
+  );
+  const paginationVariables = {
+    ...baseVariables,
+    ...extraVariables,
+    [forwardMetadata.cursor]: cursor,
+    [forwardMetadata.count]: count,
+  };
+  if (backwardMetadata && backwardMetadata.cursor) {
+    paginationVariables[backwardMetadata.cursor] = null;
+  }
+  if (backwardMetadata && backwardMetadata.count) {
+    paginationVariables[backwardMetadata.count] = null;
+  }
+  return paginationVariables;
+}
+
+module.exports = getPaginationVariables;

package/util/getPendingOperationsForFragment.js.flow

@@ -0,0 +1,62 @@
+/**
+ * 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
+ * @flow strict-local
+ * @format
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+import type {IEnvironment, RequestDescriptor} from '../store/RelayStoreTypes';
+import type {ReaderFragment} from './ReaderNode';
+
+const {getPromiseForActiveRequest} = require('../query/fetchQueryInternal');
+
+function getPendingOperationsForFragment(
+  environment: IEnvironment,
+  fragmentNode: ReaderFragment,
+  fragmentOwner: RequestDescriptor,
+): {|
+  promise: Promise<void>,
+  pendingOperations: $ReadOnlyArray<RequestDescriptor>,
+|} | null {
+  let pendingOperations: $ReadOnlyArray<RequestDescriptor> = [];
+  let promise = getPromiseForActiveRequest(environment, fragmentOwner);
+
+  if (promise != null) {
+    pendingOperations = [fragmentOwner];
+  } else {
+    const result = environment
+      .getOperationTracker()
+      .getPendingOperationsAffectingOwner(fragmentOwner);
+
+    pendingOperations = result?.pendingOperations ?? [];
+    promise = result?.promise ?? null;
+  }
+
+  if (!promise) {
+    return null;
+  }
+
+  let pendingOperationName =
+    pendingOperations?.map(op => op.node.params.name).join(',') ?? null;
+  if (pendingOperationName == null || pendingOperationName.length === 0) {
+    pendingOperationName = 'Unknown pending operation';
+  }
+  const fragmentName = fragmentNode.name;
+  const promiseDisplayName =
+    pendingOperationName === fragmentName
+      ? `Relay(${pendingOperationName})`
+      : `Relay(${pendingOperationName}:${fragmentName})`;
+  // $FlowExpectedError[prop-missing] Expando to annotate Promises.
+  promise.displayName = promiseDisplayName;
+  return {promise, pendingOperations};
+}
+
+module.exports = getPendingOperationsForFragment;

package/util/getRefetchMetadata.js.flow

@@ -0,0 +1,76 @@
+/**
+ * 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
+ * @flow strict-local
+ * @format
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+import type {ReaderFragment, ReaderRefetchMetadata} from './ReaderNode';
+import type {ConcreteRequest} from './RelayConcreteNode';
+
+const invariant = require('invariant');
+
+function getRefetchMetadata(
+  fragmentNode: ReaderFragment,
+  componentDisplayName: string,
+): {|
+  fragmentRefPathInResponse: $ReadOnlyArray<string | number>,
+  identifierField: ?string,
+  refetchableRequest: ConcreteRequest,
+  refetchMetadata: ReaderRefetchMetadata,
+|} {
+  invariant(
+    fragmentNode.metadata?.plural !== true,
+    'Relay: getRefetchMetadata(): Expected fragment `%s` not to be plural when using ' +
+      '`%s`. Remove `@relay(plural: true)` from fragment `%s` ' +
+      'in order to use it with `%s`.',
+    fragmentNode.name,
+    componentDisplayName,
+    fragmentNode.name,
+    componentDisplayName,
+  );
+
+  const refetchMetadata = fragmentNode.metadata?.refetch;
+  invariant(
+    refetchMetadata != null,
+    'Relay: getRefetchMetadata(): Expected fragment `%s` to be refetchable when using `%s`. ' +
+      'Did you forget to add a @refetchable directive to the fragment?',
+    componentDisplayName,
+    fragmentNode.name,
+  );
+
+  // handle both commonjs and es modules
+  const refetchableRequest: ConcreteRequest | string =
+    (refetchMetadata: $FlowFixMe).operation.default
+      ? (refetchMetadata: $FlowFixMe).operation.default
+      : refetchMetadata.operation;
+  const fragmentRefPathInResponse = refetchMetadata.fragmentPathInResult;
+  invariant(
+    typeof refetchableRequest !== 'string',
+    'Relay: getRefetchMetadata(): Expected refetch query to be an ' +
+      "operation and not a string when using `%s`. If you're seeing this, " +
+      'this is likely a bug in Relay.',
+    componentDisplayName,
+  );
+  const identifierField = refetchMetadata.identifierField;
+  invariant(
+    identifierField == null || typeof identifierField === 'string',
+    'Relay: getRefetchMetadata(): Expected `identifierField` to be a string.',
+  );
+  return {
+    fragmentRefPathInResponse,
+    identifierField,
+    refetchableRequest,
+    refetchMetadata,
+  };
+}
+
+module.exports = getRefetchMetadata;

package/util/getRelayHandleKey.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,9 +12,8 @@
 
 'use strict';
 
-const invariant = require('invariant');
-
 const {DEFAULT_HANDLE_KEY} = require('./RelayDefaultHandleKey');
+const invariant = require('invariant');
 
 /**
  * @internal

package/util/getRequestIdentifier.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,12 +12,12 @@
 
 'use strict';
 
-const invariant = require('invariant');
-const stableCopy = require('./stableCopy');
-
 import type {RequestParameters} from './RelayConcreteNode';
 import type {Variables} from './RelayRuntimeTypes';
 
+const stableCopy = require('./stableCopy');
+const invariant = require('invariant');
+
 export type RequestIdentifier = string;
 
 /**

package/util/getValueAtPath.js.flow

@@ -0,0 +1,46 @@
+/**
+ * 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
+ * @flow strict-local
+ * @format
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+const invariant = require('invariant');
+
+function getValueAtPath(
+  data: mixed,
+  path: $ReadOnlyArray<string | number>,
+): mixed {
+  let result = data;
+  for (const key of path) {
+    if (result == null) {
+      return null;
+    }
+    if (typeof key === 'number') {
+      invariant(
+        Array.isArray(result),
+        'Relay: Expected an array when extracting value at path. ' +
+          "If you're seeing this, this is likely a bug in Relay.",
+      );
+      result = result[key];
+    } else {
+      invariant(
+        typeof result === 'object' && !Array.isArray(result),
+        'Relay: Expected an object when extracting value at path. ' +
+          "If you're seeing this, this is likely a bug in Relay.",
+      );
+      result = result[key];
+    }
+  }
+  return result;
+}
+
+module.exports = getValueAtPath;

package/util/isEmptyObject.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.
@@ -11,6 +11,7 @@
 
 'use strict';
 
+// $FlowFixMe[method-unbinding] added when improving typing for this parameters
 const hasOwnProperty = Object.prototype.hasOwnProperty;
 
 function isEmptyObject(obj: interface {+[key: string]: mixed}): boolean {

package/util/isPromise.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/util/isScalarAndEqual.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/util/recycleNodesInto.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/util/registerEnvironmentWithDevTools.js.flow

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ * @emails oncall+relay
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+import type {IEnvironment} from '../store/RelayStoreTypes';
+
+function registerEnvironmentWithDevTools(environment: IEnvironment): void {
+  // Register this Relay Environment with Relay DevTools if it exists.
+  // Note: this must always be the last step in the constructor.
+  const _global =
+    typeof global !== 'undefined'
+      ? global
+      : typeof window !== 'undefined'
+      ? window
+      : undefined;
+  const devToolsHook = _global && _global.__RELAY_DEVTOOLS_HOOK__;
+  if (devToolsHook) {
+    devToolsHook.registerEnvironment(environment);
+  }
+}
+
+module.exports = registerEnvironmentWithDevTools;

package/util/reportMissingRequiredFields.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/util/resolveImmediate.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.
@@ -21,7 +21,7 @@ function resolveImmediate(callback: () => void) {
   resolvedPromise.then(callback).catch(throwNext);
 }
 
-function throwNext(error) {
+function throwNext(error: $FlowFixMe) {
   setTimeout(() => {
     throw error;
   }, 0);

package/util/stableCopy.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/util/withDuration.js.flow

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ *
+ * @flow
+ * @format
+ */
+
+// flowlint ambiguous-object-type:error
+
+'use strict';
+
+const isPerformanceNowAvailable =
+  typeof window !== 'undefined' &&
+  typeof window?.performance?.now === 'function';
+
+function currentTimestamp(): number {
+  if (isPerformanceNowAvailable) {
+    return window.performance.now();
+  }
+  return Date.now();
+}
+
+function withDuration<T>(cb: () => T): [number, T] {
+  const startTime = currentTimestamp();
+  const result = cb();
+  return [currentTimestamp() - startTime, result];
+}
+
+module.exports = withDuration;