From 167c392707e8dda55b7f76f3385334a84a7726c1 Mon Sep 17 00:00:00 2001 From: Sergii Ivashchenko Date: Wed, 7 Jan 2026 17:01:54 +0000 Subject: [PATCH 1/3] LYNX-939: Document breaking change to gift_message_available --- .../commerce/2.4.7-2.4.8.md | 6 ++++++ .../backward-incompatible-changes/index.md | 20 +++++++++++++++++++ 2 files changed, 26 insertions(+) diff --git a/src/_includes/backward-incompatible-changes/commerce/2.4.7-2.4.8.md b/src/_includes/backward-incompatible-changes/commerce/2.4.7-2.4.8.md index 114afbb39..c26f105d9 100644 --- a/src/_includes/backward-incompatible-changes/commerce/2.4.7-2.4.8.md +++ b/src/_includes/backward-incompatible-changes/commerce/2.4.7-2.4.8.md @@ -265,3 +265,9 @@ #### Class was removed - Magento\PageBuilder\Block\Adminhtml\Stage\Render + +### GraphQL changes + +#### GraphQL field type changed + +- `ProductInterface.gift_message_available` — type changed from `String` to `Boolean!` diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md index 6393ce3b6..bf8fbf762 100644 --- a/src/pages/development/backward-incompatible-changes/index.md +++ b/src/pages/development/backward-incompatible-changes/index.md @@ -143,6 +143,26 @@ The following module is affected by this change: * paypal/module-braintree-core +### Updated GraphQL ProductInterface.gift_message_available type + +The GraphQL type for `ProductInterface.gift_message_available` was changed from `String` to a non-nullable boolean (`Boolean!`) to provide a consistent and type-safe representation of whether gift messages are available for a product. + +**Impact:** + +* GraphQL queries and clients that expect a string value will now receive a boolean. +* Frontend code, integrations, and custom GraphQL clients must handle `true`/`false` instead of string values like `"1"`, `"0"`, `"true"`, or `"false"`. +* Custom GraphQL resolvers and extensions that return or map this field must return a boolean value. +* Unit and integration tests that assert string values for this field will fail until updated. + +**Action Required:** + +1. Update GraphQL queries and client-side code to expect a boolean for `gift_message_available`. +2. Update any custom resolvers or mappers to cast or convert stored values to boolean, for example: + ```php + // Example resolver change in a PHP resolver + return (bool) $product->getData('gift_message_available'); + ``` + ### Updated default collation for MySQL The system now defaults to using `utf8mb4` collation for MySQL, ensuring compatibility with MySQL 8 and future-proofing against the deprecation of `utf8mb3`. Previously, the system defaulted to using the `utf8mb3` collation, which is deprecated in MySQL 8. From 015c8a9245b9db6bc5109ba01e6de551ed61905f Mon Sep 17 00:00:00 2001 From: Sergii Ivashchenko Date: Wed, 7 Jan 2026 17:15:03 +0000 Subject: [PATCH 2/3] Fixed lint error --- src/pages/development/backward-incompatible-changes/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md index bf8fbf762..c0ad6a8bf 100644 --- a/src/pages/development/backward-incompatible-changes/index.md +++ b/src/pages/development/backward-incompatible-changes/index.md @@ -158,6 +158,7 @@ The GraphQL type for `ProductInterface.gift_message_available` was changed from 1. Update GraphQL queries and client-side code to expect a boolean for `gift_message_available`. 2. Update any custom resolvers or mappers to cast or convert stored values to boolean, for example: + ```php // Example resolver change in a PHP resolver return (bool) $product->getData('gift_message_available'); From 9622a362093536ebdb216bc51d0ab65db7b12999 Mon Sep 17 00:00:00 2001 From: Kevin Harper Date: Thu, 8 Jan 2026 09:10:30 -0600 Subject: [PATCH 3/3] Add note about REST Update documentation to clarify changes in GraphQL handling and required actions. --- src/pages/development/backward-incompatible-changes/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md index c0ad6a8bf..ff07b53f2 100644 --- a/src/pages/development/backward-incompatible-changes/index.md +++ b/src/pages/development/backward-incompatible-changes/index.md @@ -153,6 +153,7 @@ The GraphQL type for `ProductInterface.gift_message_available` was changed from * Frontend code, integrations, and custom GraphQL clients must handle `true`/`false` instead of string values like `"1"`, `"0"`, `"true"`, or `"false"`. * Custom GraphQL resolvers and extensions that return or map this field must return a boolean value. * Unit and integration tests that assert string values for this field will fail until updated. +* REST is not affected. **Action Required:**