Implemented entered options data provider

Model/Cart/BuyRequest/GiftCardProductEnteredOptionsDataProvider.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * Copyright © MageWorx. All rights reserved.
+ * See LICENSE.txt for license details.
+ */
+declare(strict_types=1);
+
+namespace MageWorx\GiftCardsGraphQl\Model\Cart\BuyRequest;
+
+use Magento\Framework\Exception\LocalizedException;
+use Magento\Quote\Model\Cart\BuyRequest\BuyRequestDataProviderInterface;
+use Magento\Quote\Model\Cart\Data\CartItem;
+
+/**
+ * DataProvider for building gift card options in buy requests
+ */
+class GiftCardProductEnteredOptionsDataProvider implements BuyRequestDataProviderInterface
+{
+    private const OPTION_TYPE = 'mw_giftcard';
+
+    /**
+     * @inheritdoc
+     *
+     * @throws LocalizedException
+     */
+    public function execute(CartItem $cartItem): array
+    {
+        $giftCardProductData = [];
+        foreach ($cartItem->getEnteredOptions() as $option) {
+            // phpcs:ignore Magento2.Functions.DiscouragedFunction
+            $optionData = \explode('/', base64_decode($option->getUid()));
+
+            if ($this->isProviderApplicable($optionData) === false) {
+                continue;
+            }
+            $this->validateInput($optionData);
+
+            [$optionType, $optionId] = $optionData;
+            if ($optionType == self::OPTION_TYPE) {
+                $giftCardProductData[$optionId] = $option->getValue();
+            }
+        }
+
+        return $giftCardProductData;
+    }
+
+    /**
+     * Checks whether this provider is applicable for the current option
+     *
+     * @param array $optionData
+     * @return bool
+     */
+    private function isProviderApplicable(array $optionData): bool
+    {
+        if ($optionData[0] !== self::OPTION_TYPE) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Validates the provided options structure
+     *
+     * @param array $optionData
+     * @throws LocalizedException
+     */
+    private function validateInput(array $optionData): void
+    {
+        if (count($optionData) !== 2) {
+            throw new LocalizedException(
+                __('Wrong format of the entered option data')
+            );
+        }
+    }
+}

README.md

@@ -586,3 +586,36 @@ mutation {
     }
 }
 ```
+
+**7.** The **addProductsToCart** mutation allows you to add any product to the cart.
+
+Syntax:
+
+```
+mutation: {addProductsToCart(cartId: String! cartItems: [CartItemInput]!): AddProductsToCartOutput}
+```
+
+The CartItemInput object must contain the following attributes:
+
+```
+entered_options: [{uid: ID!, value: String!}]
+quantity: Float!
+sku: String!
+```
+
+**entered_options**
+
+You need to add gift card product cart item attributes array here, as uid and value.
+
+**uid**
+
+Base64 encoded cart item attribute starting with 'mw_giftcard/' prefix. For example:
+
+```
+mw_giftcard/mail_to_email
+```
+
+Base64 encoded uid
+```
+bXdfZ2lmdGNhcmQvbWFpbF90b19lbWFpbA==
+```

composer.json

@@ -11,7 +11,7 @@
         "magento/module-url-rewrite-graph-ql": ">= 100.4.2 < 100.5"
     },
     "type": "magento2-module",
-    "version": "1.2.2",
+    "version": "1.2.3",
     "license": [
         "OSL-3.0",
         "AFL-3.0"

etc/graphql/di.xml

@@ -20,6 +20,13 @@
             </argument>
         </arguments>
     </type>
+    <type name="Magento\Quote\Model\Cart\BuyRequest\BuyRequestBuilder">
+        <arguments>
+            <argument name="providers" xsi:type="array">
+                <item name="giftcard" xsi:type="object">MageWorx\GiftCardsGraphQl\Model\Cart\BuyRequest\GiftCardProductEnteredOptionsDataProvider</item>
+            </argument>
+        </arguments>
+    </type>
     <type name="Magento\Framework\GraphQl\Schema\Type\Enum\DefaultDataMapper">
         <arguments>
             <argument name="map" xsi:type="array">