brX GraphQL Service Release Notes

Project status

Solution version	Bloomreach Experience Manager version
14.x	14.x

brX GraphQL Service and Commerce React Components Release Notes (14.x)

14.6.1

Commerce React Components

🚀 Improvements

• Include ImageSet.variants in GraphQL queries to support multiple variant images

 

GraphQL Service

🚀 Improvements

• Improve URLs to be more user friendly and use category key option as well as category ID

🎉 New Features

• Check the stock levels in a PDP as determined by a shopper's location with commercetools
• Allow shoppers to see the shipping costs for their cart according to their region with commercetools
• Create, update, and delete a wishlist with commercetools
• Password recovery with commercetools
• Filter product search results with commercetools

 

14.6.0

Commerce React Components

🚀 Improvements

• Support all brSM query hints in Product/Category components
• Support coupon codes in Cart
• Page-based pagination in Product/Category components

🎉 New Features

• ProductGridWidgets which handles the GraphQL query findItemsByWidget

 

GraphQL Service

🚀 Improvements

• Default locale option
• Expose the X-BR-Response-Time from brSM in the GraphQL response
• Include the custom attributes in queryHint in brSM search field names
• Override CUSTOM_VARIANT_LIST_PRICE_FIELD and CUSTOM_VARIANT_PURCHASE_PRICE_FIELD through GraphQL queryHint
• Override smAccountID (and auth_key) through GraphQL queryHint

🐛 Bugfixes

• Cart is not resetting after logging out of the Demo React App for Shopify
• Customers cannot add items to cart after checkout with Shopify
• Variant price data is incorrectly mapped between brSM and Shopify
• findItemsByWidget does not return correct result
• Non-existing custom attributes should not return "undefined" string
• brSM search API response for products-with-variants is incorrect

 

14.5.1

Bug

• Variant price data is incorrectly mapped between brSM and Shopify

14.5.0

Stories

• As a front-end developer I want to be able to check the inventory of a product in order to inform if it can be added to the cart with Shopify
• As a front-end developer I want to be able to allow shoppers to customise a product, add it to cart, and see their customisation when viewing the cart with Shopify
• As a front-end developer I'd like to allow shoppers to update their cart with coupon codes when checking out with commercetools

New Features:

• Add findItemsByWidget query to support Pathways and Recommendations v2

Improvements

• Add "active" and "state" fields to Cart model to inform cart changes to the front-end
• Support overwriting or appending query parameters with Search and Merchandising's auto-suggest
• Add variant ID to the cart entry's itemID with Shopify
• Allow custom attributes to be added to cart in CRC and Demo React App
• Fix the URL pattern for cart item variant in Commerce React Components
• Change mainItem in ItemVariant to contain only itemId and displayName
• Use "handle" as the main product's code with Shopify

Bugs

• Commerce Open UI Pickers fail to connect if GraphQL URL configuration is changed

Tasks

• Improve the Commerce Open UI Picker to read the configured URL from its own configuration in JCR

14.4.0

Stories

• As a front-end developer I want to be able to give users a way to sort the results from a search query on a Product Grid with commercetools
• As a front-end developer I want to be able to give users a way to sort the results from a search query on a Product Grid with SAP
• As a front-end developer I want to be able to give users a way to sort the results from a search query on a Product Grid with Shopify
• As a front-end developer I want to be able to retrieve custom fields (attributes) from SAP

New Features

• Migrate Autosuggest data source from V1 to V2

Improvements

• Search for products using product key with commercetools
• As a front-end developer I want to be able to query against brSM only without signing in (even if anonymously)
• GraphQL Federation support

14.3.3

Stories

• As a front-end developer I want to be able to retrieve custom fields (attributes) from Shopify when querying through GraphQL
• As a front-end developer I'd like to expose the customFields from commercetools in the GraphQL response
• As a front-end developer I'd like to pass search redirects set in brSM by merchandisers through GraphQL for front-end handling

New Features

• Cart functionalities on Open-Source Commerce Backend Connector: Shopizer
• Customer sign-in and sign-out functionalities on Open-Source Commerce Backend Connector: Shopizer
• Product search functionalities on Open-Source Commerce Backend Connector: Shopizer
• Address management functionalities for updating addresses on Open-Source Commerce Backend Connector: Shopizer
• Category resolver (get all categories for menu) and category detail on Open-Source Commerce Backend Connector: Shopizer
• Customer profile functionalities to Open-Source Commerce Backend Connector: Shopizer
• Registration functionalities on Open-Source Commerce Backend Connector: Shopizer
• Checkout functionalities on Open-Source Commerce Backend Connector: Shopizer
• Forward "autocorrect" information in brSM API response to front-end code

Improvements

• Direct checkout should not merge the anonymous cart with the current user cart: sign-in operation should support extra cart related options
• Display product version (brx-graphql-service) on startup
• Improve the commercetools customer data model with extra fields in the GraphQL response
• Merge the brSM global custom attribute field names in .env into the fl param by default

Bugs

• Auto-suggest throws "Invalid URL" message

Tasks

• Provide product variant dimensions data to Open-Source Commerce Backend Connector: Shopizer

14.3.2

Improvement

• Provide GraphQL Schema HTML Documents

14.3.1

Bug

• Master variant is not being displayed in the product detail page with commercetools
• brSM connector fl list contains duplicate field names in the brX GraphQL Service

New Feature

• Add generic `params` input in QueryHint (to include segment, ll, etc.) to brSM with brX GraphQL Service
• Add "forgot password" functionalities to brX GraphQL Service with Shopify

Story

• As a front-end developer I want to be able to retrieve custom fields (attributes) from the brSM when querying through the brX GraphQL Service
• As a front-end developer I want to be able to retrieve custom fields (attributes) from commercetools when querying through the brX GraphQL Service

Improvement

• Add sorting support for findByKeyword and findByCategory against brSM in the brX GraphQL Service
• Anonymous cart is not merging when signing in SAP
• Include "price_range" and "sale_price_range" as standard fields
• Allow the fields in the BRSM_CUSTOM_ATTR_FIELD to be returned as facets in the response from the brX GraphQL Service
• Support custom attribute fields in the variant level from brSM with brX GraphQL Service
• Add sorting support for findByKeyword and findByCategory in Product Grid React High Order Component
• Allow to override `customAttrs` fields info through QueryHint when accessing brSM

14.3.0

Bug

• Anonymous cart is not merging after signing in with valid credentials in SAP
• Authorization token from Salesforce CloudCraze is not working if the brX GraphQL Service is inactive from last 2-3 hours

New Feature

• Federated Login/Logout in brX GraphQL Service
• Add "cart" functionalities to brX GraphQL Service with Shopify
• Add "customer sign-in and sign-out" functionalities to brX GraphQL Service with Shopify
• Add "product search" functionalities to brX GraphQL Service with Shopify
• Add "address management" functionalities to brX GraphQL Service with Shopify
• Add "customer profile" functionalities to brX GraphQL Service with Shopify
• Add "registration" functionalities to brX GraphQL Service with Shopify
• Add "order" functionalities to brX GraphQL Service with Shopify
• Add Pixel scriptlet in React Demo and pass _br_uid_2 cookie value in HOC when searching against brSM

Story

• As a developer I would like to set up the brX GraphQL Service with brSM without requiring a connection with a commerce backend for access management
• As a developer I want to be able to query brSM in multiple languages defined via domain_key in each API call

Task

• Provide product variant dimensions data to brX GraphQL Service with Shopify
• Update docker-componse.yml file with all environment configurations
• Implement React HOC and Demo for Federated Cart Checkout Integration with Shopify
• Provide how-to customize the Shopify "Thank you" page to redirect back to SPA with examples
• Include "auth_key" parameter in brSM Search, Category, and Widget API calls
• Fix License Info and headers in source in brX GraphQL Service

Improvement

•  Add category resolver (get all categories for menu) and category detail to brX GraphQL Service with Shopify
• Standardize the error in apollo level for different direct error messages from REST in brX GraphQL Service
• Add support for _br_uid_2 in brX GraphQL Service with brSM
• Allow enabling and disabling of token refreshing via a configurable environment setting
• Use specific customerID when invoking the backend SAP OCC API
• Add StoreUser.username to contain both backend specific identifier and username (email)
• Change the scope of DataSources to transient

 

14.2.1

Bug

• brX GraphQL Service doesn't seem to work with the latest stable version of NodeJS (12.18.X)
• ItemId converter doesn't work as expected in the brX GraphQL Service
• "getCart" query for SAP should return the current cart when an "id" is not provided
• "getCart" query for commercetools should return an empty cart when one is not found

New Feature

• Add "cart" functionalities to brX GraphQL Service with SAP
• Add "checkout" functionalities to brX GraphQL Service with SAP
• Add "view order list and single order" functionalities to brX GraphQL Service with SAP
• Add "registration" functionalities to brX GraphQL Service with SAP
• Add "product search by category" functionalities to brX GraphQL Service with SAP
• Add "re-order" functionalities to brX GraphQL Service with SAP

Task

• Support Product Attributes in brX GraphQL Service with commercetools
• Add "re-order" functionalities to brX GraphQL Service with commercetools
• Remove unused utility functions in sap-utils.ts

Improvement

• Support sorting fields when querying customer's orders in brX GraphQL Service with commercetools
• Return facets when querying products by category and keywords in brX GraphQL Service with brSM
• Support product variant dimensions data in brX GraphQL Service with SAP
• Implement product variant inclusion in the product item for brX GraphQL Service with SAP
• Filter product queries by facets in brX GraphQL Service with brSM
• Remove "username" from "changeCurrentCustomerPassword" mutation input
• Support sorting fields when querying customer's orders in brX GraphQL Service with SAP
• Add GraphQL API documentation comments to the brX GraphQL Service schema

Sub-task

• As a front-end developer I want to be able to add to my front-end application a React component for changing password
• Add GraphQL mutation for adding a customer address

 

14.2.0

Bug

• Getting "Algorithm not allowed: undefined" error in the console after starting brX GraphQL Service
• placeOrder API is failing with "Cannot read property 'user' of undefined" error
• commercetools GraphQL ItemDataSource#findOne() should search by ID if not found by code
• commercetools ItemDataSource doesn't provide code value in itemIds
• commercetools master variant is not included in item.variants

New Feature

• Add "cart" functionalities to brX GraphQL Service with commercetools
• Add "customer sign-in and sign-out" functionalities to brX GraphQL Service with commercetools
• Add "product search by category" functionalities to brX GraphQL Service with commercetools
• Add "product search by category", "Just For You", and "More Like This" functionalities to brX GraphQL Service with brSM
• Add "address management" functionalities to brX GraphQL Service with commercetools
• Add "customer profile" functionalities to brX GraphQL Service with commercetools
• Add "registration" functionalities to brX GraphQL Service with commercetools
• Add "autosuggest" functionalities to brX GraphQL Service with brSM
• Add "customer account" functionalities to brX GraphQL Service with SAP
• Add "address management" functionalities to brX GraphQL Service with SAP
• Add "product" functionalities to brX GraphQL Service with SAP
• Add "order" functionalities to brX GraphQL Service with commercetools
• Add "customer sign-in and sign-out" functionalities to brX GraphQL Service with SAP
• Add category resolver (get all categories for menu) and category detail to brX GraphQL Service with SAP

Task

• Dockerize the brX GraphQL Service
• Add source distribution maven profile in connector-service for deployment
• Provide product variant dimensions data to brX GraphQL Service with commercetools

Improvement

• Add category resolver (get all categories for menu) and category detail to brX GraphQL Service with commercetools
• Add category resolver (get all categories for menu) and category detail to brX GraphQL Service with brSM
• Create a mobile and single-page application client API for commercetools
• Assign anonymous cart to customer during sign-in operation in commercetools
• Improve brSM items/category GraphQL with `queryHint` input variable
• Improve Item/ItemVariant resolving through brX GraphQL Service resolver chains
• Leave extra verbose in logs when commercetools API calls fail
• Remove "revision" from cart mutation inputs
• Improve the logic of variants handling to brX GraphQL Service with commercetools