Yireo_SyncGraphQlSessionWithFrontend

PHP 8.2 - 8.5
Magento 2.4.6 - 2.4.9
CSP Yes
License OSL-3.0
Latest Release none

Magento 2 module to sync from the GraphQL session to the Knockout session and from the Knockout session to the GraphQL session.

Summary

  • The GraphQL cart token (aka masked_id) is added to the CustomerDatas section cart of the Knockout frontend (customerData.get('cart')) which is automatically synced by Knockout to local storage;
  • Within local storage, you can fetch the GraphQL token again from mage-cache-storage.cart.masked_id, for instance if you are switching from a regular Knockout frontend to a React-based checkout;

Kudos

Thanks to Willem Wigman for coming up with the idea for putting the cart token in the section data.

Proof-of-Concept for cart

Use a GraphQL client within React to generate a cart token:

mutation {
  createEmptyCart
}

The result might be something like the following:

vGS4ZLj6LkFVrH5CkAPEapLhgfbsoQKF

You should now be able to navigate to the Knockout frontend. After making a modification to the cart (adding a new item, changing the quantity or just wiping out local storage), you can then inspect the local storage entry mage-cache-storage.cart.masked_id: It should hold the same token as mentioned above.

If you add a product to the cart in the Knockout frontend, the same product should be there in the GraphQL session as well:

query cart($cartId: String!) {
  cart(cart_id: $cartId){
    id
    items {
      product {
        sku
      }
    }
  }
}

Now, add a product to the cart (in this case with a product SKU 24-MB04:

mutation addToCart($cartId: String!) {
  addSimpleProductsToCart(input: {
    cart_id: $cartId, 
    cart_items: [{data: {quantity: 1, sku: "24-MB04"}}]
  }) {
    cart {
      id
      total_quantity
      items {
        id
        prices {
          row_total {
            currency
            value
          }
        }
        product {
          url_key
        }
      }
    }
  }
}

Next, head over to the Knockout frontend, wipe out local storage mage-cache-storage.cart (or do this in Knockout via customerData.clear()) and inspect the cart again.

Proof-of-Concept for customer

Use a GraphQL client within React to generate a customer token:

mutation login($email:String!, $password:String!) {
  generateCustomerToken(email:$email, password:$password) {
    token
  }
}

Next, login as the same customer in the Knockout frontend. The local storage item mage-cache-storage.customer.customer_token now refers to the same GraphQL token.

This probably needs some enhancement, so that you are logged in right away in either frontend, without loosing security.

Current status

Magento 2 Unit Tests success
Magento 2 Static Tests success
Magento 2 DI compilation success
Magento 2 Integration Tests success
Playwright test success
WARNING: This module has no releases yet. If you want to use it, make sure to add the version @dev to the composer command.

Support

For getting support, create an Issue under the following project URL:

https://github.com/yireo/Yireo_SyncGraphQlSessionWithFrontend

Composer details
Magento module name
Yireo_SyncGraphQlSessionWithFrontend
Composer name
yireo/magento2-sync-graph-ql-session-with-frontend
Composer version
No release yet
Default branch
master
Requirements
magento/framework: ^100.1|^101.0|^102.0|^103.0
magento/module-checkout: ^100.1
magento/module-quote: ^100.1|^101.0
php: >=8.2 <8.6
Releases
Changelog

[0.0.2] - 2020-07-10

  • Complete refactoring to use CustomerData sections

[0.0.1] - 2020-05

  • Initial draft with a GET token

Last modified: October 17, 2026