fix: re-export setVerbosity from ts-invariant

.changeset/rude-rats-do.md

@@ -0,0 +1,6 @@
+---
+"@apollo/client": patch
+---
+
+Export `setVerbosity` from `@apollo/client/dev` so that invariant error messages
+can be silenced with `setVerbosity("silent")`.

docs/source/errors.mdx

@@ -34,3 +34,13 @@ You can call either or both of these methods on application load.
 The `__DEV__` variable isn't available in all environments. As an alternative, you can check whether `process.env.NODE_ENV !== "production"`.
 
 </blockquote>
+
+**You can also silence the error messages completely:**
+
+```js title="App.js"
+import { setVerbosity } from "@apollo/client/dev";
+
+if (!__DEV__) {  // Silence messages when not in a dev environment
+  setVerbosity("silent");
+}
+```

src/__tests__/__snapshots__/exports.ts.snap

@@ -145,6 +145,7 @@ Array [
   "loadDevMessages",
   "loadErrorMessageHandler",
   "loadErrorMessages",
+  "setVerbosity",
 ]
 `;
 

src/dev/index.ts

@@ -1,3 +1,5 @@
+export { setVerbosity } from "ts-invariant";
+
 export { loadDevMessages } from "./loadDevMessages.js";
 export { loadErrorMessageHandler } from "./loadErrorMessageHandler.js";
 export { loadErrorMessages } from "./loadErrorMessages.js";

src/utilities/globals/__tests__/invariantWrappers.test.ts

@@ -1,4 +1,4 @@
-import { loadErrorMessageHandler } from "../../../dev";
+import { loadErrorMessageHandler, setVerbosity } from "../../../dev";
 import { spyOnConsole, withCleanup } from "../../../testing/internal";
 import {
   ApolloErrorMessageHandler,
@@ -27,6 +27,16 @@ function mockErrorMessageHandler() {
   });
 }
 
+function restoreVerbosity() {
+  return withCleanup({}, () => {
+    /**
+     * This is the default verbosity level of "ts-invariant"
+     * @see https://github.com/apollographql/invariant-packages/blob/885d687b654102a8ff1fb5419c94461795909f96/packages/ts-invariant/src/invariant.ts#L34
+     */
+    setVerbosity("log");
+  });
+}
+
 test("base invariant(false, 5, ...), no handlers", () => {
   using _ = disableErrorMessageHandler();
   expect(() => {
@@ -117,3 +127,11 @@ test("base invariant(false, 6, ...), raises fallback", () => {
     )
   );
 });
+
+test("setVerbosity('silent') disables logging to console", () => {
+  using _ = restoreVerbosity();
+  using consoleSpy = spyOnConsole("log");
+  setVerbosity("silent");
+  invariant.log(5, "string", 1, 1.1, { a: 1 });
+  expect(consoleSpy.log).not.toHaveBeenCalled();
+});