@graphcommerce/docs 7.1.0-canary.28 → 7.1.0-canary.30

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Change Log
 
+## 7.1.0-canary.30
+
+## 7.1.0-canary.29
+
+### Patch Changes
+
+- [#2104](https://github.com/graphcommerce-org/graphcommerce/pull/2104) [`d0f1f5a2d`](https://github.com/graphcommerce-org/graphcommerce/commit/d0f1f5a2d1380d1c3931e23218924d5e8b1fc60d) - Document workaround/patch for broken cart error handling with Magento 2.4.6. ([@hnsr](https://github.com/hnsr))
+
 ## 7.1.0-canary.28
 
 ## 7.1.0-canary.27

package/magento/patches/cart-error-category.patch

@@ -0,0 +1,46 @@
+Fix inactive/non-existent cart handling by re-adding GraphQL error category extension
+
+@package magento/framework
+
+Index: GraphQl/Exception/GraphQlNoSuchEntityException.php
+IDEA additional info:
+Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
+<+>UTF-8
+===================================================================
+diff --git a/GraphQl/Exception/GraphQlNoSuchEntityException.php b/GraphQl/Exception/GraphQlNoSuchEntityException.php
+--- a/GraphQl/Exception/GraphQlNoSuchEntityException.php
++++ b/GraphQl/Exception/GraphQlNoSuchEntityException.php	(date 1698390008711)
+@@ -7,6 +7,8 @@
+
+ namespace Magento\Framework\GraphQl\Exception;
+
++use GraphQL\Error\ClientAware;
++use GraphQL\Error\ProvidesExtensions;
+ use Magento\Framework\Exception\NoSuchEntityException;
+ use Magento\Framework\Phrase;
+
+@@ -15,7 +17,7 @@
+  *
+  * @api
+  */
+-class GraphQlNoSuchEntityException extends NoSuchEntityException implements \GraphQL\Error\ClientAware
++class GraphQlNoSuchEntityException extends NoSuchEntityException implements ClientAware, ProvidesExtensions
+ {
+     const EXCEPTION_CATEGORY = 'graphql-no-such-entity';
+
+@@ -53,4 +55,15 @@
+     {
+         return self::EXCEPTION_CATEGORY;
+     }
++
++    /**
++     * Get error category
++     *
++     * @return array
++     */
++    public function getExtensions(): array
++    {
++        $exceptionCategory['category'] = $this->getCategory();
++        return $exceptionCategory;
++    }
+ }

package/magento/readme.md

@@ -92,3 +92,22 @@ will always be prompted to create a new account.
 
 - [Full feature list](../feature-list.md)
 - [SEO Migration](./seo-migration.md)
+
+## Known issues
+
+An overview of bugs and limitations you may run into with Magento's GraphQL API:
+
+### Cart-related mutations result `Can not find cart with ID` or `Cart isn't active` errors
+
+This is caused by a regression in Magento 2.4.6, which results in some GraphQL
+errors no longer getting a category extension string (such as
+`graphql-no-such-entity`). Normally, these errors are handling by automatically
+creating a new cart, but without the proper error category this error-handling
+logic is nog triggered.
+
+As a workaround, you can apply
+[cart-error-category.patch](./patches/cart-error-category.patch). This
+regression is fixed as of Magento 2.4.7-beta2.
+
+See also
+https://github.com/magento/magento2/commit/49cbe774020d3dfa6ee2b8702376a947801c9971

package/package.json

@@ -2,10 +2,10 @@
   "name": "@graphcommerce/docs",
   "homepage": "https://www.graphcommerce.org/docs",
   "repository": "github:graphcommerce-org/graphcommerce/docs",
-  "version": "7.1.0-canary.28",
+  "version": "7.1.0-canary.30",
   "sideEffects": true,
   "devDependencies": {
-    "@graphcommerce/prettier-config-pwa": "7.1.0-canary.28"
+    "@graphcommerce/prettier-config-pwa": "7.1.0-canary.30"
   },
   "prettier": "@graphcommerce/prettier-config-pwa"
 }