relay-test-utils-internal 13.2.0 → 14.0.0

package/consoleError.js.flow

@@ -13,6 +13,8 @@
 
 /* global jest */
 
+import type {WillFireOptions} from './consoleErrorsAndWarnings';
+
 const {createConsoleInterceptionSystem} = require('./consoleErrorsAndWarnings');
 
 const consoleErrorsSystem = createConsoleInterceptionSystem(
@@ -38,8 +40,11 @@ function disallowConsoleErrors(): void {
  * 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): void {
-  consoleErrorsSystem.expectMessageWillFire(message);
+function expectConsoleErrorWillFire(
+  message: string,
+  options?: WillFireOptions,
+): void {
+  consoleErrorsSystem.expectMessageWillFire(message, options);
 }
 
 /**

package/consoleErrorsAndWarnings.js.flow

@@ -11,11 +11,16 @@
 
 'use strict';
 
-/* global jest, afterEach */
+/* global afterEach */
+
+export type WillFireOptions = {
+  count?: number,
+  optional?: boolean,
+};
 
 type API = $ReadOnly<{|
   disallowMessages: () => void,
-  expectMessageWillFire: string => void,
+  expectMessageWillFire: (string, void | WillFireOptions) => void,
   expectMessage: <T>(string, () => T) => T,
   expectMessageMany: <T>(Array<string>, () => T) => T,
 |}>;
@@ -29,6 +34,7 @@ function createConsoleInterceptionSystem(
 ): 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);
@@ -39,13 +45,18 @@ function createConsoleInterceptionSystem(
     const index = expectedMessages.findIndex(expected =>
       message.startsWith(expected),
     );
+    const optionalIndex = optionalMessages.findIndex(expected =>
+      message.startsWith(expected),
+    );
     if (
       contextualExpectedMessage.length > 0 &&
-      contextualExpectedMessage[0] === message
+      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);
@@ -61,10 +72,11 @@ function createConsoleInterceptionSystem(
     setUpMock(handleMessage);
 
     afterEach(() => {
+      optionalMessages.length = 0;
       contextualExpectedMessage.length = 0;
       if (expectedMessages.length > 0) {
         const error = new Error(
-          `Some expected ${typename}s where not triggered:\n\n` +
+          `Some ${expectedMessages.length} expected ${typename}s where not triggered:\n\n` +
             Array.from(expectedMessages, message => ` * ${message}`).join(
               '\n',
             ) +
@@ -76,13 +88,19 @@ function createConsoleInterceptionSystem(
     });
   }
 
-  function expectMessageWillFire(message: string): void {
+  function expectMessageWillFire(
+    message: string,
+    options?: WillFireOptions,
+  ): void {
     if (!installed) {
       throw new Error(
         `${installerName} needs to be called before expect${typenameCapPlural}WillFire`,
       );
     }
-    expectedMessages.push(message);
+    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 {

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.2.0
+ * Relay v14.0.0
  *
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *

package/index.js.flow

@@ -18,6 +18,12 @@ const {
   expectConsoleErrorsMany,
   expectConsoleErrorWillFire,
 } = require('./consoleError');
+const {
+  disallowConsoleWarnings,
+  expectConsoleWarning,
+  expectConsoleWarningsMany,
+  expectConsoleWarningWillFire,
+} = require('./consoleWarning');
 const describeWithFeatureFlags = require('./describeWithFeatureFlags');
 const {
   FIXTURE_TAG,
@@ -26,6 +32,7 @@ const {
 const Matchers = require('./Matchers');
 const printAST = require('./printAST');
 const simpleClone = require('./simpleClone');
+const trackRetentionForEnvironment = require('./trackRetentionForEnvironment');
 const {
   disallowWarnings,
   expectToWarn,
@@ -57,10 +64,14 @@ module.exports = {
   createMockEnvironment,
   describeWithFeatureFlags,
   disallowConsoleErrors,
+  disallowConsoleWarnings,
   disallowWarnings,
   expectConsoleError,
   expectConsoleErrorsMany,
   expectConsoleErrorWillFire,
+  expectConsoleWarningWillFire,
+  expectConsoleWarning,
+  expectConsoleWarningsMany,
   expectToWarn,
   expectToWarnMany,
   expectWarningWillFire,
@@ -69,5 +80,6 @@ module.exports = {
   matchers: Matchers,
   printAST,
   simpleClone,
+  trackRetentionForEnvironment,
   unwrapContainer,
 };

package/lib/consoleError.js

@@ -34,8 +34,8 @@ function disallowConsoleErrors() {
  */
 
 
-function expectConsoleErrorWillFire(message) {
-  consoleErrorsSystem.expectMessageWillFire(message);
+function expectConsoleErrorWillFire(message, options) {
+  consoleErrorsSystem.expectMessageWillFire(message, options);
 }
 /**
  * Expect the callback `fn` to print an error with the message, and otherwise fail.

package/lib/consoleErrorsAndWarnings.js

@@ -9,7 +9,7 @@
  * @format
  */
 'use strict';
-/* global jest, afterEach */
+/* global afterEach */
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
@@ -20,6 +20,7 @@ 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';
@@ -29,11 +30,16 @@ function createConsoleInterceptionSystem(typename, expectFunctionName, setUpMock
     var index = expectedMessages.findIndex(function (expected) {
       return message.startsWith(expected);
     });
+    var optionalIndex = optionalMessages.findIndex(function (expected) {
+      return message.startsWith(expected);
+    });
 
-    if (contextualExpectedMessage.length > 0 && contextualExpectedMessage[0] === message) {
+    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);
@@ -49,10 +55,11 @@ function createConsoleInterceptionSystem(typename, expectFunctionName, setUpMock
     installed = true;
     setUpMock(handleMessage);
     afterEach(function () {
+      optionalMessages.length = 0;
       contextualExpectedMessage.length = 0;
 
       if (expectedMessages.length > 0) {
-        var error = new Error("Some expected ".concat(typename, "s where not triggered:\n\n") + Array.from(expectedMessages, function (message) {
+        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;
@@ -61,12 +68,18 @@ function createConsoleInterceptionSystem(typename, expectFunctionName, setUpMock
     });
   }
 
-  function expectMessageWillFire(message) {
+  function expectMessageWillFire(message, options) {
     if (!installed) {
       throw new Error("".concat(installerName, " needs to be called before expect").concat(typenameCapPlural, "WillFire"));
     }
 
-    expectedMessages.push(message);
+    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) {

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

@@ -16,11 +16,17 @@ var _require = require('./consoleError'),
     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 _require2 = require('./generateTestsFromFixtures'),
-    FIXTURE_TAG = _require2.FIXTURE_TAG,
-    generateTestsFromFixtures = _require2.generateTestsFromFixtures;
+var _require3 = require('./generateTestsFromFixtures'),
+    FIXTURE_TAG = _require3.FIXTURE_TAG,
+    generateTestsFromFixtures = _require3.generateTestsFromFixtures;
 
 var Matchers = require('./Matchers');
 
@@ -28,15 +34,17 @@ var printAST = require('./printAST');
 
 var simpleClone = require('./simpleClone');
 
-var _require3 = require('./warnings'),
-    disallowWarnings = _require3.disallowWarnings,
-    expectToWarn = _require3.expectToWarn,
-    expectToWarnMany = _require3.expectToWarnMany,
-    expectWarningWillFire = _require3.expectWarningWillFire;
+var trackRetentionForEnvironment = require('./trackRetentionForEnvironment');
+
+var _require4 = require('./warnings'),
+    disallowWarnings = _require4.disallowWarnings,
+    expectToWarn = _require4.expectToWarn,
+    expectToWarnMany = _require4.expectToWarnMany,
+    expectWarningWillFire = _require4.expectWarningWillFire;
 
-var _require4 = require('relay-test-utils'),
-    createMockEnvironment = _require4.createMockEnvironment,
-    unwrapContainer = _require4.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
@@ -60,10 +68,14 @@ module.exports = {
   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,
@@ -72,5 +84,6 @@ module.exports = {
   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

@@ -48,8 +48,8 @@ function disallowWarnings() {
  */
 
 
-function expectWarningWillFire(message) {
-  warningsSystem.expectMessageWillFire(message);
+function expectWarningWillFire(message, options) {
+  warningsSystem.expectMessageWillFire(message, options);
 }
 /**
  * Expect the callback `fn` to trigger the warning message and otherwise fail.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "relay-test-utils-internal",
   "description": "Internal utilities for testing Relay.",
-  "version": "13.2.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.2.0"
+    "relay-runtime": "14.0.0"
   },
   "directories": {
     "": "./"

package/relay-test-utils-internal.js

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

@@ -13,6 +13,8 @@
 
 /* global jest */
 
+import type {WillFireOptions} from './consoleErrorsAndWarnings';
+
 const {createConsoleInterceptionSystem} = require('./consoleErrorsAndWarnings');
 
 const warningsSystem = createConsoleInterceptionSystem(
@@ -46,8 +48,11 @@ function disallowWarnings(): void {
  * 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 {
-  warningsSystem.expectMessageWillFire(message);
+function expectWarningWillFire(
+  message: string,
+  options?: WillFireOptions,
+): void {
+  warningsSystem.expectMessageWillFire(message, options);
 }
 
 /**