@apollo/client 3.12.0-rc.3 → 3.12.0

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # @apollo/client
 
+## 3.12.0
+
+### Minor Changes
+
+#### Data masking 🎭
+
+- [#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 in Apollo Client.
+
+  Data masking enforces that only the fields requested by the query or fragment is available to that component. Data masking is best paired with [colocated fragments](https://www.apollographql.com/docs/react/data/fragments#colocating-fragments).
+
+  To enable data masking in Apollo Client, set the `dataMasking` option to `true`.
+
+  ```ts
+  new ApolloClient({
+    dataMasking: true,
+    // ... other options
+  });
+  ```
+
+  For detailed information on data masking, including how to incrementally adopt it in an existing applications, see the [data masking documentation](https://www.apollographql.com/docs/react/data/fragments#data-masking).
+
+- [#12131](https://github.com/apollographql/apollo-client/pull/12131) [`21c3f08`](https://github.com/apollographql/apollo-client/commit/21c3f083013445707b7b50ae6390318bc568d0f5) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Allow `null` as a valid `from` value in `useFragment`.
+
+<details open>
+  <summary><h3>More Patch Changes</h3></summary>
+
+- [#12126](https://github.com/apollographql/apollo-client/pull/12126) [`d10d702`](https://github.com/apollographql/apollo-client/commit/d10d702ee9bd4d1d1dee2551821140f2c49d5c0c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Maintain the existing document if its unchanged by the codemod and move to more naive whitespace formatting
+
+- [#12150](https://github.com/apollographql/apollo-client/pull/12150) [`9ed1e1e`](https://github.com/apollographql/apollo-client/commit/9ed1e1ef02b28445614fed4f5c141a289ac32d66) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix issue when using `Unmasked` with older versions of TypeScript when used with array fields.
+
+- [#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.
+
+  Learn how to use the codemod in the [incremental adoption documentation](https://www.apollographql.com/docs/react/data/fragments#incremental-adoption-in-an-existing-application).
+
+- [#12134](https://github.com/apollographql/apollo-client/pull/12134) [`cfaf4ef`](https://github.com/apollographql/apollo-client/commit/cfaf4efc6dea56ae46a5b5199d8ed9414b0f17d8) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix issue where data went missing when an unmasked fragment in migrate mode selected fields that the parent did not.
+
+- [#12154](https://github.com/apollographql/apollo-client/pull/12154) [`d933def`](https://github.com/apollographql/apollo-client/commit/d933def986d476cd64321059299ab15031297f04) Thanks [@phryneas](https://github.com/phryneas)! - Data masking types: handle overlapping nested array types and fragments on interface types.
+
+- [#12139](https://github.com/apollographql/apollo-client/pull/12139) [`5a53e15`](https://github.com/apollographql/apollo-client/commit/5a53e15e713e5eb2ebc9216615ea1a845fad2685) Thanks [@phryneas](https://github.com/phryneas)! - Fix issue where masked data would sometimes get returned when the field was part of a child fragment from a fragment unmasked by the parent query.
+
+- [#12123](https://github.com/apollographql/apollo-client/pull/12123) [`8422a30`](https://github.com/apollographql/apollo-client/commit/8422a305eff861fc8f953731e92c860f555bd99a) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Warn when using data masking with "no-cache" operations.
+
+- [#12139](https://github.com/apollographql/apollo-client/pull/12139) [`5a53e15`](https://github.com/apollographql/apollo-client/commit/5a53e15e713e5eb2ebc9216615ea1a845fad2685) Thanks [@phryneas](https://github.com/phryneas)! - Fix issue where the warning emitted by `@unmask(mode: "migrate")` would trigger unnecessarily when the fragment was used alongside a masked fragment inside an inline fragment.
+
+- [#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.
+
+- [#12130](https://github.com/apollographql/apollo-client/pull/12130) [`1e7d009`](https://github.com/apollographql/apollo-client/commit/1e7d009e4a52949dab0065f3219dfe148837531e) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix error thrown when applying unmask migrate mode warnings on interface types with selection sets that contain inline fragment conditions.
+
+- [#12152](https://github.com/apollographql/apollo-client/pull/12152) [`78137ec`](https://github.com/apollographql/apollo-client/commit/78137eccba90b80dd29bd8e1423b49ebe51ef8df) Thanks [@phryneas](https://github.com/phryneas)! - Add a helper that will skip the TS unmasking alorithm when no fragments are present on type level
+
+- [#12126](https://github.com/apollographql/apollo-client/pull/12126) [`d10d702`](https://github.com/apollographql/apollo-client/commit/d10d702ee9bd4d1d1dee2551821140f2c49d5c0c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Ensure documents unchanged by the codemod are left untouched.
+
+- [#12133](https://github.com/apollographql/apollo-client/pull/12133) [`a6ece37`](https://github.com/apollographql/apollo-client/commit/a6ece375119ce12c19749471c55b0059843a7217) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Ensure `null` is retained in nullable types when unmasking a type with the `Unmasked` helper type.
+
+- [#12139](https://github.com/apollographql/apollo-client/pull/12139) [`5a53e15`](https://github.com/apollographql/apollo-client/commit/5a53e15e713e5eb2ebc9216615ea1a845fad2685) Thanks [@phryneas](https://github.com/phryneas)! - Fix issue that threw errors when masking partial data with `@unmask(mode: "migrate")`.
+
+</details>
+
+## 3.12.0-rc.4
+
+### Patch Changes
+
+- [#12154](https://github.com/apollographql/apollo-client/pull/12154) [`d933def`](https://github.com/apollographql/apollo-client/commit/d933def986d476cd64321059299ab15031297f04) Thanks [@phryneas](https://github.com/phryneas)! - Data masking types: handle overlapping nested array types and fragments on interface types.
+
 ## 3.12.0-rc.3
 
 ### Patch Changes

package/README.md

@@ -18,6 +18,8 @@ Join 1000+ engineers at GraphQL Summit for talks, workshops, and office hours, O
 
 Apollo Client is a fully-featured caching GraphQL client with integrations for React, Angular, and more. It allows you to easily build UI components that fetch data via GraphQL.
 
+Apollo Client aims to comply with the [Working Draft of the GraphQL specification](https://spec.graphql.org/draft/).
+
 | ☑️  Apollo Client User Survey |
 | :----- |
 | What do you like best about Apollo Client? What needs to be improved? Please tell us by taking a [one-minute survey](https://docs.google.com/forms/d/e/1FAIpQLSczNDXfJne3ZUOXjk9Ursm9JYvhTh1_nFTDfdq3XBAFWCzplQ/viewform?usp=pp_url&entry.1170701325=Apollo+Client&entry.204965213=Readme). Your responses will help us understand Apollo Client usage and allow us to serve you better. |

package/apollo-client.cjs

@@ -31,7 +31,7 @@ function _interopNamespace(e) {
 var equal__default = /*#__PURE__*/_interopDefaultLegacy(equal);
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
-var version = "3.12.0-rc.3";
+var version = "3.12.0";
 
 function maybe(thunk) {
     try {
@@ -1615,7 +1615,7 @@ function toPromise(observable) {
         observable.subscribe({
             next: function (data) {
                 if (completed) {
-                    globalThis.__DEV__ !== false && invariant.warn(51);
+                    globalThis.__DEV__ !== false && invariant.warn(45);
                 }
                 else {
                     completed = true;
@@ -1658,7 +1658,7 @@ function validateOperation(operation) {
     for (var _i = 0, _a = Object.keys(operation); _i < _a.length; _i++) {
         var key = _a[_i];
         if (OPERATION_FIELDS.indexOf(key) < 0) {
-            throw newInvariantError(52, key);
+            throw newInvariantError(46, key);
         }
     }
     return operation;
@@ -1767,7 +1767,7 @@ var ApolloLink =  (function () {
     ApolloLink.concat = function (first, second) {
         var firstLink = toLink(first);
         if (isTerminating(firstLink)) {
-            globalThis.__DEV__ !== false && invariant.warn(44, firstLink);
+            globalThis.__DEV__ !== false && invariant.warn(38, firstLink);
             return firstLink;
         }
         var nextLink = toLink(second);
@@ -1793,7 +1793,7 @@ var ApolloLink =  (function () {
         return ApolloLink.concat(this, next);
     };
     ApolloLink.prototype.request = function (operation, forward) {
-        throw newInvariantError(45);
+        throw newInvariantError(39);
     };
     ApolloLink.prototype.onError = function (error, observer) {
         if (observer && observer.error) {
@@ -2175,7 +2175,7 @@ var serializeFetchParameter = function (p, label) {
         serialized = JSON.stringify(p);
     }
     catch (e) {
-        var parseError = newInvariantError(48, label, e.message);
+        var parseError = newInvariantError(42, label, e.message);
         parseError.parseError = e;
         throw parseError;
     }
@@ -2261,7 +2261,7 @@ function removeDuplicateHeaders(headers, preserveHeaderCase) {
 
 var checkFetcher = function (fetcher) {
     if (!fetcher && typeof fetch === "undefined") {
-        throw newInvariantError(46);
+        throw newInvariantError(40);
     }
 };
 
@@ -2395,7 +2395,7 @@ var createHttpLink = function (linkOptions) {
             options.headers = options.headers || {};
             var acceptHeader = "multipart/mixed;";
             if (isSubscription && hasDefer) {
-                globalThis.__DEV__ !== false && invariant.warn(47);
+                globalThis.__DEV__ !== false && invariant.warn(41);
             }
             if (isSubscription) {
                 acceptHeader +=
@@ -2532,59 +2532,14 @@ function directiveIsNonreactive(dir) {
 var MapImpl = canUseWeakMap ? WeakMap : Map;
 var SetImpl = canUseWeakSet ? WeakSet : Set;
 var disableWarningsSlot = new optimism.Slot();
-function maskOperation(data, document, cache) {
-    var _a;
-    if (!cache.fragmentMatches) {
-        if (globalThis.__DEV__ !== false) {
-            warnOnImproperCacheImplementation();
-        }
-        return data;
-    }
-    var definition = getOperationDefinition(document);
-    invariant(definition, 38);
-    if (data == null) {
-        return data;
-    }
-    return maskDefinition(data, definition.selectionSet, {
-        operationType: definition.operation,
-        operationName: (_a = definition.name) === null || _a === void 0 ? void 0 : _a.value,
-        fragmentMap: createFragmentMap(getFragmentDefinitions(document)),
-        cache: cache,
-        mutableTargets: new MapImpl(),
-        knownChanged: new SetImpl(),
-    });
-}
-function maskFragment(data, document, cache, fragmentName) {
-    if (!cache.fragmentMatches) {
-        if (globalThis.__DEV__ !== false) {
-            warnOnImproperCacheImplementation();
-        }
-        return data;
-    }
-    var fragments = document.definitions.filter(function (node) {
-        return node.kind === graphql.Kind.FRAGMENT_DEFINITION;
-    });
-    if (typeof fragmentName === "undefined") {
-        invariant(fragments.length === 1, 39, fragments.length);
-        fragmentName = fragments[0].name.value;
-    }
-    var fragment = fragments.find(function (fragment) { return fragment.name.value === fragmentName; });
-    invariant(!!fragment, 40, fragmentName);
-    if (data == null) {
-        return data;
-    }
-    if (equal.equal(data, {})) {
-        return data;
+var issuedWarning = false;
+function warnOnImproperCacheImplementation() {
+    if (!issuedWarning) {
+        issuedWarning = true;
+        globalThis.__DEV__ !== false && invariant.warn(52);
     }
-    return maskDefinition(data, fragment.selectionSet, {
-        operationType: "fragment",
-        operationName: fragment.name.value,
-        fragmentMap: createFragmentMap(getFragmentDefinitions(document)),
-        cache: cache,
-        mutableTargets: new MapImpl(),
-        knownChanged: new SetImpl(),
-    });
 }
+
 function maskDefinition(data, selectionSet, context) {
     return disableWarningsSlot.withValue(true, function () {
         var masked = maskSelectionSet(data, selectionSet, context, false);
@@ -2665,7 +2620,7 @@ function maskSelectionSet(data, selectionSet, context, migration, path) {
             var fragment = context.fragmentMap[fragmentName] ||
                 (context.fragmentMap[fragmentName] =
                     context.cache.lookupFragment(fragmentName));
-            invariant(fragment, 41, fragmentName);
+            invariant(fragment, 47, fragmentName);
             var mode = getFragmentMaskMode(selection);
             if (mode !== "mask") {
                 value = maskSelectionSet(data, fragment.selectionSet, context, mode === "migrate", path);
@@ -2688,7 +2643,7 @@ function getAccessorWarningDescriptor(fieldName, value, path, operationName, ope
         if (disableWarningsSlot.getValue()) {
             return value;
         }
-        globalThis.__DEV__ !== false && invariant.warn(42, operationName ?
+        globalThis.__DEV__ !== false && invariant.warn(48, operationName ?
             "".concat(operationType, " '").concat(operationName, "'")
             : "anonymous ".concat(operationType), "".concat(path, ".").concat(fieldName).replace(/^\./, ""));
         getValue = function () { return value; };
@@ -2705,12 +2660,60 @@ function getAccessorWarningDescriptor(fieldName, value, path, operationName, ope
         configurable: true,
     };
 }
-var issuedWarning = false;
-function warnOnImproperCacheImplementation() {
-    if (!issuedWarning) {
-        issuedWarning = true;
-        globalThis.__DEV__ !== false && invariant.warn(43);
+
+function maskFragment(data, document, cache, fragmentName) {
+    if (!cache.fragmentMatches) {
+        if (globalThis.__DEV__ !== false) {
+            warnOnImproperCacheImplementation();
+        }
+        return data;
+    }
+    var fragments = document.definitions.filter(function (node) {
+        return node.kind === graphql.Kind.FRAGMENT_DEFINITION;
+    });
+    if (typeof fragmentName === "undefined") {
+        invariant(fragments.length === 1, 49, fragments.length);
+        fragmentName = fragments[0].name.value;
+    }
+    var fragment = fragments.find(function (fragment) { return fragment.name.value === fragmentName; });
+    invariant(!!fragment, 50, fragmentName);
+    if (data == null) {
+        return data;
+    }
+    if (equal__default(data, {})) {
+        return data;
+    }
+    return maskDefinition(data, fragment.selectionSet, {
+        operationType: "fragment",
+        operationName: fragment.name.value,
+        fragmentMap: createFragmentMap(getFragmentDefinitions(document)),
+        cache: cache,
+        mutableTargets: new MapImpl(),
+        knownChanged: new SetImpl(),
+    });
+}
+
+function maskOperation(data, document, cache) {
+    var _a;
+    if (!cache.fragmentMatches) {
+        if (globalThis.__DEV__ !== false) {
+            warnOnImproperCacheImplementation();
+        }
+        return data;
     }
+    var definition = getOperationDefinition(document);
+    invariant(definition, 51);
+    if (data == null) {
+        return data;
+    }
+    return maskDefinition(data, definition.selectionSet, {
+        operationType: definition.operation,
+        operationName: (_a = definition.name) === null || _a === void 0 ? void 0 : _a.value,
+        fragmentMap: createFragmentMap(getFragmentDefinitions(document)),
+        cache: cache,
+        mutableTargets: new MapImpl(),
+        knownChanged: new SetImpl(),
+    });
 }
 
 var ApolloCache =  (function () {