@apollo/client 4.0.0-alpha.7 → 4.0.0-alpha.9

package/.changeset/afraid-moons-arrive.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Allow mocked responses passed to `MockLink` to accept a callback for the `delay` option. The `delay` callback will be given the current operation which can be used to determine what delay should be used for the mock.

package/.changeset/beige-mirrors-talk.md

@@ -0,0 +1,15 @@
+---
+"@apollo/client": major
+---
+
+`onError` link now uses a single `error` property to report the error that caused the link callback to be called. This will be an instance of `CombinedGraphQLErrors` in the event GraphQL errors were emitted from the terminating link, `CombinedProtocolErrors` if the terminating link emitted protocol errors, or the unwrapped error type if any other non-GraphQL error was thrown or emitted.
+
+```diff
+- const errorLink = onError(({ graphQLErrors, networkError, protocolErrors }) => {
+-   graphQLErrors.forEach(error => console.log(error.message));
++ const errorLink = onError(({ error }) => {
++   if (error.name === 'CombinedGraphQLErrors') {
++     error.errors.forEach(rawError => console.log(rawError.message));
++   }
+});
+```

package/.changeset/early-eggs-develop.md

@@ -0,0 +1,22 @@
+---
+"@apollo/client": minor
+---
+
+Introduce a new `realisticDelay` helper function for use with the `delay` callback for mocked responses used with `MockLink`. `realisticDelay` will generate a random value between 20 and 50ms to provide an experience closer to unpredictable network latency. `realisticDelay` can be configured with a `min` and `max` to set different thresholds if the defaults are not sufficient.
+
+```ts
+import { realisticDelay } from '@apollo/client/testing';
+
+new MockLink([
+  {
+    request: { query },
+    result: { data: { greeting: 'Hello' }},
+    delay: realisticDelay()
+  },
+  {
+    request: { query },
+    result: { data: { greeting: 'Hello' }},
+    delay: realisticDelay({ min: 10, max: 100 })
+  },
+]);
+```

package/.changeset/forty-tomatoes-punch.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+The returned `networkStatus` in `useLazyQuery` is now set to `setVariables` when calling the `useLazyQuery` `execute` function for the first time with variables.

package/.changeset/fuzzy-tips-sit.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Ensure `ObservableQuery` stops polling if switching to a `standby` `fetchPolicy`. When switching back to a non-`standby` `fetchPolicy`, polling will resume.

package/.changeset/giant-apes-thank.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": major
+---
+
+Remove the `onError` and `setOnError` methods from `ApolloLink`. `onError` was only used by `MockLink` to rewrite errors if `setOnError` was used.

package/.changeset/khaki-keys-deliver.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": major
+---
+
+An initial loading state is now emitted from `ObservableQuery` when subscribing if `notifyOnNetworkStatusChange` is set to `true`.

package/.changeset/large-plants-know.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Ensure a loading state is emitted when calling the `execute` function after changing clients in `useLazyQuery`.

package/.changeset/mean-lizards-think.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Ensure `useLazyQuery` does not return a `partial` property which is not specified by the result type.

package/.changeset/ninety-bags-bake.md

@@ -0,0 +1,17 @@
+---
+"@apollo/client": major
+---
+
+Mocked responses passed to `MockLink` now accept a callback for the `request.variables` option. This is used to determine if the mock should be matched for a set of request variables. With this change, the `variableMatcher` option has been removed in favor of passing a callback to `variables`. Update by moving the callback function from `variableMatcher` to `request.variables`.
+
+```diff
+new MockLink([
+  {
+    request: {
+      query,
++     variables: (requestVariables) => true
+    },
+-   variableMatcher: (requestVariables) => true
+  }
+]);
+```

package/.changeset/perfect-vans-give.md

@@ -0,0 +1,7 @@
+---
+"@apollo/client": major
+---
+
+The `@apollo/client` and `@apollo/client/core` entry points are now equal.
+In the next major, the `@apollo/client/core` entry point will be removed.
+Please change imports over from `@apollo/client/core` to `@apollo/client`.

package/.changeset/pre.json

@@ -5,6 +5,8 @@
     "@apollo/client": "3.12.2"
   },
   "changesets": [
+    "afraid-moons-arrive",
+    "beige-mirrors-talk",
     "brave-radios-wait",
     "bright-ads-share",
     "calm-frogs-remain",
@@ -17,15 +19,19 @@
     "curvy-pianos-count",
     "dirty-eagles-poke",
     "dirty-trees-pump",
+    "early-eggs-develop",
     "eighty-squids-fix",
     "eleven-kangaroos-jump",
     "empty-rabbits-move",
     "fluffy-shoes-applaud",
     "forty-hairs-occur",
     "forty-shrimps-fry",
+    "forty-tomatoes-punch",
     "four-ghosts-watch",
     "fresh-moose-hope",
     "funny-jeans-invent",
+    "fuzzy-tips-sit",
+    "giant-apes-thank",
     "giant-bags-share",
     "good-dolphins-peel",
     "gorgeous-chefs-tap",
@@ -35,8 +41,10 @@
     "hot-cycles-notice",
     "itchy-drinks-refuse",
     "itchy-roses-accept",
+    "khaki-keys-deliver",
     "khaki-spies-work",
     "kind-fishes-develop",
+    "large-plants-know",
     "late-trainers-peel",
     "light-apes-rescue",
     "light-dolphins-taste",
@@ -46,6 +54,7 @@
     "lucky-hats-push",
     "many-buses-allow",
     "many-papayas-hide",
+    "mean-lizards-think",
     "metal-needles-search",
     "mighty-penguins-wink",
     "modern-feet-do",
@@ -55,7 +64,9 @@
     "nice-donkeys-reflect",
     "nice-dots-matter",
     "nice-waves-work",
+    "ninety-bags-bake",
     "odd-lemons-relax",
+    "perfect-vans-give",
     "polite-bees-care",
     "poor-eels-punch",
     "popular-games-sleep",
@@ -68,8 +79,10 @@
     "rich-kids-carry",
     "rude-fans-study",
     "seven-foxes-melt",
+    "shaggy-pugs-add",
     "shiny-carrots-invent",
     "short-jokes-jam",
+    "short-months-complain",
     "silly-knives-exist",
     "slimy-chicken-melt",
     "slimy-maps-press",
@@ -83,12 +96,14 @@
     "soft-mails-clean",
     "sour-pillows-guess",
     "strange-seahorses-impress",
+    "swift-rivers-share",
     "tall-bikes-develop",
     "tall-cups-suffer",
     "tame-doors-shop",
     "tame-points-work",
     "tender-swans-flash",
     "thick-books-grin",
+    "thin-peas-hear",
     "tidy-squids-poke",
     "tough-rockets-allow",
     "tough-taxis-smoke",
@@ -98,6 +113,7 @@
     "unlucky-kiwis-sell",
     "unlucky-sheep-change",
     "warm-ties-sit",
+    "wicked-forks-double",
     "yellow-cats-judge",
     "young-phones-fold",
     "young-turtles-explode"

package/.changeset/shaggy-pugs-add.md

@@ -0,0 +1,52 @@
+---
+"@apollo/client": minor
+---
+
+Add ability to specify a default `delay` for all mocked responses passed to `MockLink`. This `delay` can be configured globally (all instances of `MockLink` will use the global defaults), or per-instance (all mocks in a single instance will use the defaults). A `delay` defined on a single mock will supercede all default delays. Per-instance defaults supercede global defaults.
+
+**Global defaults**
+
+```ts
+MockLink.defaultOptions = {
+  // Use a default delay of 20ms for all mocks in all instances without a specified delay
+  delay: 20,
+
+  // altenatively use a callback which will be executed for each mock
+  delay: () => getRandomNumber(),
+
+  // or use the built-in `realisticDelay`. This is the default
+  delay: realisticDelay(),
+}
+```
+
+**Per-instance defaults**
+
+```ts
+new MockLink(
+  [
+    // Use the default delay
+    {
+      request: { query },
+      result: { data: { greeting: 'Hello' }},
+    },
+    {
+      request: { query },
+      result: { data: { greeting: 'Hello' }},
+      // Override the default for this mock
+      delay: 10
+    },
+  ],
+  {
+    defaultOptions: {
+      // Use a default delay of 20ms for all mocks without a specified delay
+      delay: 20,
+
+      // altenatively use a callback which will be executed for each mock
+      delay: () => getRandomNumber(),
+
+      // or use the built-in `realisticDelay`. This is the default
+      delay: realisticDelay(),
+    }
+  }
+);
+```

package/.changeset/short-months-complain.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": major
+---
+
+Throw an error when a client-only query is used in a mocked response passed to `MockLink`.

package/.changeset/swift-rivers-share.md

@@ -0,0 +1,13 @@
+---
+"@apollo/client": major
+---
+
+Default the `delay` for all mocked responses passed to `MockLink` using `realisticDelay`. This ensures your test handles loading states by default and is not reliant on a specific timing.
+
+If you would like to restore the old behavior, use a global default delay of `0`.
+
+```ts
+MockLink.defaultOptions = {
+  delay: 0
+}
+```

package/.changeset/thin-peas-hear.md

@@ -0,0 +1,16 @@
+---
+"@apollo/client": major
+---
+
+`notifyOnNetworkStatusChange` now defaults to `true`. This means that loading states will be emitted (core API) or rendered (React) by default when calling `refetch`, `fetchMore`, etc. To maintain the old behavior, set `notifyOnNetworkStatusChange` to `false` in `defaultOptions`.
+
+```ts
+new ApolloClient({
+  defaultOptions: {
+    watchQuery: {
+      // Use the v3 default
+      notifyOnNetworkStatusChange: false
+    }
+  }
+})
+```

package/.changeset/wicked-forks-double.md

@@ -0,0 +1,33 @@
+---
+"@apollo/client": major
+---
+
+Remove `newData` option for mocked responses passed to `MockLink` or the `mocks` option on `MockedProvider`. This option was undocumented and was nearly identical to using the `result` option as a callback.
+
+To replicate the old behavior of `newData`, use `result` as a callback and add the `maxUsageCount` option with a value set to `Number.POSITIVE_INFINITY`.
+
+**with `MockLink`**
+```diff
+new MockLink([
+  {
+    request: { query, variables },
+-   newData: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
++   result: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
++   maxUsageCount: Number.POSITIVE_INFINITY,
+  }
+])
+```
+
+**with `MockedProvider`**
+```diff
+<MockedProvider
+  mocks={[
+    {
+      request: { query, variables },
+-     newData: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
++     result: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
++     maxUsageCount: Number.POSITIVE_INFINITY,
+    }
+  ]}
+/>
+```

package/CHANGELOG.md

@@ -1,5 +1,186 @@
 # @apollo/client
 
+## 4.0.0-alpha.9
+
+### Major Changes
+
+- [#12536](https://github.com/apollographql/apollo-client/pull/12536) [`e14205a`](https://github.com/apollographql/apollo-client/commit/e14205ad5909f95aa04684acd0ca2f25956ee50c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - An initial loading state is now emitted from `ObservableQuery` when subscribing if `notifyOnNetworkStatusChange` is set to `true`.
+
+- [#12512](https://github.com/apollographql/apollo-client/pull/12512) [`e809b71`](https://github.com/apollographql/apollo-client/commit/e809b71aa9a02917a286afdbb03d5be8e5947c53) Thanks [@jerelmiller](https://github.com/jerelmiller)! - `notifyOnNetworkStatusChange` now defaults to `true`. This means that loading states will be emitted (core API) or rendered (React) by default when calling `refetch`, `fetchMore`, etc. To maintain the old behavior, set `notifyOnNetworkStatusChange` to `false` in `defaultOptions`.
+
+  ```ts
+  new ApolloClient({
+    defaultOptions: {
+      watchQuery: {
+        // Use the v3 default
+        notifyOnNetworkStatusChange: false,
+      },
+    },
+  });
+  ```
+
+### Patch Changes
+
+- [#12536](https://github.com/apollographql/apollo-client/pull/12536) [`e14205a`](https://github.com/apollographql/apollo-client/commit/e14205ad5909f95aa04684acd0ca2f25956ee50c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - The returned `networkStatus` in `useLazyQuery` is now set to `setVariables` when calling the `useLazyQuery` `execute` function for the first time with variables.
+
+- [#12536](https://github.com/apollographql/apollo-client/pull/12536) [`e14205a`](https://github.com/apollographql/apollo-client/commit/e14205ad5909f95aa04684acd0ca2f25956ee50c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Ensure `ObservableQuery` stops polling if switching to a `standby` `fetchPolicy`. When switching back to a non-`standby` `fetchPolicy`, polling will resume.
+
+- [#12536](https://github.com/apollographql/apollo-client/pull/12536) [`e14205a`](https://github.com/apollographql/apollo-client/commit/e14205ad5909f95aa04684acd0ca2f25956ee50c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Ensure a loading state is emitted when calling the `execute` function after changing clients in `useLazyQuery`.
+
+- [#12542](https://github.com/apollographql/apollo-client/pull/12542) [`afb4fce`](https://github.com/apollographql/apollo-client/commit/afb4fce08859b2c6eebf288230a7c35b7acf2da6) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Ensure `useLazyQuery` does not return a `partial` property which is not specified by the result type.
+
+## 4.0.0-alpha.8
+
+### Major Changes
+
+- [#12539](https://github.com/apollographql/apollo-client/pull/12539) [`dd0d6d6`](https://github.com/apollographql/apollo-client/commit/dd0d6d6d96d8b810e30dc2fdee2ac8a2477d0017) Thanks [@jerelmiller](https://github.com/jerelmiller)! - `onError` link now uses a single `error` property to report the error that caused the link callback to be called. This will be an instance of `CombinedGraphQLErrors` in the event GraphQL errors were emitted from the terminating link, `CombinedProtocolErrors` if the terminating link emitted protocol errors, or the unwrapped error type if any other non-GraphQL error was thrown or emitted.
+
+  ```diff
+  - const errorLink = onError(({ graphQLErrors, networkError, protocolErrors }) => {
+  -   graphQLErrors.forEach(error => console.log(error.message));
+  + const errorLink = onError(({ error }) => {
+  +   if (error.name === 'CombinedGraphQLErrors') {
+  +     error.errors.forEach(rawError => console.log(rawError.message));
+  +   }
+  });
+  ```
+
+- [#12533](https://github.com/apollographql/apollo-client/pull/12533) [`73221d8`](https://github.com/apollographql/apollo-client/commit/73221d87bd5640986f86fe3ee50c63ed49834cbb) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Remove the `onError` and `setOnError` methods from `ApolloLink`. `onError` was only used by `MockLink` to rewrite errors if `setOnError` was used.
+
+- [#12531](https://github.com/apollographql/apollo-client/pull/12531) [`7784b46`](https://github.com/apollographql/apollo-client/commit/7784b46117a4f91a270a020ed1a24f042cb9ee17) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Mocked responses passed to `MockLink` now accept a callback for the `request.variables` option. This is used to determine if the mock should be matched for a set of request variables. With this change, the `variableMatcher` option has been removed in favor of passing a callback to `variables`. Update by moving the callback function from `variableMatcher` to `request.variables`.
+
+  ```diff
+  new MockLink([
+    {
+      request: {
+        query,
+  +     variables: (requestVariables) => true
+      },
+  -   variableMatcher: (requestVariables) => true
+    }
+  ]);
+  ```
+
+- [#12526](https://github.com/apollographql/apollo-client/pull/12526) [`391af1d`](https://github.com/apollographql/apollo-client/commit/391af1dd733219b7e1e14cfff9d5e3ce3967242f) Thanks [@phryneas](https://github.com/phryneas)! - The `@apollo/client` and `@apollo/client/core` entry points are now equal.
+  In the next major, the `@apollo/client/core` entry point will be removed.
+  Please change imports over from `@apollo/client/core` to `@apollo/client`.
+
+- [#12525](https://github.com/apollographql/apollo-client/pull/12525) [`8785186`](https://github.com/apollographql/apollo-client/commit/87851863b94eebbc208671b17aeca73748ac41f6) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Throw an error when a client-only query is used in a mocked response passed to `MockLink`.
+
+- [#12532](https://github.com/apollographql/apollo-client/pull/12532) [`ae0dcad`](https://github.com/apollographql/apollo-client/commit/ae0dcad89924e6b8090ca3182df30e528589b562) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Default the `delay` for all mocked responses passed to `MockLink` using `realisticDelay`. This ensures your test handles loading states by default and is not reliant on a specific timing.
+
+  If you would like to restore the old behavior, use a global default delay of `0`.
+
+  ```ts
+  MockLink.defaultOptions = {
+    delay: 0,
+  };
+  ```
+
+- [#12530](https://github.com/apollographql/apollo-client/pull/12530) [`2973e2a`](https://github.com/apollographql/apollo-client/commit/2973e2a6e6fd81fa59b769d84c252c98ca69440d) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Remove `newData` option for mocked responses passed to `MockLink` or the `mocks` option on `MockedProvider`. This option was undocumented and was nearly identical to using the `result` option as a callback.
+
+  To replicate the old behavior of `newData`, use `result` as a callback and add the `maxUsageCount` option with a value set to `Number.POSITIVE_INFINITY`.
+
+  **with `MockLink`**
+
+  ```diff
+  new MockLink([
+    {
+      request: { query, variables },
+  -   newData: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
+  +   result: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
+  +   maxUsageCount: Number.POSITIVE_INFINITY,
+    }
+  ])
+  ```
+
+  **with `MockedProvider`**
+
+  ```diff
+  <MockedProvider
+    mocks={[
+      {
+        request: { query, variables },
+  -     newData: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
+  +     result: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
+  +     maxUsageCount: Number.POSITIVE_INFINITY,
+      }
+    ]}
+  />
+  ```
+
+### Minor Changes
+
+- [#12532](https://github.com/apollographql/apollo-client/pull/12532) [`ae0dcad`](https://github.com/apollographql/apollo-client/commit/ae0dcad89924e6b8090ca3182df30e528589b562) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Allow mocked responses passed to `MockLink` to accept a callback for the `delay` option. The `delay` callback will be given the current operation which can be used to determine what delay should be used for the mock.
+
+- [#12532](https://github.com/apollographql/apollo-client/pull/12532) [`ae0dcad`](https://github.com/apollographql/apollo-client/commit/ae0dcad89924e6b8090ca3182df30e528589b562) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Introduce a new `realisticDelay` helper function for use with the `delay` callback for mocked responses used with `MockLink`. `realisticDelay` will generate a random value between 20 and 50ms to provide an experience closer to unpredictable network latency. `realisticDelay` can be configured with a `min` and `max` to set different thresholds if the defaults are not sufficient.
+
+  ```ts
+  import { realisticDelay } from "@apollo/client/testing";
+
+  new MockLink([
+    {
+      request: { query },
+      result: { data: { greeting: "Hello" } },
+      delay: realisticDelay(),
+    },
+    {
+      request: { query },
+      result: { data: { greeting: "Hello" } },
+      delay: realisticDelay({ min: 10, max: 100 }),
+    },
+  ]);
+  ```
+
+- [#12532](https://github.com/apollographql/apollo-client/pull/12532) [`ae0dcad`](https://github.com/apollographql/apollo-client/commit/ae0dcad89924e6b8090ca3182df30e528589b562) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Add ability to specify a default `delay` for all mocked responses passed to `MockLink`. This `delay` can be configured globally (all instances of `MockLink` will use the global defaults), or per-instance (all mocks in a single instance will use the defaults). A `delay` defined on a single mock will supercede all default delays. Per-instance defaults supercede global defaults.
+
+  **Global defaults**
+
+  ```ts
+  MockLink.defaultOptions = {
+    // Use a default delay of 20ms for all mocks in all instances without a specified delay
+    delay: 20,
+
+    // altenatively use a callback which will be executed for each mock
+    delay: () => getRandomNumber(),
+
+    // or use the built-in `realisticDelay`. This is the default
+    delay: realisticDelay(),
+  };
+  ```
+
+  **Per-instance defaults**
+
+  ```ts
+  new MockLink(
+    [
+      // Use the default delay
+      {
+        request: { query },
+        result: { data: { greeting: "Hello" } },
+      },
+      {
+        request: { query },
+        result: { data: { greeting: "Hello" } },
+        // Override the default for this mock
+        delay: 10,
+      },
+    ],
+    {
+      defaultOptions: {
+        // Use a default delay of 20ms for all mocks without a specified delay
+        delay: 20,
+
+        // altenatively use a callback which will be executed for each mock
+        delay: () => getRandomNumber(),
+
+        // or use the built-in `realisticDelay`. This is the default
+        delay: realisticDelay(),
+      },
+    }
+  );
+  ```
+
 ## 4.0.0-alpha.7
 
 ### Major Changes
@@ -607,6 +788,20 @@
 
 - [#12384](https://github.com/apollographql/apollo-client/pull/12384) [`6aa6fd3`](https://github.com/apollographql/apollo-client/commit/6aa6fd316cfdb31ebbe3e3133cca2965604e7ca1) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Don't emit a partial cache result from `cache-only` queries when `returnPartialData` is `false`.
 
+## 3.13.7
+
+### Patch Changes
+
+- [#12540](https://github.com/apollographql/apollo-client/pull/12540) [`0098932`](https://github.com/apollographql/apollo-client/commit/009893220934081f6e5733bff5863c768a597117) Thanks [@phryneas](https://github.com/phryneas)! - Refactor: Move notification scheduling logic from `QueryInfo` to `ObservableQuery`
+
+- [#12540](https://github.com/apollographql/apollo-client/pull/12540) [`0098932`](https://github.com/apollographql/apollo-client/commit/009893220934081f6e5733bff5863c768a597117) Thanks [@phryneas](https://github.com/phryneas)! - Refactored cache emit logic for ObservableQuery. This should be an invisible change.
+
+## 3.13.6
+
+### Patch Changes
+
+- [#12285](https://github.com/apollographql/apollo-client/pull/12285) [`cdc55ff`](https://github.com/apollographql/apollo-client/commit/cdc55ff54bf4c83ec8571508ec4bf8156af1bc97) Thanks [@phryneas](https://github.com/phryneas)! - keep ObservableQuery created by useQuery non-active before it is first subscribed
+
 ## 3.13.5
 
 ### Patch Changes

package/__cjs/cache/core/cache.cjs

@@ -94,7 +94,7 @@ class ApolloCache {
         if (environment_1.__DEV__) {
             const actualFragmentName = fragmentName || (0, utilities_1.getFragmentDefinition)(fragment).name.value;
             if (!id) {
-                __DEV__ && invariant_1.invariant.warn(92, actualFragmentName);
+                __DEV__ && invariant_1.invariant.warn(94, actualFragmentName);
             }
         }
         const diffOptions = {