relay-test-utils-internal 13.1.0 → 14.0.0

package/consoleError.js.flow

@@ -0,0 +1,70 @@
+/**
+ * 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
+ */
+
+'use strict';
+
+/* global jest */
+
+import type {WillFireOptions} from './consoleErrorsAndWarnings';
+
+const {createConsoleInterceptionSystem} = require('./consoleErrorsAndWarnings');
+
+const consoleErrorsSystem = createConsoleInterceptionSystem(
+  'error',
+  'expectConsoleError',
+  impl => {
+    jest.spyOn(console, 'error').mockImplementation(impl);
+  },
+);
+
+/**
+ * Mocks console.error so that errors printed to the console are instead thrown.
+ * Any expected errors need to be explicitly expected with `expectConsoleErrorWillFire(message)`.
+ *
+ * NOTE: This should be called on top of a test file. The test should NOT
+ *       use `jest.resetModules()` or manually mock `console`.
+ */
+function disallowConsoleErrors(): void {
+  consoleErrorsSystem.disallowMessages();
+}
+
+/**
+ * Expect an error with the given message. If the message isn't fired in the
+ * current test, the test will fail.
+ */
+function expectConsoleErrorWillFire(
+  message: string,
+  options?: WillFireOptions,
+): void {
+  consoleErrorsSystem.expectMessageWillFire(message, options);
+}
+
+/**
+ * Expect the callback `fn` to print an error with the message, and otherwise fail.
+ */
+function expectConsoleError<T>(message: string, fn: () => T): T {
+  return consoleErrorsSystem.expectMessage(message, fn);
+}
+
+/**
+ * Expect the callback `fn` to trigger all console errors (in sequence),
+ * and otherwise fail.
+ */
+function expectConsoleErrorsMany<T>(messages: Array<string>, fn: () => T): T {
+  return consoleErrorsSystem.expectMessageMany(messages, fn);
+}
+
+module.exports = {
+  disallowConsoleErrors,
+  expectConsoleErrorWillFire,
+  expectConsoleError,
+  expectConsoleErrorsMany,
+};

package/consoleErrorsAndWarnings.js.flow

@@ -0,0 +1,134 @@
+/**
+ * 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
+ */
+
+'use strict';
+
+/* global afterEach */
+
+export type WillFireOptions = {
+  count?: number,
+  optional?: boolean,
+};
+
+type API = $ReadOnly<{|
+  disallowMessages: () => void,
+  expectMessageWillFire: (string, void | WillFireOptions) => void,
+  expectMessage: <T>(string, () => T) => T,
+  expectMessageMany: <T>(Array<string>, () => T) => T,
+|}>;
+
+const originalConsoleError = console.error;
+
+function createConsoleInterceptionSystem(
+  typename: string,
+  expectFunctionName: string,
+  setUpMock: ((string) => void) => void,
+): API {
+  let installed = false;
+  const expectedMessages: Array<string> = [];
+  const optionalMessages: Array<string> = [];
+  const contextualExpectedMessage: Array<string> = [];
+
+  const typenameCap = typename.charAt(0).toUpperCase() + typename.slice(1);
+  const typenameCapPlural = typenameCap + 's';
+  const installerName = `disallow${typenameCap}s`;
+
+  function handleMessage(message: string): void {
+    const index = expectedMessages.findIndex(expected =>
+      message.startsWith(expected),
+    );
+    const optionalIndex = optionalMessages.findIndex(expected =>
+      message.startsWith(expected),
+    );
+    if (
+      contextualExpectedMessage.length > 0 &&
+      message.startsWith(contextualExpectedMessage[0])
+    ) {
+      contextualExpectedMessage.shift();
+    } else if (index >= 0) {
+      expectedMessages.splice(index, 1);
+    } else if (optionalIndex >= 0) {
+      optionalMessages.splice(optionalIndex, 1);
+    } else {
+      // log to console in case the error gets swallowed somewhere
+      originalConsoleError(`Unexpected ${typenameCap}: ` + message);
+      throw new Error(`${typenameCap}: ` + message);
+    }
+  }
+
+  function disallowMessages(): void {
+    if (installed) {
+      throw new Error(`${installerName} should be called only once.`);
+    }
+    installed = true;
+    setUpMock(handleMessage);
+
+    afterEach(() => {
+      optionalMessages.length = 0;
+      contextualExpectedMessage.length = 0;
+      if (expectedMessages.length > 0) {
+        const error = new Error(
+          `Some ${expectedMessages.length} expected ${typename}s where not triggered:\n\n` +
+            Array.from(expectedMessages, message => ` * ${message}`).join(
+              '\n',
+            ) +
+            '\n',
+        );
+        expectedMessages.length = 0;
+        throw error;
+      }
+    });
+  }
+
+  function expectMessageWillFire(
+    message: string,
+    options?: WillFireOptions,
+  ): void {
+    if (!installed) {
+      throw new Error(
+        `${installerName} needs to be called before expect${typenameCapPlural}WillFire`,
+      );
+    }
+    const optional = options?.optional === true; // avoid "sketchy null check"
+    for (let i = 0; i < (options?.count ?? 1); i++) {
+      (optional ? optionalMessages : expectedMessages).push(message);
+    }
+  }
+
+  function expectMessage<T>(message: string, fn: () => T): T {
+    return expectMessageMany([message], fn);
+  }
+
+  function expectMessageMany<T>(messages: Array<string>, fn: () => T): T {
+    if (contextualExpectedMessage.length > 0) {
+      throw new Error(`Cannot nest ${expectFunctionName}() calls.`);
+    }
+    contextualExpectedMessage.push(...messages);
+    const result = fn();
+    if (contextualExpectedMessage.length > 0) {
+      const notFired = contextualExpectedMessage.toString();
+      contextualExpectedMessage.length = 0;
+      throw new Error(`Expected ${typename} in callback: ${notFired}`);
+    }
+    return result;
+  }
+
+  return {
+    disallowMessages,
+    expectMessageWillFire,
+    expectMessage,
+    expectMessageMany,
+  };
+}
+
+module.exports = {
+  createConsoleInterceptionSystem,
+};

package/consoleWarning.js.flow

@@ -0,0 +1,70 @@
+/**
+ * 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
+ */
+
+'use strict';
+
+/* global jest */
+
+import type {WillFireOptions} from './consoleErrorsAndWarnings';
+
+const {createConsoleInterceptionSystem} = require('./consoleErrorsAndWarnings');
+
+const consoleWarningsSystem = createConsoleInterceptionSystem(
+  'warning',
+  'expectConsoleWarning',
+  impl => {
+    jest.spyOn(console, 'warn').mockImplementation(impl);
+  },
+);
+
+/**
+ * Mocks console.warn so that warnings printed to the console are instead thrown.
+ * Any expected warnings need to be explicitly expected with `expectConsoleWarningWillFire(message)`.
+ *
+ * NOTE: This should be called on top of a test file. The test should NOT
+ *       use `jest.resetModules()` or manually mock `console`.
+ */
+function disallowConsoleWarnings(): void {
+  consoleWarningsSystem.disallowMessages();
+}
+
+/**
+ * Expect a warning with the given message. If the message isn't fired in the
+ * current test, the test will fail.
+ */
+function expectConsoleWarningWillFire(
+  message: string,
+  options?: WillFireOptions,
+): void {
+  consoleWarningsSystem.expectMessageWillFire(message, options);
+}
+
+/**
+ * Expect the callback `fn` to print a warning with the message, and otherwise fail.
+ */
+function expectConsoleWarning<T>(message: string, fn: () => T): T {
+  return consoleWarningsSystem.expectMessage(message, fn);
+}
+
+/**
+ * Expect the callback `fn` to trigger all console warnings (in sequence),
+ * and otherwise fail.
+ */
+function expectConsoleWarningsMany<T>(messages: Array<string>, fn: () => T): T {
+  return consoleWarningsSystem.expectMessageMany(messages, fn);
+}
+
+module.exports = {
+  disallowConsoleWarnings,
+  expectConsoleWarningWillFire,
+  expectConsoleWarning,
+  expectConsoleWarningsMany,
+};

package/index.js

@@ -1,5 +1,5 @@
 /**
- * Relay v13.1.0
+ * Relay v14.0.0
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/index.js.flow

@@ -12,6 +12,18 @@
 
 'use strict';
 
+const {
+  disallowConsoleErrors,
+  expectConsoleError,
+  expectConsoleErrorsMany,
+  expectConsoleErrorWillFire,
+} = require('./consoleError');
+const {
+  disallowConsoleWarnings,
+  expectConsoleWarning,
+  expectConsoleWarningsMany,
+  expectConsoleWarningWillFire,
+} = require('./consoleWarning');
 const describeWithFeatureFlags = require('./describeWithFeatureFlags');
 const {
   FIXTURE_TAG,
@@ -20,6 +32,7 @@ const {
 const Matchers = require('./Matchers');
 const printAST = require('./printAST');
 const simpleClone = require('./simpleClone');
+const trackRetentionForEnvironment = require('./trackRetentionForEnvironment');
 const {
   disallowWarnings,
   expectToWarn,
@@ -50,14 +63,23 @@ module.exports = {
   cannotReadPropertyOfUndefined__DEPRECATED,
   createMockEnvironment,
   describeWithFeatureFlags,
+  disallowConsoleErrors,
+  disallowConsoleWarnings,
+  disallowWarnings,
+  expectConsoleError,
+  expectConsoleErrorsMany,
+  expectConsoleErrorWillFire,
+  expectConsoleWarningWillFire,
+  expectConsoleWarning,
+  expectConsoleWarningsMany,
   expectToWarn,
   expectToWarnMany,
   expectWarningWillFire,
-  disallowWarnings,
   FIXTURE_TAG,
   generateTestsFromFixtures,
   matchers: Matchers,
   printAST,
   simpleClone,
+  trackRetentionForEnvironment,
   unwrapContainer,
 };

package/lib/consoleError.js

@@ -0,0 +1,63 @@
+/**
+ * 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
+ * 
+ * @format
+ */
+'use strict';
+/* global jest */
+
+var _require = require('./consoleErrorsAndWarnings'),
+    createConsoleInterceptionSystem = _require.createConsoleInterceptionSystem;
+
+var consoleErrorsSystem = createConsoleInterceptionSystem('error', 'expectConsoleError', function (impl) {
+  jest.spyOn(console, 'error').mockImplementation(impl);
+});
+/**
+ * Mocks console.error so that errors printed to the console are instead thrown.
+ * Any expected errors need to be explicitly expected with `expectConsoleErrorWillFire(message)`.
+ *
+ * NOTE: This should be called on top of a test file. The test should NOT
+ *       use `jest.resetModules()` or manually mock `console`.
+ */
+
+function disallowConsoleErrors() {
+  consoleErrorsSystem.disallowMessages();
+}
+/**
+ * Expect an error with the given message. If the message isn't fired in the
+ * current test, the test will fail.
+ */
+
+
+function expectConsoleErrorWillFire(message, options) {
+  consoleErrorsSystem.expectMessageWillFire(message, options);
+}
+/**
+ * Expect the callback `fn` to print an error with the message, and otherwise fail.
+ */
+
+
+function expectConsoleError(message, fn) {
+  return consoleErrorsSystem.expectMessage(message, fn);
+}
+/**
+ * Expect the callback `fn` to trigger all console errors (in sequence),
+ * and otherwise fail.
+ */
+
+
+function expectConsoleErrorsMany(messages, fn) {
+  return consoleErrorsSystem.expectMessageMany(messages, fn);
+}
+
+module.exports = {
+  disallowConsoleErrors: disallowConsoleErrors,
+  expectConsoleErrorWillFire: expectConsoleErrorWillFire,
+  expectConsoleError: expectConsoleError,
+  expectConsoleErrorsMany: expectConsoleErrorsMany
+};

package/lib/consoleErrorsAndWarnings.js

@@ -0,0 +1,116 @@
+/**
+ * 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
+ * 
+ * @format
+ */
+'use strict';
+/* global afterEach */
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+var originalConsoleError = console.error;
+
+function createConsoleInterceptionSystem(typename, expectFunctionName, setUpMock) {
+  var installed = false;
+  var expectedMessages = [];
+  var optionalMessages = [];
+  var contextualExpectedMessage = [];
+  var typenameCap = typename.charAt(0).toUpperCase() + typename.slice(1);
+  var typenameCapPlural = typenameCap + 's';
+  var installerName = "disallow".concat(typenameCap, "s");
+
+  function handleMessage(message) {
+    var index = expectedMessages.findIndex(function (expected) {
+      return message.startsWith(expected);
+    });
+    var optionalIndex = optionalMessages.findIndex(function (expected) {
+      return message.startsWith(expected);
+    });
+
+    if (contextualExpectedMessage.length > 0 && message.startsWith(contextualExpectedMessage[0])) {
+      contextualExpectedMessage.shift();
+    } else if (index >= 0) {
+      expectedMessages.splice(index, 1);
+    } else if (optionalIndex >= 0) {
+      optionalMessages.splice(optionalIndex, 1);
+    } else {
+      // log to console in case the error gets swallowed somewhere
+      originalConsoleError("Unexpected ".concat(typenameCap, ": ") + message);
+      throw new Error("".concat(typenameCap, ": ") + message);
+    }
+  }
+
+  function disallowMessages() {
+    if (installed) {
+      throw new Error("".concat(installerName, " should be called only once."));
+    }
+
+    installed = true;
+    setUpMock(handleMessage);
+    afterEach(function () {
+      optionalMessages.length = 0;
+      contextualExpectedMessage.length = 0;
+
+      if (expectedMessages.length > 0) {
+        var error = new Error("Some ".concat(expectedMessages.length, " expected ").concat(typename, "s where not triggered:\n\n") + Array.from(expectedMessages, function (message) {
+          return " * ".concat(message);
+        }).join('\n') + '\n');
+        expectedMessages.length = 0;
+        throw error;
+      }
+    });
+  }
+
+  function expectMessageWillFire(message, options) {
+    if (!installed) {
+      throw new Error("".concat(installerName, " needs to be called before expect").concat(typenameCapPlural, "WillFire"));
+    }
+
+    var optional = (options === null || options === void 0 ? void 0 : options.optional) === true; // avoid "sketchy null check"
+
+    for (var i = 0; i < ((_options$count = options === null || options === void 0 ? void 0 : options.count) !== null && _options$count !== void 0 ? _options$count : 1); i++) {
+      var _options$count;
+
+      (optional ? optionalMessages : expectedMessages).push(message);
+    }
+  }
+
+  function expectMessage(message, fn) {
+    return expectMessageMany([message], fn);
+  }
+
+  function expectMessageMany(messages, fn) {
+    if (contextualExpectedMessage.length > 0) {
+      throw new Error("Cannot nest ".concat(expectFunctionName, "() calls."));
+    }
+
+    contextualExpectedMessage.push.apply(contextualExpectedMessage, (0, _toConsumableArray2["default"])(messages));
+    var result = fn();
+
+    if (contextualExpectedMessage.length > 0) {
+      var notFired = contextualExpectedMessage.toString();
+      contextualExpectedMessage.length = 0;
+      throw new Error("Expected ".concat(typename, " in callback: ").concat(notFired));
+    }
+
+    return result;
+  }
+
+  return {
+    disallowMessages: disallowMessages,
+    expectMessageWillFire: expectMessageWillFire,
+    expectMessage: expectMessage,
+    expectMessageMany: expectMessageMany
+  };
+}
+
+module.exports = {
+  createConsoleInterceptionSystem: createConsoleInterceptionSystem
+};

package/lib/consoleWarning.js

@@ -0,0 +1,63 @@
+/**
+ * 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
+ * 
+ * @format
+ */
+'use strict';
+/* global jest */
+
+var _require = require('./consoleErrorsAndWarnings'),
+    createConsoleInterceptionSystem = _require.createConsoleInterceptionSystem;
+
+var consoleWarningsSystem = createConsoleInterceptionSystem('warning', 'expectConsoleWarning', function (impl) {
+  jest.spyOn(console, 'warn').mockImplementation(impl);
+});
+/**
+ * Mocks console.warn so that warnings printed to the console are instead thrown.
+ * Any expected warnings need to be explicitly expected with `expectConsoleWarningWillFire(message)`.
+ *
+ * NOTE: This should be called on top of a test file. The test should NOT
+ *       use `jest.resetModules()` or manually mock `console`.
+ */
+
+function disallowConsoleWarnings() {
+  consoleWarningsSystem.disallowMessages();
+}
+/**
+ * Expect a warning with the given message. If the message isn't fired in the
+ * current test, the test will fail.
+ */
+
+
+function expectConsoleWarningWillFire(message, options) {
+  consoleWarningsSystem.expectMessageWillFire(message, options);
+}
+/**
+ * Expect the callback `fn` to print a warning with the message, and otherwise fail.
+ */
+
+
+function expectConsoleWarning(message, fn) {
+  return consoleWarningsSystem.expectMessage(message, fn);
+}
+/**
+ * Expect the callback `fn` to trigger all console warnings (in sequence),
+ * and otherwise fail.
+ */
+
+
+function expectConsoleWarningsMany(messages, fn) {
+  return consoleWarningsSystem.expectMessageMany(messages, fn);
+}
+
+module.exports = {
+  disallowConsoleWarnings: disallowConsoleWarnings,
+  expectConsoleWarningWillFire: expectConsoleWarningWillFire,
+  expectConsoleWarning: expectConsoleWarning,
+  expectConsoleWarningsMany: expectConsoleWarningsMany
+};

package/lib/index.js

@@ -10,11 +10,23 @@
 // flowlint ambiguous-object-type:error
 'use strict';
 
+var _require = require('./consoleError'),
+    disallowConsoleErrors = _require.disallowConsoleErrors,
+    expectConsoleError = _require.expectConsoleError,
+    expectConsoleErrorsMany = _require.expectConsoleErrorsMany,
+    expectConsoleErrorWillFire = _require.expectConsoleErrorWillFire;
+
+var _require2 = require('./consoleWarning'),
+    disallowConsoleWarnings = _require2.disallowConsoleWarnings,
+    expectConsoleWarning = _require2.expectConsoleWarning,
+    expectConsoleWarningsMany = _require2.expectConsoleWarningsMany,
+    expectConsoleWarningWillFire = _require2.expectConsoleWarningWillFire;
+
 var describeWithFeatureFlags = require('./describeWithFeatureFlags');
 
-var _require = require('./generateTestsFromFixtures'),
-    FIXTURE_TAG = _require.FIXTURE_TAG,
-    generateTestsFromFixtures = _require.generateTestsFromFixtures;
+var _require3 = require('./generateTestsFromFixtures'),
+    FIXTURE_TAG = _require3.FIXTURE_TAG,
+    generateTestsFromFixtures = _require3.generateTestsFromFixtures;
 
 var Matchers = require('./Matchers');
 
@@ -22,15 +34,17 @@ var printAST = require('./printAST');
 
 var simpleClone = require('./simpleClone');
 
-var _require2 = require('./warnings'),
-    disallowWarnings = _require2.disallowWarnings,
-    expectToWarn = _require2.expectToWarn,
-    expectToWarnMany = _require2.expectToWarnMany,
-    expectWarningWillFire = _require2.expectWarningWillFire;
+var trackRetentionForEnvironment = require('./trackRetentionForEnvironment');
+
+var _require4 = require('./warnings'),
+    disallowWarnings = _require4.disallowWarnings,
+    expectToWarn = _require4.expectToWarn,
+    expectToWarnMany = _require4.expectToWarnMany,
+    expectWarningWillFire = _require4.expectWarningWillFire;
 
-var _require3 = require('relay-test-utils'),
-    createMockEnvironment = _require3.createMockEnvironment,
-    unwrapContainer = _require3.unwrapContainer; // Apparently, in node v16 (because now they are using V8 V9.something)
+var _require5 = require('relay-test-utils'),
+    createMockEnvironment = _require5.createMockEnvironment,
+    unwrapContainer = _require5.unwrapContainer; // Apparently, in node v16 (because now they are using V8 V9.something)
 // the content of the TypeError has changed, and now some of our tests
 // stated to fail.
 // This is a temporary work-around to make test pass, but we need to
@@ -53,14 +67,23 @@ module.exports = {
   cannotReadPropertyOfUndefined__DEPRECATED: cannotReadPropertyOfUndefined__DEPRECATED,
   createMockEnvironment: createMockEnvironment,
   describeWithFeatureFlags: describeWithFeatureFlags,
+  disallowConsoleErrors: disallowConsoleErrors,
+  disallowConsoleWarnings: disallowConsoleWarnings,
+  disallowWarnings: disallowWarnings,
+  expectConsoleError: expectConsoleError,
+  expectConsoleErrorsMany: expectConsoleErrorsMany,
+  expectConsoleErrorWillFire: expectConsoleErrorWillFire,
+  expectConsoleWarningWillFire: expectConsoleWarningWillFire,
+  expectConsoleWarning: expectConsoleWarning,
+  expectConsoleWarningsMany: expectConsoleWarningsMany,
   expectToWarn: expectToWarn,
   expectToWarnMany: expectToWarnMany,
   expectWarningWillFire: expectWarningWillFire,
-  disallowWarnings: disallowWarnings,
   FIXTURE_TAG: FIXTURE_TAG,
   generateTestsFromFixtures: generateTestsFromFixtures,
   matchers: Matchers,
   printAST: printAST,
   simpleClone: simpleClone,
+  trackRetentionForEnvironment: trackRetentionForEnvironment,
   unwrapContainer: unwrapContainer
 };

package/lib/testschema.graphql

@@ -143,28 +143,23 @@ type Subscription {
 }
 
 input ActorSubscribeInput {
-  clientMutationId: String
   subscribeeId: ID
 }
 
 input ActorNameChangeInput {
-  clientMutationId: String
   newName: String
 }
 
 input ApplicationRequestDeleteAllInput {
-  clientMutationId: String
   deletedRequestIds: [ID]
 }
 
 input CommentCreateInput {
-  clientMutationId: String
   feedbackId: ID
   feedback: CommentfeedbackFeedback
 }
 
 input CommentsCreateInput {
-  clientMutationId: String
   feedbackId: ID
   feedback: [CommentfeedbackFeedback]
 }
@@ -178,40 +173,33 @@ input FeedbackcommentComment {
 }
 
 input CommentCreateSubscriptionInput {
-  clientSubscriptionId: String
   feedbackId: ID
   text: String
 }
 
 input CommentDeleteInput {
-  clientMutationId: String
   commentId: ID
 }
 
 input CommentsDeleteInput {
-  clientMutationId: String
   commentIds: [ID]
 }
 
 input FeedbackLikeInput {
-  clientMutationId: String
   feedbackId: ID
 }
 
 input FeedbackLikeInputStrict {
   userID: ID!
-  clientMutationId: ID!
   feedbackId: ID!
   description: String
 }
 
 input NodeSaveStateInput {
-  clientMutationId: String
   nodeId: ID
 }
 
 input UpdateAllSeenStateInput {
-  clientMutationId: String
   storyIds: [ID]
 }
 
@@ -221,22 +209,18 @@ input LocationInput {
 }
 
 type setLocationResponsePayload {
-  clientMutationId: String
   viewer: Viewer
 }
 
 type ActorSubscribeResponsePayload {
-  clientMutationId: String
   subscribee: Actor
 }
 
 type ActorNameChangePayload {
-  clientMutationId: String
   actor: Actor
 }
 
 type ApplicationRequestDeleteAllResponsePayload {
-  clientMutationId: String
   deletedRequestIds: [ID]
 }
 
@@ -250,7 +234,6 @@ input CheckinSearchInput {
 }
 
 input StoryUpdateInput {
-  clientMutationId: String
   body: InputText
 }
 
@@ -334,7 +317,6 @@ type ConfigCreateSubscriptResponsePayload {
 }
 
 type CommentCreateResponsePayload {
-  clientMutationId: String
   comment: Comment
   feedback: Feedback
   feedbackCommentEdge: CommentsEdge
@@ -342,7 +324,6 @@ type CommentCreateResponsePayload {
 }
 
 type CommentsCreateResponsePayload {
-  clientMutationId: String
   comments: [Comment]
   feedback: [Feedback]
   feedbackCommentEdges: [CommentsEdge]
@@ -350,19 +331,16 @@ type CommentsCreateResponsePayload {
 }
 
 type CommentDeleteResponsePayload {
-  clientMutationId: String
   deletedCommentId: ID
   feedback: Feedback
 }
 
 type CommentsDeleteResponsePayload {
-  clientMutationId: String
   deletedCommentIds: [ID]
   feedback: Feedback
 }
 
 type StoryUpdateResponsePayload {
-  clientMutationId: String
   story: Story
 }
 
@@ -478,8 +456,6 @@ type Feedback implements Node & HasJsField {
 }
 
 type FeedbackLikeResponsePayload {
-  clientMutationId: String
-  clientSubscriptionId: String
   feedback: Feedback
 }
 
@@ -938,13 +914,11 @@ type TopLevelCommentsConnection {
 }
 
 input UnfriendInput {
-  clientMutationId: String
   friendId: ID
 }
 
 type UnfriendResponsePayload {
   actor: Actor
-  clientMutationId: String
   formerFriend: User
 }
 

package/lib/trackRetentionForEnvironment.js

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ *
+ * 
+ * @format
+ */
+// flowlint ambiguous-object-type:error
+'use strict';
+/* global jest */
+
+/**
+ * Takes an environment and augments it with a mock implementation of `retain`
+ * that tracks what operations are currently retained. Also returns the Jest mock
+ * `release` function for backwards-compatibility with existing tests, but you
+ * should use `isOperationRetained` for new tests as it is much less error-prone.
+ */
+function trackRetentionForEnvironment(environment) {
+  var retainCountsByOperation = new Map();
+  var release = jest.fn(function (id) {
+    var _retainCountsByOperat;
+
+    var existing = (_retainCountsByOperat = retainCountsByOperation.get(id)) !== null && _retainCountsByOperat !== void 0 ? _retainCountsByOperat : NaN;
+
+    if (existing === 1) {
+      retainCountsByOperation["delete"](id);
+    } else {
+      retainCountsByOperation.set(id, existing - 1);
+    }
+  }); // $FlowFixMe[cannot-write] safe to do for mocking
+
+  environment.retain = jest.fn(function (operation) {
+    var _retainCountsByOperat2;
+
+    var id = operation.request.identifier;
+    var existing = (_retainCountsByOperat2 = retainCountsByOperation.get(id)) !== null && _retainCountsByOperat2 !== void 0 ? _retainCountsByOperat2 : 0;
+    retainCountsByOperation.set(id, existing + 1);
+    var released = false;
+    return {
+      dispose: function dispose() {
+        if (!released) {
+          release(id);
+        }
+
+        released = true;
+      }
+    };
+  });
+
+  function isOperationRetained(operation) {
+    var _retainCountsByOperat3;
+
+    var id = operation.request.identifier;
+    return ((_retainCountsByOperat3 = retainCountsByOperation.get(id)) !== null && _retainCountsByOperat3 !== void 0 ? _retainCountsByOperat3 : 0) > 0;
+  }
+
+  return {
+    release_DEPRECATED: release,
+    isOperationRetained: isOperationRetained
+  };
+}
+
+module.exports = trackRetentionForEnvironment;

package/lib/warnings.js

@@ -9,29 +9,12 @@
  * @format
  */
 'use strict';
-/* global jest, afterEach */
+/* global jest */
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _require = require('./consoleErrorsAndWarnings'),
+    createConsoleInterceptionSystem = _require.createConsoleInterceptionSystem;
 
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-var installed = false;
-var expectedWarnings = [];
-var contextualExpectedWarning = [];
-/**
- * Mocks the `warning` module to turn warnings into errors. Any expected
- * warnings need to be explicitly expected with `expectWarningWillFire(message)`.
- *
- * NOTE: This should be called on top of a test file. The test should NOT
- *       use `jest.resetModules()` or manually mock `warning`.
- */
-
-function disallowWarnings() {
-  if (installed) {
-    throw new Error('`disallowWarnings` should be called at most once');
-  }
-
-  installed = true;
+var warningsSystem = createConsoleInterceptionSystem('warning', 'expectToWarn', function (impl) {
   jest.mock("fbjs/lib/warning", function () {
     return jest.fn(function (condition, format) {
       for (var _len = arguments.length, args = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
@@ -43,31 +26,21 @@ function disallowWarnings() {
         var message = format.replace(/%s/g, function () {
           return String(args[argIndex++]);
         });
-        var index = expectedWarnings.indexOf(message);
-
-        if (contextualExpectedWarning.length > 0 && contextualExpectedWarning[0] === message) {
-          contextualExpectedWarning.shift();
-        } else if (index >= 0) {
-          expectedWarnings.splice(index, 1);
-        } else {
-          // log to console in case the error gets swallowed somewhere
-          console.error('Unexpected Warning: ' + message);
-          throw new Error('Warning: ' + message);
-        }
+        impl(message);
       }
     });
   });
-  afterEach(function () {
-    contextualExpectedWarning.length = 0;
+});
+/**
+ * Mocks the `warning` module to turn warnings into errors. Any expected
+ * warnings need to be explicitly expected with `expectWarningWillFire(message)`.
+ *
+ * NOTE: This should be called on top of a test file. The test should NOT
+ *       use `jest.resetModules()` or manually mock `warning`.
+ */
 
-    if (expectedWarnings.length > 0) {
-      var error = new Error('Some expected warnings where not triggered:\n\n' + Array.from(expectedWarnings, function (message) {
-        return " * ".concat(message);
-      }).join('\n') + '\n');
-      expectedWarnings.length = 0;
-      throw error;
-    }
-  });
+function disallowWarnings() {
+  warningsSystem.disallowMessages();
 }
 /**
  * Expect a warning with the given message. If the message isn't fired in the
@@ -75,12 +48,8 @@ function disallowWarnings() {
  */
 
 
-function expectWarningWillFire(message) {
-  if (!installed) {
-    throw new Error('`disallowWarnings` needs to be called before `expectWarningWillFire`');
-  }
-
-  expectedWarnings.push(message);
+function expectWarningWillFire(message, options) {
+  warningsSystem.expectMessageWillFire(message, options);
 }
 /**
  * Expect the callback `fn` to trigger the warning message and otherwise fail.
@@ -88,7 +57,7 @@ function expectWarningWillFire(message) {
 
 
 function expectToWarn(message, fn) {
-  return expectToWarnMany([message], fn);
+  return warningsSystem.expectMessage(message, fn);
 }
 /**
  * Expect the callback `fn` to trigger all warning messages (in sequence)
@@ -97,20 +66,7 @@ function expectToWarn(message, fn) {
 
 
 function expectToWarnMany(messages, fn) {
-  if (contextualExpectedWarning.length > 0) {
-    throw new Error('Cannot nest `expectToWarn()` calls.');
-  }
-
-  contextualExpectedWarning.push.apply(contextualExpectedWarning, (0, _toConsumableArray2["default"])(messages));
-  var result = fn();
-
-  if (contextualExpectedWarning.length > 0) {
-    var notFired = contextualExpectedWarning.toString();
-    contextualExpectedWarning.length = 0;
-    throw new Error("Expected callback to warn: ".concat(notFired));
-  }
-
-  return result;
+  return warningsSystem.expectMessageMany(messages, fn);
 }
 
 module.exports = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "relay-test-utils-internal",
   "description": "Internal utilities for testing Relay.",
-  "version": "13.1.0",
+  "version": "14.0.0",
   "keywords": [
     "graphql",
     "relay"
@@ -17,7 +17,7 @@
   "dependencies": {
     "@babel/runtime": "^7.0.0",
     "fbjs": "^3.0.2",
-    "relay-runtime": "13.1.0"
+    "relay-runtime": "14.0.0"
   },
   "directories": {
     "": "./"

package/relay-test-utils-internal.js

@@ -1,4 +1,4 @@
 /**
- * Relay v13.1.0
+ * Relay v14.0.0
  */
-module.exports=function(e){var n={};function t(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,t),o.l=!0,o.exports}return t.m=e,t.c=n,t.d=function(e,n,r){t.o(e,n)||Object.defineProperty(e,n,{enumerable:!0,get:r})},t.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.t=function(e,n){if(1&n&&(e=t(e)),8&n)return e;if(4&n&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(t.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&n&&"string"!=typeof e)for(var o in e)t.d(r,o,function(n){return e[n]}.bind(null,o));return r},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,n){return Object.prototype.hasOwnProperty.call(e,n)},t.p="",t(t.s=2)}([function(e,n){e.exports=require("@babel/runtime/helpers/interopRequireDefault")},function(e,n){e.exports=require("relay-runtime")},function(e,n,t){"use strict";var r=t(3),o=t(5),i=o.FIXTURE_TAG,a=o.generateTestsFromFixtures,c=t(10),u=t(12),s=t(14),f=t(15),l=f.disallowWarnings,p=f.expectToWarn,d=f.expectToWarnMany,g=f.expectWarningWillFire,h=t(17),x=h.createMockEnvironment,y=h.unwrapContainer;e.exports={cannotReadPropertyOfUndefined__DEPRECATED:function(e){return process.version.match(/^v16\.(.+)$/)?"Cannot read properties of undefined (reading '".concat(e,"')"):"Cannot read property '".concat(e,"' of undefined")},createMockEnvironment:x,describeWithFeatureFlags:r,expectToWarn:p,expectToWarnMany:d,expectWarningWillFire:g,disallowWarnings:l,FIXTURE_TAG:i,generateTestsFromFixtures:a,matchers:c,printAST:u,simpleClone:s,unwrapContainer:y}},function(e,n,t){"use strict";var r=t(0)(t(4));e.exports=function(e,n,o){describe.each(e)("".concat(n," - Feature flags: %o"),(function(e){var n;beforeEach((function(){var o=t(1).RelayFeatureFlags;n=(0,r.default)({},o),Object.assign(o,e)})),afterEach((function(){var e=t(1).RelayFeatureFlags;Object.assign(e,n)})),o()}))}},function(e,n){e.exports=require("@babel/runtime/helpers/objectSpread2")},function(e,n,t){"use strict";var r=t(0)(t(6)),o=t(7),i=t(8),a=t(9),c=Symbol.for("FIXTURE_TAG");expect.addSnapshotSerializer({print:function(e){return Object.keys(e).map((function(n){return"~~~~~~~~~~ ".concat(n.toUpperCase()," ~~~~~~~~~~\n").concat(e[n])})).join("\n")},test:function(e){return e&&!0===e[c]}}),e.exports={generateTestsFromFixtures:function(e,n){var t=i.readdirSync(e);test("has fixtures in ".concat(e),(function(){expect(t.length>0).toBe(!0)}));var u=t.filter((function(e){return e.startsWith("only.")}));u.length&&(test.skip.each(t.filter((function(e){return!e.startsWith("only.")})))("matches expected output: %s",(function(){})),t=u),test.each(t)("matches expected output: %s",(function(t){var u,s=i.readFileSync(a.join(e,t),"utf8"),f=o(s,n,t);expect((u={},(0,r.default)(u,c,!0),(0,r.default)(u,"input",s),(0,r.default)(u,"output",f),u)).toMatchSnapshot()}))},FIXTURE_TAG:c}},function(e,n){e.exports=require("@babel/runtime/helpers/defineProperty")},function(e,n,t){"use strict";e.exports=function(e,n,t){if(/^# *expected-to-throw/.test(e)||/\.error\.\w+$/.test(t)){var r;try{r=n(e)}catch(e){return"THROWN EXCEPTION:\n\n".concat(e.toString())}throw new Error("Expected test file '".concat(t,"' to throw, but it passed:\n").concat(r))}return n(e)}},function(e,n){e.exports=require("fs")},function(e,n){e.exports=require("path")},function(e,n,t){"use strict";e.exports={toBeDeeplyFrozen:function(e){return function e(n){if(expect(Object.isFrozen(n)).toBe(!0),Array.isArray(n))n.forEach((function(n){return e(n)}));else if("object"==typeof n&&null!==n)for(var t in n)e(n[t])}(e),{pass:!0}},toWarn:function(e,n){var r=this.isNot;function o(e){return e instanceof RegExp?e.toString():JSON.stringify(e)}function i(e){return"["+e.map(o).join(", ")+"]"}function a(e){return e.length?e.map((function(e){return i([!!e[0]].concat(e.slice(1)))})).join(", "):"[]"}var c=t(11);if(!c.mock)throw new Error("toWarn(): Requires `jest.mock('warning')`.");var u=c.mock.calls.length;e();var s=c.mock.calls.slice(u);return n?(Array.isArray(n)||(n=[n]),{pass:!!s.find((function(e){return e.length===n.length+1&&e.every((function(e,t){if(!t)return!e;var r=n[t-1];return r instanceof RegExp?r.test(e):e===r}))})),message:function(){return"Expected ".concat(r?"not ":"","to warn: ")+"".concat(i([!1].concat(n))," but ")+"`warning` received the following calls: "+"".concat(a(s),".")}}):{pass:!!s.filter((function(e){return!e[0]})).length,message:function(){return"Expected ".concat(r?"not ":"","to warn but ")+"`warning` received the following calls: "+"".concat(a(s),".")}}}}},function(e,n){e.exports=require("fbjs/lib/warning")},function(e,n,t){"use strict";var r=t(0)(t(13));e.exports=function(e){return function e(n,t){switch(typeof n){case"undefined":return"undefined";case"object":if(null===n)return"null";if(Array.isArray(n)){if(0===n.length)return"[]";var o,i="[\n",a=t+"  ",c=(0,r.default)(n);try{for(c.s();!(o=c.n()).done;){var u=o.value;i+=a+e(u,a)+",\n"}}catch(e){c.e(e)}finally{c.f()}return i+=t+"]"}if("string"==typeof n.kind){for(var s="".concat(n.kind," {\n"),f=t+"  ",l=0,p=Object.entries(n);l<p.length;l++){var d=p[l],g=d[0],h=d[1];"kind"!==g&&(s+="".concat(f).concat(g,": ").concat(e(h,f),",\n"))}return s+=t+"}"}if("function"==typeof n.toJSON)return e(n.toJSON(),t);for(var x="{\n",y=t+"  ",b=0,v=Object.entries(n);b<v.length;b++){var w=v[b],m=w[0],E=w[1];x+="".concat(y).concat(JSON.stringify(m),": ").concat(e(E,y),",\n")}return x+=t+"}";case"string":case"number":case"boolean":return JSON.stringify(n,null,2).replace("\n","\n"+t);default:throw new Error("printAST doesn't handle values where "+"typeof value === '".concat(typeof n,"'."))}}(e,"")}},function(e,n){e.exports=require("@babel/runtime/helpers/createForOfIteratorHelper")},function(e,n,t){"use strict";e.exports=function e(n){if(Array.isArray(n))return n.map(e);if(null!=n&&"object"==typeof n){var t={};for(var r in n)t[r]=e(n[r]);return t}return n}},function(e,n,t){"use strict";var r=t(0)(t(16)),o=!1,i=[],a=[];function c(e,n){if(a.length>0)throw new Error("Cannot nest `expectToWarn()` calls.");a.push.apply(a,(0,r.default)(e));var t=n();if(a.length>0){var o=a.toString();throw a.length=0,new Error("Expected callback to warn: ".concat(o))}return t}e.exports={disallowWarnings:function(){if(o)throw new Error("`disallowWarnings` should be called at most once");o=!0,jest.mock("fbjs/lib/warning",(function(){return jest.fn((function(e,n){for(var t=arguments.length,r=new Array(t>2?t-2:0),o=2;o<t;o++)r[o-2]=arguments[o];if(!e){var c=0,u=n.replace(/%s/g,(function(){return String(r[c++])})),s=i.indexOf(u);if(a.length>0&&a[0]===u)a.shift();else{if(!(s>=0))throw console.error("Unexpected Warning: "+u),new Error("Warning: "+u);i.splice(s,1)}}}))})),afterEach((function(){if(a.length=0,i.length>0){var e=new Error("Some expected warnings where not triggered:\n\n"+Array.from(i,(function(e){return" * ".concat(e)})).join("\n")+"\n");throw i.length=0,e}}))},expectWarningWillFire:function(e){if(!o)throw new Error("`disallowWarnings` needs to be called before `expectWarningWillFire`");i.push(e)},expectToWarn:function(e,n){return c([e],n)},expectToWarnMany:c}},function(e,n){e.exports=require("@babel/runtime/helpers/toConsumableArray")},function(e,n){e.exports=require("relay-test-utils")}]);
+module.exports=function(e){var n={};function t(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,t),o.l=!0,o.exports}return t.m=e,t.c=n,t.d=function(e,n,r){t.o(e,n)||Object.defineProperty(e,n,{enumerable:!0,get:r})},t.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.t=function(e,n){if(1&n&&(e=t(e)),8&n)return e;if(4&n&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(t.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&n&&"string"!=typeof e)for(var o in e)t.d(r,o,function(n){return e[n]}.bind(null,o));return r},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,n){return Object.prototype.hasOwnProperty.call(e,n)},t.p="",t(t.s=3)}([function(e,n){e.exports=require("@babel/runtime/helpers/interopRequireDefault")},function(e,n,t){"use strict";var r=t(0)(t(5)),o=console.error;e.exports={createConsoleInterceptionSystem:function(e,n,t){var i=!1,c=[],a=[],s=[],u=e.charAt(0).toUpperCase()+e.slice(1),l=u+"s",f="disallow".concat(u,"s");function p(e){var n=c.findIndex((function(n){return e.startsWith(n)})),t=a.findIndex((function(n){return e.startsWith(n)}));if(s.length>0&&e.startsWith(s[0]))s.shift();else if(n>=0)c.splice(n,1);else{if(!(t>=0))throw o("Unexpected ".concat(u,": ")+e),new Error("".concat(u,": ")+e);a.splice(t,1)}}function d(t,o){if(s.length>0)throw new Error("Cannot nest ".concat(n,"() calls."));s.push.apply(s,(0,r.default)(t));var i=o();if(s.length>0){var c=s.toString();throw s.length=0,new Error("Expected ".concat(e," in callback: ").concat(c))}return i}return{disallowMessages:function(){if(i)throw new Error("".concat(f," should be called only once."));i=!0,t(p),afterEach((function(){if(a.length=0,s.length=0,c.length>0){var n=new Error("Some ".concat(c.length," expected ").concat(e,"s where not triggered:\n\n")+Array.from(c,(function(e){return" * ".concat(e)})).join("\n")+"\n");throw c.length=0,n}}))},expectMessageWillFire:function(e,n){if(!i)throw new Error("".concat(f," needs to be called before expect").concat(l,"WillFire"));for(var t=!0===(null==n?void 0:n.optional),r=0;r<(null!==(o=null==n?void 0:n.count)&&void 0!==o?o:1);r++){var o;(t?a:c).push(e)}},expectMessage:function(e,n){return d([e],n)},expectMessageMany:d}}}},function(e,n){e.exports=require("relay-runtime")},function(e,n,t){"use strict";var r=t(4),o=r.disallowConsoleErrors,i=r.expectConsoleError,c=r.expectConsoleErrorsMany,a=r.expectConsoleErrorWillFire,s=t(6),u=s.disallowConsoleWarnings,l=s.expectConsoleWarning,f=s.expectConsoleWarningsMany,p=s.expectConsoleWarningWillFire,d=t(7),g=t(9),x=g.FIXTURE_TAG,h=g.generateTestsFromFixtures,y=t(14),v=t(16),w=t(18),b=t(19),m=t(20),W=m.disallowWarnings,E=m.expectToWarn,C=m.expectToWarnMany,M=m.expectWarningWillFire,F=t(21),j=F.createMockEnvironment,S=F.unwrapContainer;e.exports={cannotReadPropertyOfUndefined__DEPRECATED:function(e){return process.version.match(/^v16\.(.+)$/)?"Cannot read properties of undefined (reading '".concat(e,"')"):"Cannot read property '".concat(e,"' of undefined")},createMockEnvironment:j,describeWithFeatureFlags:d,disallowConsoleErrors:o,disallowConsoleWarnings:u,disallowWarnings:W,expectConsoleError:i,expectConsoleErrorsMany:c,expectConsoleErrorWillFire:a,expectConsoleWarningWillFire:p,expectConsoleWarning:l,expectConsoleWarningsMany:f,expectToWarn:E,expectToWarnMany:C,expectWarningWillFire:M,FIXTURE_TAG:x,generateTestsFromFixtures:h,matchers:y,printAST:v,simpleClone:w,trackRetentionForEnvironment:b,unwrapContainer:S}},function(e,n,t){"use strict";var r=(0,t(1).createConsoleInterceptionSystem)("error","expectConsoleError",(function(e){jest.spyOn(console,"error").mockImplementation(e)}));e.exports={disallowConsoleErrors:function(){r.disallowMessages()},expectConsoleErrorWillFire:function(e,n){r.expectMessageWillFire(e,n)},expectConsoleError:function(e,n){return r.expectMessage(e,n)},expectConsoleErrorsMany:function(e,n){return r.expectMessageMany(e,n)}}},function(e,n){e.exports=require("@babel/runtime/helpers/toConsumableArray")},function(e,n,t){"use strict";var r=(0,t(1).createConsoleInterceptionSystem)("warning","expectConsoleWarning",(function(e){jest.spyOn(console,"warn").mockImplementation(e)}));e.exports={disallowConsoleWarnings:function(){r.disallowMessages()},expectConsoleWarningWillFire:function(e,n){r.expectMessageWillFire(e,n)},expectConsoleWarning:function(e,n){return r.expectMessage(e,n)},expectConsoleWarningsMany:function(e,n){return r.expectMessageMany(e,n)}}},function(e,n,t){"use strict";var r=t(0)(t(8));e.exports=function(e,n,o){describe.each(e)("".concat(n," - Feature flags: %o"),(function(e){var n;beforeEach((function(){var o=t(2).RelayFeatureFlags;n=(0,r.default)({},o),Object.assign(o,e)})),afterEach((function(){var e=t(2).RelayFeatureFlags;Object.assign(e,n)})),o()}))}},function(e,n){e.exports=require("@babel/runtime/helpers/objectSpread2")},function(e,n,t){"use strict";var r=t(0)(t(10)),o=t(11),i=t(12),c=t(13),a=Symbol.for("FIXTURE_TAG");expect.addSnapshotSerializer({print:function(e){return Object.keys(e).map((function(n){return"~~~~~~~~~~ ".concat(n.toUpperCase()," ~~~~~~~~~~\n").concat(e[n])})).join("\n")},test:function(e){return e&&!0===e[a]}}),e.exports={generateTestsFromFixtures:function(e,n){var t=i.readdirSync(e);test("has fixtures in ".concat(e),(function(){expect(t.length>0).toBe(!0)}));var s=t.filter((function(e){return e.startsWith("only.")}));s.length&&(test.skip.each(t.filter((function(e){return!e.startsWith("only.")})))("matches expected output: %s",(function(){})),t=s),test.each(t)("matches expected output: %s",(function(t){var s,u=i.readFileSync(c.join(e,t),"utf8"),l=o(u,n,t);expect((s={},(0,r.default)(s,a,!0),(0,r.default)(s,"input",u),(0,r.default)(s,"output",l),s)).toMatchSnapshot()}))},FIXTURE_TAG:a}},function(e,n){e.exports=require("@babel/runtime/helpers/defineProperty")},function(e,n,t){"use strict";e.exports=function(e,n,t){if(/^# *expected-to-throw/.test(e)||/\.error\.\w+$/.test(t)){var r;try{r=n(e)}catch(e){return"THROWN EXCEPTION:\n\n".concat(e.toString())}throw new Error("Expected test file '".concat(t,"' to throw, but it passed:\n").concat(r))}return n(e)}},function(e,n){e.exports=require("fs")},function(e,n){e.exports=require("path")},function(e,n,t){"use strict";e.exports={toBeDeeplyFrozen:function(e){return function e(n){if(expect(Object.isFrozen(n)).toBe(!0),Array.isArray(n))n.forEach((function(n){return e(n)}));else if("object"==typeof n&&null!==n)for(var t in n)e(n[t])}(e),{pass:!0}},toWarn:function(e,n){var r=this.isNot;function o(e){return e instanceof RegExp?e.toString():JSON.stringify(e)}function i(e){return"["+e.map(o).join(", ")+"]"}function c(e){return e.length?e.map((function(e){return i([!!e[0]].concat(e.slice(1)))})).join(", "):"[]"}var a=t(15);if(!a.mock)throw new Error("toWarn(): Requires `jest.mock('warning')`.");var s=a.mock.calls.length;e();var u=a.mock.calls.slice(s);return n?(Array.isArray(n)||(n=[n]),{pass:!!u.find((function(e){return e.length===n.length+1&&e.every((function(e,t){if(!t)return!e;var r=n[t-1];return r instanceof RegExp?r.test(e):e===r}))})),message:function(){return"Expected ".concat(r?"not ":"","to warn: ")+"".concat(i([!1].concat(n))," but ")+"`warning` received the following calls: "+"".concat(c(u),".")}}):{pass:!!u.filter((function(e){return!e[0]})).length,message:function(){return"Expected ".concat(r?"not ":"","to warn but ")+"`warning` received the following calls: "+"".concat(c(u),".")}}}}},function(e,n){e.exports=require("fbjs/lib/warning")},function(e,n,t){"use strict";var r=t(0)(t(17));e.exports=function(e){return function e(n,t){switch(typeof n){case"undefined":return"undefined";case"object":if(null===n)return"null";if(Array.isArray(n)){if(0===n.length)return"[]";var o,i="[\n",c=t+"  ",a=(0,r.default)(n);try{for(a.s();!(o=a.n()).done;){var s=o.value;i+=c+e(s,c)+",\n"}}catch(e){a.e(e)}finally{a.f()}return i+=t+"]"}if("string"==typeof n.kind){for(var u="".concat(n.kind," {\n"),l=t+"  ",f=0,p=Object.entries(n);f<p.length;f++){var d=p[f],g=d[0],x=d[1];"kind"!==g&&(u+="".concat(l).concat(g,": ").concat(e(x,l),",\n"))}return u+=t+"}"}if("function"==typeof n.toJSON)return e(n.toJSON(),t);for(var h="{\n",y=t+"  ",v=0,w=Object.entries(n);v<w.length;v++){var b=w[v],m=b[0],W=b[1];h+="".concat(y).concat(JSON.stringify(m),": ").concat(e(W,y),",\n")}return h+=t+"}";case"string":case"number":case"boolean":return JSON.stringify(n,null,2).replace("\n","\n"+t);default:throw new Error("printAST doesn't handle values where "+"typeof value === '".concat(typeof n,"'."))}}(e,"")}},function(e,n){e.exports=require("@babel/runtime/helpers/createForOfIteratorHelper")},function(e,n,t){"use strict";e.exports=function e(n){if(Array.isArray(n))return n.map(e);if(null!=n&&"object"==typeof n){var t={};for(var r in n)t[r]=e(n[r]);return t}return n}},function(e,n,t){"use strict";e.exports=function(e){var n=new Map,t=jest.fn((function(e){var t,r=null!==(t=n.get(e))&&void 0!==t?t:NaN;1===r?n.delete(e):n.set(e,r-1)}));return e.retain=jest.fn((function(e){var r,o=e.request.identifier,i=null!==(r=n.get(o))&&void 0!==r?r:0;n.set(o,i+1);var c=!1;return{dispose:function(){c||t(o),c=!0}}})),{release_DEPRECATED:t,isOperationRetained:function(e){var t,r=e.request.identifier;return(null!==(t=n.get(r))&&void 0!==t?t:0)>0}}}},function(e,n,t){"use strict";var r=(0,t(1).createConsoleInterceptionSystem)("warning","expectToWarn",(function(e){jest.mock("fbjs/lib/warning",(function(){return jest.fn((function(n,t){for(var r=arguments.length,o=new Array(r>2?r-2:0),i=2;i<r;i++)o[i-2]=arguments[i];if(!n){var c=0,a=t.replace(/%s/g,(function(){return String(o[c++])}));e(a)}}))}))}));e.exports={disallowWarnings:function(){r.disallowMessages()},expectWarningWillFire:function(e,n){r.expectMessageWillFire(e,n)},expectToWarn:function(e,n){return r.expectMessage(e,n)},expectToWarnMany:function(e,n){return r.expectMessageMany(e,n)}}},function(e,n){e.exports=require("relay-test-utils")}]);

package/relay-test-utils-internal.min.js

@@ -1,9 +1,9 @@
 /**
- * Relay v13.1.0
+ * Relay v14.0.0
  *
  * 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.
  */
-module.exports=function(e){var n={};function t(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,t),o.l=!0,o.exports}return t.m=e,t.c=n,t.d=function(e,n,r){t.o(e,n)||Object.defineProperty(e,n,{enumerable:!0,get:r})},t.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.t=function(e,n){if(1&n&&(e=t(e)),8&n)return e;if(4&n&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(t.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&n&&"string"!=typeof e)for(var o in e)t.d(r,o,function(n){return e[n]}.bind(null,o));return r},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,n){return Object.prototype.hasOwnProperty.call(e,n)},t.p="",t(t.s=2)}([function(e,n){e.exports=require("@babel/runtime/helpers/interopRequireDefault")},function(e,n){e.exports=require("relay-runtime")},function(e,n,t){"use strict";var r=t(3),o=t(5),i=o.FIXTURE_TAG,a=o.generateTestsFromFixtures,c=t(10),u=t(12),s=t(14),f=t(15),l=f.disallowWarnings,p=f.expectToWarn,d=f.expectToWarnMany,g=f.expectWarningWillFire,h=t(17),x=h.createMockEnvironment,y=h.unwrapContainer;e.exports={cannotReadPropertyOfUndefined__DEPRECATED:function(e){return process.version.match(/^v16\.(.+)$/)?"Cannot read properties of undefined (reading '".concat(e,"')"):"Cannot read property '".concat(e,"' of undefined")},createMockEnvironment:x,describeWithFeatureFlags:r,expectToWarn:p,expectToWarnMany:d,expectWarningWillFire:g,disallowWarnings:l,FIXTURE_TAG:i,generateTestsFromFixtures:a,matchers:c,printAST:u,simpleClone:s,unwrapContainer:y}},function(e,n,t){"use strict";var r=t(0)(t(4));e.exports=function(e,n,o){describe.each(e)("".concat(n," - Feature flags: %o"),(function(e){var n;beforeEach((function(){var o=t(1).RelayFeatureFlags;n=(0,r.default)({},o),Object.assign(o,e)})),afterEach((function(){var e=t(1).RelayFeatureFlags;Object.assign(e,n)})),o()}))}},function(e,n){e.exports=require("@babel/runtime/helpers/objectSpread2")},function(e,n,t){"use strict";var r=t(0)(t(6)),o=t(7),i=t(8),a=t(9),c=Symbol.for("FIXTURE_TAG");expect.addSnapshotSerializer({print:function(e){return Object.keys(e).map((function(n){return"~~~~~~~~~~ ".concat(n.toUpperCase()," ~~~~~~~~~~\n").concat(e[n])})).join("\n")},test:function(e){return e&&!0===e[c]}}),e.exports={generateTestsFromFixtures:function(e,n){var t=i.readdirSync(e);test("has fixtures in ".concat(e),(function(){expect(t.length>0).toBe(!0)}));var u=t.filter((function(e){return e.startsWith("only.")}));u.length&&(test.skip.each(t.filter((function(e){return!e.startsWith("only.")})))("matches expected output: %s",(function(){})),t=u),test.each(t)("matches expected output: %s",(function(t){var u,s=i.readFileSync(a.join(e,t),"utf8"),f=o(s,n,t);expect((u={},(0,r.default)(u,c,!0),(0,r.default)(u,"input",s),(0,r.default)(u,"output",f),u)).toMatchSnapshot()}))},FIXTURE_TAG:c}},function(e,n){e.exports=require("@babel/runtime/helpers/defineProperty")},function(e,n,t){"use strict";e.exports=function(e,n,t){if(/^# *expected-to-throw/.test(e)||/\.error\.\w+$/.test(t)){var r;try{r=n(e)}catch(e){return"THROWN EXCEPTION:\n\n".concat(e.toString())}throw new Error("Expected test file '".concat(t,"' to throw, but it passed:\n").concat(r))}return n(e)}},function(e,n){e.exports=require("fs")},function(e,n){e.exports=require("path")},function(e,n,t){"use strict";e.exports={toBeDeeplyFrozen:function(e){return function e(n){if(expect(Object.isFrozen(n)).toBe(!0),Array.isArray(n))n.forEach((function(n){return e(n)}));else if("object"==typeof n&&null!==n)for(var t in n)e(n[t])}(e),{pass:!0}},toWarn:function(e,n){var r=this.isNot;function o(e){return e instanceof RegExp?e.toString():JSON.stringify(e)}function i(e){return"["+e.map(o).join(", ")+"]"}function a(e){return e.length?e.map((function(e){return i([!!e[0]].concat(e.slice(1)))})).join(", "):"[]"}var c=t(11);if(!c.mock)throw new Error("toWarn(): Requires `jest.mock('warning')`.");var u=c.mock.calls.length;e();var s=c.mock.calls.slice(u);return n?(Array.isArray(n)||(n=[n]),{pass:!!s.find((function(e){return e.length===n.length+1&&e.every((function(e,t){if(!t)return!e;var r=n[t-1];return r instanceof RegExp?r.test(e):e===r}))})),message:function(){return"Expected ".concat(r?"not ":"","to warn: ")+"".concat(i([!1].concat(n))," but ")+"`warning` received the following calls: "+"".concat(a(s),".")}}):{pass:!!s.filter((function(e){return!e[0]})).length,message:function(){return"Expected ".concat(r?"not ":"","to warn but ")+"`warning` received the following calls: "+"".concat(a(s),".")}}}}},function(e,n){e.exports=require("fbjs/lib/warning")},function(e,n,t){"use strict";var r=t(0)(t(13));e.exports=function(e){return function e(n,t){switch(typeof n){case"undefined":return"undefined";case"object":if(null===n)return"null";if(Array.isArray(n)){if(0===n.length)return"[]";var o,i="[\n",a=t+"  ",c=(0,r.default)(n);try{for(c.s();!(o=c.n()).done;){var u=o.value;i+=a+e(u,a)+",\n"}}catch(e){c.e(e)}finally{c.f()}return i+=t+"]"}if("string"==typeof n.kind){for(var s="".concat(n.kind," {\n"),f=t+"  ",l=0,p=Object.entries(n);l<p.length;l++){var d=p[l],g=d[0],h=d[1];"kind"!==g&&(s+="".concat(f).concat(g,": ").concat(e(h,f),",\n"))}return s+=t+"}"}if("function"==typeof n.toJSON)return e(n.toJSON(),t);for(var x="{\n",y=t+"  ",b=0,v=Object.entries(n);b<v.length;b++){var w=v[b],m=w[0],E=w[1];x+="".concat(y).concat(JSON.stringify(m),": ").concat(e(E,y),",\n")}return x+=t+"}";case"string":case"number":case"boolean":return JSON.stringify(n,null,2).replace("\n","\n"+t);default:throw new Error("printAST doesn't handle values where "+"typeof value === '".concat(typeof n,"'."))}}(e,"")}},function(e,n){e.exports=require("@babel/runtime/helpers/createForOfIteratorHelper")},function(e,n,t){"use strict";e.exports=function e(n){if(Array.isArray(n))return n.map(e);if(null!=n&&"object"==typeof n){var t={};for(var r in n)t[r]=e(n[r]);return t}return n}},function(e,n,t){"use strict";var r=t(0)(t(16)),o=!1,i=[],a=[];function c(e,n){if(a.length>0)throw new Error("Cannot nest `expectToWarn()` calls.");a.push.apply(a,(0,r.default)(e));var t=n();if(a.length>0){var o=a.toString();throw a.length=0,new Error("Expected callback to warn: ".concat(o))}return t}e.exports={disallowWarnings:function(){if(o)throw new Error("`disallowWarnings` should be called at most once");o=!0,jest.mock("fbjs/lib/warning",(function(){return jest.fn((function(e,n){for(var t=arguments.length,r=new Array(t>2?t-2:0),o=2;o<t;o++)r[o-2]=arguments[o];if(!e){var c=0,u=n.replace(/%s/g,(function(){return String(r[c++])})),s=i.indexOf(u);if(a.length>0&&a[0]===u)a.shift();else{if(!(s>=0))throw console.error("Unexpected Warning: "+u),new Error("Warning: "+u);i.splice(s,1)}}}))})),afterEach((function(){if(a.length=0,i.length>0){var e=new Error("Some expected warnings where not triggered:\n\n"+Array.from(i,(function(e){return" * ".concat(e)})).join("\n")+"\n");throw i.length=0,e}}))},expectWarningWillFire:function(e){if(!o)throw new Error("`disallowWarnings` needs to be called before `expectWarningWillFire`");i.push(e)},expectToWarn:function(e,n){return c([e],n)},expectToWarnMany:c}},function(e,n){e.exports=require("@babel/runtime/helpers/toConsumableArray")},function(e,n){e.exports=require("relay-test-utils")}]);
+module.exports=function(e){var n={};function t(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,t),o.l=!0,o.exports}return t.m=e,t.c=n,t.d=function(e,n,r){t.o(e,n)||Object.defineProperty(e,n,{enumerable:!0,get:r})},t.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.t=function(e,n){if(1&n&&(e=t(e)),8&n)return e;if(4&n&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(t.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&n&&"string"!=typeof e)for(var o in e)t.d(r,o,function(n){return e[n]}.bind(null,o));return r},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,n){return Object.prototype.hasOwnProperty.call(e,n)},t.p="",t(t.s=3)}([function(e,n){e.exports=require("@babel/runtime/helpers/interopRequireDefault")},function(e,n,t){"use strict";var r=t(0)(t(5)),o=console.error;e.exports={createConsoleInterceptionSystem:function(e,n,t){var i=!1,c=[],a=[],s=[],u=e.charAt(0).toUpperCase()+e.slice(1),l=u+"s",f="disallow".concat(u,"s");function p(e){var n=c.findIndex((function(n){return e.startsWith(n)})),t=a.findIndex((function(n){return e.startsWith(n)}));if(s.length>0&&e.startsWith(s[0]))s.shift();else if(n>=0)c.splice(n,1);else{if(!(t>=0))throw o("Unexpected ".concat(u,": ")+e),new Error("".concat(u,": ")+e);a.splice(t,1)}}function d(t,o){if(s.length>0)throw new Error("Cannot nest ".concat(n,"() calls."));s.push.apply(s,(0,r.default)(t));var i=o();if(s.length>0){var c=s.toString();throw s.length=0,new Error("Expected ".concat(e," in callback: ").concat(c))}return i}return{disallowMessages:function(){if(i)throw new Error("".concat(f," should be called only once."));i=!0,t(p),afterEach((function(){if(a.length=0,s.length=0,c.length>0){var n=new Error("Some ".concat(c.length," expected ").concat(e,"s where not triggered:\n\n")+Array.from(c,(function(e){return" * ".concat(e)})).join("\n")+"\n");throw c.length=0,n}}))},expectMessageWillFire:function(e,n){if(!i)throw new Error("".concat(f," needs to be called before expect").concat(l,"WillFire"));for(var t=!0===(null==n?void 0:n.optional),r=0;r<(null!==(o=null==n?void 0:n.count)&&void 0!==o?o:1);r++){var o;(t?a:c).push(e)}},expectMessage:function(e,n){return d([e],n)},expectMessageMany:d}}}},function(e,n){e.exports=require("relay-runtime")},function(e,n,t){"use strict";var r=t(4),o=r.disallowConsoleErrors,i=r.expectConsoleError,c=r.expectConsoleErrorsMany,a=r.expectConsoleErrorWillFire,s=t(6),u=s.disallowConsoleWarnings,l=s.expectConsoleWarning,f=s.expectConsoleWarningsMany,p=s.expectConsoleWarningWillFire,d=t(7),g=t(9),x=g.FIXTURE_TAG,h=g.generateTestsFromFixtures,y=t(14),v=t(16),w=t(18),b=t(19),m=t(20),W=m.disallowWarnings,E=m.expectToWarn,C=m.expectToWarnMany,M=m.expectWarningWillFire,F=t(21),j=F.createMockEnvironment,S=F.unwrapContainer;e.exports={cannotReadPropertyOfUndefined__DEPRECATED:function(e){return process.version.match(/^v16\.(.+)$/)?"Cannot read properties of undefined (reading '".concat(e,"')"):"Cannot read property '".concat(e,"' of undefined")},createMockEnvironment:j,describeWithFeatureFlags:d,disallowConsoleErrors:o,disallowConsoleWarnings:u,disallowWarnings:W,expectConsoleError:i,expectConsoleErrorsMany:c,expectConsoleErrorWillFire:a,expectConsoleWarningWillFire:p,expectConsoleWarning:l,expectConsoleWarningsMany:f,expectToWarn:E,expectToWarnMany:C,expectWarningWillFire:M,FIXTURE_TAG:x,generateTestsFromFixtures:h,matchers:y,printAST:v,simpleClone:w,trackRetentionForEnvironment:b,unwrapContainer:S}},function(e,n,t){"use strict";var r=(0,t(1).createConsoleInterceptionSystem)("error","expectConsoleError",(function(e){jest.spyOn(console,"error").mockImplementation(e)}));e.exports={disallowConsoleErrors:function(){r.disallowMessages()},expectConsoleErrorWillFire:function(e,n){r.expectMessageWillFire(e,n)},expectConsoleError:function(e,n){return r.expectMessage(e,n)},expectConsoleErrorsMany:function(e,n){return r.expectMessageMany(e,n)}}},function(e,n){e.exports=require("@babel/runtime/helpers/toConsumableArray")},function(e,n,t){"use strict";var r=(0,t(1).createConsoleInterceptionSystem)("warning","expectConsoleWarning",(function(e){jest.spyOn(console,"warn").mockImplementation(e)}));e.exports={disallowConsoleWarnings:function(){r.disallowMessages()},expectConsoleWarningWillFire:function(e,n){r.expectMessageWillFire(e,n)},expectConsoleWarning:function(e,n){return r.expectMessage(e,n)},expectConsoleWarningsMany:function(e,n){return r.expectMessageMany(e,n)}}},function(e,n,t){"use strict";var r=t(0)(t(8));e.exports=function(e,n,o){describe.each(e)("".concat(n," - Feature flags: %o"),(function(e){var n;beforeEach((function(){var o=t(2).RelayFeatureFlags;n=(0,r.default)({},o),Object.assign(o,e)})),afterEach((function(){var e=t(2).RelayFeatureFlags;Object.assign(e,n)})),o()}))}},function(e,n){e.exports=require("@babel/runtime/helpers/objectSpread2")},function(e,n,t){"use strict";var r=t(0)(t(10)),o=t(11),i=t(12),c=t(13),a=Symbol.for("FIXTURE_TAG");expect.addSnapshotSerializer({print:function(e){return Object.keys(e).map((function(n){return"~~~~~~~~~~ ".concat(n.toUpperCase()," ~~~~~~~~~~\n").concat(e[n])})).join("\n")},test:function(e){return e&&!0===e[a]}}),e.exports={generateTestsFromFixtures:function(e,n){var t=i.readdirSync(e);test("has fixtures in ".concat(e),(function(){expect(t.length>0).toBe(!0)}));var s=t.filter((function(e){return e.startsWith("only.")}));s.length&&(test.skip.each(t.filter((function(e){return!e.startsWith("only.")})))("matches expected output: %s",(function(){})),t=s),test.each(t)("matches expected output: %s",(function(t){var s,u=i.readFileSync(c.join(e,t),"utf8"),l=o(u,n,t);expect((s={},(0,r.default)(s,a,!0),(0,r.default)(s,"input",u),(0,r.default)(s,"output",l),s)).toMatchSnapshot()}))},FIXTURE_TAG:a}},function(e,n){e.exports=require("@babel/runtime/helpers/defineProperty")},function(e,n,t){"use strict";e.exports=function(e,n,t){if(/^# *expected-to-throw/.test(e)||/\.error\.\w+$/.test(t)){var r;try{r=n(e)}catch(e){return"THROWN EXCEPTION:\n\n".concat(e.toString())}throw new Error("Expected test file '".concat(t,"' to throw, but it passed:\n").concat(r))}return n(e)}},function(e,n){e.exports=require("fs")},function(e,n){e.exports=require("path")},function(e,n,t){"use strict";e.exports={toBeDeeplyFrozen:function(e){return function e(n){if(expect(Object.isFrozen(n)).toBe(!0),Array.isArray(n))n.forEach((function(n){return e(n)}));else if("object"==typeof n&&null!==n)for(var t in n)e(n[t])}(e),{pass:!0}},toWarn:function(e,n){var r=this.isNot;function o(e){return e instanceof RegExp?e.toString():JSON.stringify(e)}function i(e){return"["+e.map(o).join(", ")+"]"}function c(e){return e.length?e.map((function(e){return i([!!e[0]].concat(e.slice(1)))})).join(", "):"[]"}var a=t(15);if(!a.mock)throw new Error("toWarn(): Requires `jest.mock('warning')`.");var s=a.mock.calls.length;e();var u=a.mock.calls.slice(s);return n?(Array.isArray(n)||(n=[n]),{pass:!!u.find((function(e){return e.length===n.length+1&&e.every((function(e,t){if(!t)return!e;var r=n[t-1];return r instanceof RegExp?r.test(e):e===r}))})),message:function(){return"Expected ".concat(r?"not ":"","to warn: ")+"".concat(i([!1].concat(n))," but ")+"`warning` received the following calls: "+"".concat(c(u),".")}}):{pass:!!u.filter((function(e){return!e[0]})).length,message:function(){return"Expected ".concat(r?"not ":"","to warn but ")+"`warning` received the following calls: "+"".concat(c(u),".")}}}}},function(e,n){e.exports=require("fbjs/lib/warning")},function(e,n,t){"use strict";var r=t(0)(t(17));e.exports=function(e){return function e(n,t){switch(typeof n){case"undefined":return"undefined";case"object":if(null===n)return"null";if(Array.isArray(n)){if(0===n.length)return"[]";var o,i="[\n",c=t+"  ",a=(0,r.default)(n);try{for(a.s();!(o=a.n()).done;){var s=o.value;i+=c+e(s,c)+",\n"}}catch(e){a.e(e)}finally{a.f()}return i+=t+"]"}if("string"==typeof n.kind){for(var u="".concat(n.kind," {\n"),l=t+"  ",f=0,p=Object.entries(n);f<p.length;f++){var d=p[f],g=d[0],x=d[1];"kind"!==g&&(u+="".concat(l).concat(g,": ").concat(e(x,l),",\n"))}return u+=t+"}"}if("function"==typeof n.toJSON)return e(n.toJSON(),t);for(var h="{\n",y=t+"  ",v=0,w=Object.entries(n);v<w.length;v++){var b=w[v],m=b[0],W=b[1];h+="".concat(y).concat(JSON.stringify(m),": ").concat(e(W,y),",\n")}return h+=t+"}";case"string":case"number":case"boolean":return JSON.stringify(n,null,2).replace("\n","\n"+t);default:throw new Error("printAST doesn't handle values where "+"typeof value === '".concat(typeof n,"'."))}}(e,"")}},function(e,n){e.exports=require("@babel/runtime/helpers/createForOfIteratorHelper")},function(e,n,t){"use strict";e.exports=function e(n){if(Array.isArray(n))return n.map(e);if(null!=n&&"object"==typeof n){var t={};for(var r in n)t[r]=e(n[r]);return t}return n}},function(e,n,t){"use strict";e.exports=function(e){var n=new Map,t=jest.fn((function(e){var t,r=null!==(t=n.get(e))&&void 0!==t?t:NaN;1===r?n.delete(e):n.set(e,r-1)}));return e.retain=jest.fn((function(e){var r,o=e.request.identifier,i=null!==(r=n.get(o))&&void 0!==r?r:0;n.set(o,i+1);var c=!1;return{dispose:function(){c||t(o),c=!0}}})),{release_DEPRECATED:t,isOperationRetained:function(e){var t,r=e.request.identifier;return(null!==(t=n.get(r))&&void 0!==t?t:0)>0}}}},function(e,n,t){"use strict";var r=(0,t(1).createConsoleInterceptionSystem)("warning","expectToWarn",(function(e){jest.mock("fbjs/lib/warning",(function(){return jest.fn((function(n,t){for(var r=arguments.length,o=new Array(r>2?r-2:0),i=2;i<r;i++)o[i-2]=arguments[i];if(!n){var c=0,a=t.replace(/%s/g,(function(){return String(o[c++])}));e(a)}}))}))}));e.exports={disallowWarnings:function(){r.disallowMessages()},expectWarningWillFire:function(e,n){r.expectMessageWillFire(e,n)},expectToWarn:function(e,n){return r.expectMessage(e,n)},expectToWarnMany:function(e,n){return r.expectMessageMany(e,n)}}},function(e,n){e.exports=require("relay-test-utils")}]);

package/simpleClone.js.flow

@@ -22,7 +22,7 @@ function simpleClone<T>(value: T): T {
     // $FlowFixMe[incompatible-return]
     return value.map(simpleClone);
   } else if (value != null && typeof value === 'object') {
-    const result = {};
+    const result: {[string]: mixed} = {};
     for (const key in value) {
       result[key] = simpleClone(value[key]);
     }

package/trackRetentionForEnvironment.js.flow

@@ -0,0 +1,65 @@
+/**
+ * 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';
+
+/* global jest */
+
+import type {IEnvironment} from '../relay-runtime';
+import type {OperationDescriptor} from '../relay-runtime/store/RelayStoreTypes';
+
+/**
+ * Takes an environment and augments it with a mock implementation of `retain`
+ * that tracks what operations are currently retained. Also returns the Jest mock
+ * `release` function for backwards-compatibility with existing tests, but you
+ * should use `isOperationRetained` for new tests as it is much less error-prone.
+ */
+function trackRetentionForEnvironment(environment: IEnvironment): {|
+  release_DEPRECATED: JestMockFn<[mixed], void>,
+  isOperationRetained: OperationDescriptor => boolean,
+|} {
+  const retainCountsByOperation = new Map();
+
+  const release = jest.fn(id => {
+    const existing = retainCountsByOperation.get(id) ?? NaN;
+    if (existing === 1) {
+      retainCountsByOperation.delete(id);
+    } else {
+      retainCountsByOperation.set(id, existing - 1);
+    }
+  });
+
+  // $FlowFixMe[cannot-write] safe to do for mocking
+  environment.retain = jest.fn(operation => {
+    const id = operation.request.identifier;
+    const existing = retainCountsByOperation.get(id) ?? 0;
+    retainCountsByOperation.set(id, existing + 1);
+    let released = false;
+    return {
+      dispose: () => {
+        if (!released) {
+          release(id);
+        }
+        released = true;
+      },
+    };
+  });
+
+  function isOperationRetained(operation: OperationDescriptor) {
+    const id = operation.request.identifier;
+    return (retainCountsByOperation.get(id) ?? 0) > 0;
+  }
+
+  return {release_DEPRECATED: release, isOperationRetained};
+}
+
+module.exports = trackRetentionForEnvironment;

package/warnings.js.flow

@@ -11,11 +11,27 @@
 
 'use strict';
 
-/* global jest, afterEach */
+/* global jest */
 
-let installed = false;
-const expectedWarnings: Array<string> = [];
-const contextualExpectedWarning: Array<string> = [];
+import type {WillFireOptions} from './consoleErrorsAndWarnings';
+
+const {createConsoleInterceptionSystem} = require('./consoleErrorsAndWarnings');
+
+const warningsSystem = createConsoleInterceptionSystem(
+  'warning',
+  'expectToWarn',
+  impl => {
+    jest.mock('warning', () =>
+      jest.fn((condition, format, ...args) => {
+        if (!condition) {
+          let argIndex = 0;
+          const message = format.replace(/%s/g, () => String(args[argIndex++]));
+          impl(message);
+        }
+      }),
+    );
+  },
+);
 
 /**
  * Mocks the `warning` module to turn warnings into errors. Any expected
@@ -25,64 +41,25 @@ const contextualExpectedWarning: Array<string> = [];
  *       use `jest.resetModules()` or manually mock `warning`.
  */
 function disallowWarnings(): void {
-  if (installed) {
-    throw new Error('`disallowWarnings` should be called at most once');
-  }
-  installed = true;
-  jest.mock('warning', () => {
-    return jest.fn((condition, format, ...args) => {
-      if (!condition) {
-        let argIndex = 0;
-        const message = format.replace(/%s/g, () => String(args[argIndex++]));
-        const index = expectedWarnings.indexOf(message);
-
-        if (
-          contextualExpectedWarning.length > 0 &&
-          contextualExpectedWarning[0] === message
-        ) {
-          contextualExpectedWarning.shift();
-        } else if (index >= 0) {
-          expectedWarnings.splice(index, 1);
-        } else {
-          // log to console in case the error gets swallowed somewhere
-          console.error('Unexpected Warning: ' + message);
-          throw new Error('Warning: ' + message);
-        }
-      }
-    });
-  });
-  afterEach(() => {
-    contextualExpectedWarning.length = 0;
-    if (expectedWarnings.length > 0) {
-      const error = new Error(
-        'Some expected warnings where not triggered:\n\n' +
-          Array.from(expectedWarnings, message => ` * ${message}`).join('\n') +
-          '\n',
-      );
-      expectedWarnings.length = 0;
-      throw error;
-    }
-  });
+  warningsSystem.disallowMessages();
 }
 
 /**
  * Expect a warning with the given message. If the message isn't fired in the
  * current test, the test will fail.
  */
-function expectWarningWillFire(message: string): void {
-  if (!installed) {
-    throw new Error(
-      '`disallowWarnings` needs to be called before `expectWarningWillFire`',
-    );
-  }
-  expectedWarnings.push(message);
+function expectWarningWillFire(
+  message: string,
+  options?: WillFireOptions,
+): void {
+  warningsSystem.expectMessageWillFire(message, options);
 }
 
 /**
  * Expect the callback `fn` to trigger the warning message and otherwise fail.
  */
 function expectToWarn<T>(message: string, fn: () => T): T {
-  return expectToWarnMany([message], fn);
+  return warningsSystem.expectMessage(message, fn);
 }
 
 /**
@@ -90,17 +67,7 @@ function expectToWarn<T>(message: string, fn: () => T): T {
  * or otherwise fail.
  */
 function expectToWarnMany<T>(messages: Array<string>, fn: () => T): T {
-  if (contextualExpectedWarning.length > 0) {
-    throw new Error('Cannot nest `expectToWarn()` calls.');
-  }
-  contextualExpectedWarning.push(...messages);
-  const result = fn();
-  if (contextualExpectedWarning.length > 0) {
-    const notFired = contextualExpectedWarning.toString();
-    contextualExpectedWarning.length = 0;
-    throw new Error(`Expected callback to warn: ${notFired}`);
-  }
-  return result;
+  return warningsSystem.expectMessageMany(messages, fn);
 }
 
 module.exports = {