@apollo/client 3.11.9 → 3.11.11-rc.0

package/.changeset/early-bobcats-eat.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Prevent field accessor warnings when using `@unmask(mode: "migrate")` on objects that are passed into `cache.identify`.

package/.changeset/flat-beans-knock.md

@@ -0,0 +1,15 @@
+---
+"@apollo/client": patch
+---
+
+Provide a codemod that applies `@unmask` to all named fragments for all operations and fragments. To use the codemod, run the following command:
+
+```
+npx jscodeshift -t node_modules/@apollo/client/scripts/codemods/data-masking/unmask.ts --extensions tsx --parser tsx path/to/app/
+```
+
+To customize the tag used to search for GraphQL operations, use the `--tag` option. By default the codemod looks for `gql` and `graphql` tags.
+
+To apply the directive in migrate mode in order to receive runtime warnings on potentially masked fields, use the `--mode migrate` option.
+
+For more information on the options that can be used with `jscodeshift`, check out the [`jscodeshift` documentation](https://github.com/facebook/jscodeshift).

package/.changeset/kind-toys-tie.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Warn when using data masking with "no-cache" operations.

package/.changeset/nasty-camels-pay.md

@@ -0,0 +1,36 @@
+---
+"@apollo/client": minor
+---
+
+Introduces data masking into Apollo Client. Data masking allows components to access only the data they asked for through GraphQL fragments. This prevents coupling between components that might otherwise implicitly rely on fields not requested by the component. Data masking also provides the benefit that masked fields only rerender components that ask for the field.
+
+To enable data masking in Apollo Client, set the `dataMasking` option to `true`.
+
+```ts
+new ApolloClient({
+  dataMasking: true,
+  // ... other options
+})
+```
+
+You can selectively disable data masking using the `@unmask` directive. Apply this to any named fragment to receive all fields requested by the fragment.
+
+```graphql
+query {
+  user {
+    id
+    ...UserFields @unmask
+  }
+}
+```
+
+To help with migration, use the `@unmask` migrate mode which will add warnings when accessing fields that would otherwise be masked.
+
+```graphql
+query {
+  user {
+    id
+    ...UserFields @unmask(mode: "migrate")
+  }
+}
+```

package/.changeset/nervous-owls-hear.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Fix error when combining `@unmask` and `@defer` directives on a fragment spread when data masking is enabled.

package/.changeset/pre.json

@@ -0,0 +1,14 @@
+{
+  "mode": "pre",
+  "tag": "rc",
+  "initialVersions": {
+    "@apollo/client": "3.11.5"
+  },
+  "changesets": [
+    "early-bobcats-eat",
+    "flat-beans-knock",
+    "kind-toys-tie",
+    "nasty-camels-pay",
+    "nervous-owls-hear"
+  ]
+}

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # @apollo/client
 
+## 3.11.11-rc.0
+
+### Patch Changes
+
+- [#12116](https://github.com/apollographql/apollo-client/pull/12116) [`8ae6e4e`](https://github.com/apollographql/apollo-client/commit/8ae6e4e5cec296c3910fdffb0ce51a0f5f06c5d3) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Prevent field accessor warnings when using `@unmask(mode: "migrate")` on objects that are passed into `cache.identify`.
+
+- [#12120](https://github.com/apollographql/apollo-client/pull/12120) [`6a98e76`](https://github.com/apollographql/apollo-client/commit/6a98e76af5c800a91a748c498611b55c33e02c68) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Provide a codemod that applies `@unmask` to all named fragments for all operations and fragments. To use the codemod, run the following command:
+
+  ```
+  npx jscodeshift -t node_modules/@apollo/client/scripts/codemods/data-masking/unmask.ts --extensions tsx --parser tsx path/to/app/
+  ```
+
+  To customize the tag used to search for GraphQL operations, use the `--tag` option. By default the codemod looks for `gql` and `graphql` tags.
+
+  To apply the directive in migrate mode in order to receive runtime warnings on potentially masked fields, use the `--mode migrate` option.
+
+  For more information on the options that can be used with `jscodeshift`, check out the [`jscodeshift` documentation](https://github.com/facebook/jscodeshift).
+
+- [#12121](https://github.com/apollographql/apollo-client/pull/12121) [`1085a95`](https://github.com/apollographql/apollo-client/commit/1085a95e4430da35d19033613e73f315a0aede9e) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Warn when using data masking with "no-cache" operations.
+
+- [#12114](https://github.com/apollographql/apollo-client/pull/12114) [`1d4ce00`](https://github.com/apollographql/apollo-client/commit/1d4ce0034395147445165022f7d23f42ff638d8a) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix error when combining `@unmask` and `@defer` directives on a fragment spread when data masking is enabled.
+
+## 3.12.0-alpha.0
+
+### Minor Changes
+
+- [#12042](https://github.com/apollographql/apollo-client/pull/12042) [`1c0ecbf`](https://github.com/apollographql/apollo-client/commit/1c0ecbf3c0454056853dd3dcb493dfd5fa1a96b1) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Introduces data masking into Apollo Client. Data masking allows components to access only the data they asked for through GraphQL fragments. This prevents coupling between components that might otherwise implicitly rely on fields not requested by the component. Data masking also provides the benefit that masked fields only rerender components that ask for the field.
+
+  To enable data masking in Apollo Client, set the `dataMasking` option to `true`.
+
+  ```ts
+  new ApolloClient({
+    dataMasking: true,
+    // ... other options
+  });
+  ```
+
+  You can selectively disable data masking using the `@unmask` directive. Apply this to any named fragment to receive all fields requested by the fragment.
+
+  ```graphql
+  query {
+    user {
+      id
+      ...UserFields @unmask
+    }
+  }
+  ```
+
+  To help with migration, use the `@unmask` migrate mode which will add warnings when accessing fields that would otherwise be masked.
+
+  ```graphql
+  query {
+    user {
+      id
+      ...UserFields @unmask(mode: "migrate")
+    }
+  }
+  ```
+
+## 3.11.10
+
+### Patch Changes
+
+- [#12093](https://github.com/apollographql/apollo-client/pull/12093) [`1765668`](https://github.com/apollographql/apollo-client/commit/1765668b7d495ef8a581f697bf9e4b7460455f13) Thanks [@mgmolisani](https://github.com/mgmolisani)! - Fixed a bug when evaluating the devtools flag with the new syntax `devtools.enabled` that could result to `true` when explicitly set to `false`.
+
 ## 3.11.9
 
 ### Patch Changes