Merge pull request #694 from commercetools/php-mantainance3

Author: jenschude

src/Core/Builder/Request/ProductRequestBuilder.php

@@ -3,12 +3,15 @@
 namespace Commercetools\Core\Builder\Request;
 
 use Commercetools\Core\Request\Products\ProductByIdGetRequest;
+use Commercetools\Core\Request\Products\ProductByIdHeadRequest;
 use Commercetools\Core\Request\Products\ProductByKeyGetRequest;
+use Commercetools\Core\Request\Products\ProductByKeyHeadRequest;
 use Commercetools\Core\Request\Products\ProductCreateRequest;
 use Commercetools\Core\Model\Product\ProductDraft;
 use Commercetools\Core\Request\Products\ProductDeleteByKeyRequest;
 use Commercetools\Core\Model\Product\Product;
 use Commercetools\Core\Request\Products\ProductDeleteRequest;
+use Commercetools\Core\Request\Products\ProductHeadRequest;
 use Commercetools\Core\Request\Products\ProductImageUploadRequest;
 use Psr\Http\Message\UploadedFileInterface;
 use Commercetools\Core\Request\Products\ProductQueryRequest;
@@ -29,6 +32,17 @@ public function getById($id)
         return $request;
     }
 
+    /**
+     * @link https://docs.commercetools.com/api/projects/products#by-id
+     * @param string $id
+     * @return ProductByIdHeadRequest
+     */
+    public function getByIdHead($id)
+    {
+        $request = ProductByIdHeadRequest::ofId($id);
+        return $request;
+    }
+
     /**
      *
      * @param string $key
@@ -40,6 +54,17 @@ public function getByKey($key)
         return $request;
     }
 
+    /**
+     * @link https://docs.commercetools.com/api/projects/products#by-key
+     * @param string $key
+     * @return ProductByKeyHeadRequest
+     */
+    public function getByKeyHead($key)
+    {
+        $request = ProductByKeyHeadRequest::ofKey($key);
+        return $request;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-products.html#create-a-product
      * @param ProductDraft $product
@@ -73,6 +98,17 @@ public function delete(Product $product)
         return $request;
     }
 
+    /**
+     * @link https://docs.commercetools.com/api/projects/products#by-query-predicate
+     *
+     * @return ProductHeadRequest
+     */
+    public function head()
+    {
+        $request = ProductHeadRequest::of();
+        return $request;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-products.html#upload-a-product-image
      * @param string $id

src/Core/Builder/Update/CartsActionBuilder.php

@@ -50,6 +50,7 @@
 use Commercetools\Core\Request\Carts\Command\CartSetLineItemDistributionChannelAction;
 use Commercetools\Core\Request\Carts\Command\CartSetLineItemPriceAction;
 use Commercetools\Core\Request\Carts\Command\CartSetLineItemShippingDetailsAction;
+use Commercetools\Core\Request\Carts\Command\CartSetLineItemSupplyChannelAction;
 use Commercetools\Core\Request\Carts\Command\CartSetLineItemTaxAmountAction;
 use Commercetools\Core\Request\Carts\Command\CartSetLineItemTaxRateAction;
 use Commercetools\Core\Request\Carts\Command\CartSetLineItemTotalPriceAction;
@@ -574,6 +575,17 @@ public function setLineItemShippingDetails($action = null)
         return $this;
     }
 
+    /**
+     *
+     * @param CartSetLineItemSupplyChannelAction|callable $action
+     * @return $this
+     */
+    public function setLineItemSupplyChannel($action = null)
+    {
+        $this->addAction($this->resolveAction(CartSetLineItemSupplyChannelAction::class, $action));
+        return $this;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-carts.html#set-lineitem-taxamount
      * @param CartSetLineItemTaxAmountAction|callable $action

src/Core/Builder/Update/OrdersActionBuilder.php

@@ -39,10 +39,14 @@
 use Commercetools\Core\Request\Orders\Command\OrderSetLineItemShippingDetailsAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetLocaleAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetOrderNumberAction;
+use Commercetools\Core\Request\Orders\Command\OrderSetParcelCustomFieldAction;
+use Commercetools\Core\Request\Orders\Command\OrderSetParcelCustomTypeAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetParcelItemsAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetParcelMeasurementsAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetParcelTrackingDataAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetReturnInfoAction;
+use Commercetools\Core\Request\Orders\Command\OrderSetReturnItemCustomFieldAction;
+use Commercetools\Core\Request\Orders\Command\OrderSetReturnItemCustomTypeAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetReturnPaymentStateAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetReturnShipmentStateAction;
 use Commercetools\Core\Request\Orders\Command\OrderSetShippingAddress;
@@ -444,6 +448,28 @@ public function setOrderNumber($action = null)
         return $this;
     }
 
+    /**
+     *
+     * @param OrderSetParcelCustomFieldAction|callable $action
+     * @return $this
+     */
+    public function setParcelCustomField($action = null)
+    {
+        $this->addAction($this->resolveAction(OrderSetParcelCustomFieldAction::class, $action));
+        return $this;
+    }
+
+    /**
+     *
+     * @param OrderSetParcelCustomTypeAction|callable $action
+     * @return $this
+     */
+    public function setParcelCustomType($action = null)
+    {
+        $this->addAction($this->resolveAction(OrderSetParcelCustomTypeAction::class, $action));
+        return $this;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-orders.html#set-parcel-items
      * @param OrderSetParcelItemsAction|callable $action
@@ -488,6 +514,28 @@ public function setReturnInfo($action = null)
         return $this;
     }
 
+    /**
+     *
+     * @param OrderSetReturnItemCustomFieldAction|callable $action
+     * @return $this
+     */
+    public function setReturnItemCustomField($action = null)
+    {
+        $this->addAction($this->resolveAction(OrderSetReturnItemCustomFieldAction::class, $action));
+        return $this;
+    }
+
+    /**
+     *
+     * @param OrderSetReturnItemCustomTypeAction|callable $action
+     * @return $this
+     */
+    public function setReturnItemCustomType($action = null)
+    {
+        $this->addAction($this->resolveAction(OrderSetReturnItemCustomTypeAction::class, $action));
+        return $this;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-orders.html#set-returnpaymentstate
      * @param OrderSetReturnPaymentStateAction|callable $action

src/Core/Builder/Update/PaymentsActionBuilder.php

@@ -25,6 +25,8 @@
 use Commercetools\Core\Request\Payments\Command\PaymentSetMethodInfoNameAction;
 use Commercetools\Core\Request\Payments\Command\PaymentSetStatusInterfaceCodeAction;
 use Commercetools\Core\Request\Payments\Command\PaymentSetStatusInterfaceTextAction;
+use Commercetools\Core\Request\Payments\Command\PaymentSetTransactionCustomFieldAction;
+use Commercetools\Core\Request\Payments\Command\PaymentSetTransactionCustomTypeAction;
 use Commercetools\Core\Request\Payments\Command\PaymentTransitionStateAction;
 
 class PaymentsActionBuilder
@@ -262,6 +264,28 @@ public function setStatusInterfaceText($action = null)
         return $this;
     }
 
+    /**
+     *
+     * @param PaymentSetTransactionCustomFieldAction|callable $action
+     * @return $this
+     */
+    public function setTransactionCustomField($action = null)
+    {
+        $this->addAction($this->resolveAction(PaymentSetTransactionCustomFieldAction::class, $action));
+        return $this;
+    }
+
+    /**
+     *
+     * @param PaymentSetTransactionCustomTypeAction|callable $action
+     * @return $this
+     */
+    public function setTransactionCustomType($action = null)
+    {
+        $this->addAction($this->resolveAction(PaymentSetTransactionCustomTypeAction::class, $action));
+        return $this;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-payments.html#transition-state
      * @param PaymentTransitionStateAction|callable $action

src/Core/Builder/Update/StagedOrderActionBuilder.php

@@ -63,10 +63,14 @@
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetLocaleAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetOrderNumberAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetOrderTotalTaxAction;
+use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetParcelCustomFieldAction;
+use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetParcelCustomTypeAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetParcelItemsAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetParcelMeasurementsAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetParcelTrackingDataAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetReturnInfoAction;
+use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetReturnItemCustomFieldAction;
+use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetReturnItemCustomTypeAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetReturnPaymentStateAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetReturnShipmentStateAction;
 use Commercetools\Core\Request\OrderEdits\StagedOrder\Command\StagedOrderSetShippingAddressAction;
@@ -739,6 +743,28 @@ public function setOrderTotalTax($action = null)
         return $this;
     }
 
+    /**
+     *
+     * @param StagedOrderSetParcelCustomFieldAction|callable $action
+     * @return $this
+     */
+    public function setParcelCustomField($action = null)
+    {
+        $this->addAction($this->resolveAction(StagedOrderSetParcelCustomFieldAction::class, $action));
+        return $this;
+    }
+
+    /**
+     *
+     * @param StagedOrderSetParcelCustomTypeAction|callable $action
+     * @return $this
+     */
+    public function setParcelCustomType($action = null)
+    {
+        $this->addAction($this->resolveAction(StagedOrderSetParcelCustomTypeAction::class, $action));
+        return $this;
+    }
+
     /**
      *
      * @param StagedOrderSetParcelItemsAction|callable $action
@@ -783,6 +809,28 @@ public function setReturnInfo($action = null)
         return $this;
     }
 
+    /**
+     *
+     * @param StagedOrderSetReturnItemCustomFieldAction|callable $action
+     * @return $this
+     */
+    public function setReturnItemCustomField($action = null)
+    {
+        $this->addAction($this->resolveAction(StagedOrderSetReturnItemCustomFieldAction::class, $action));
+        return $this;
+    }
+
+    /**
+     *
+     * @param StagedOrderSetReturnItemCustomTypeAction|callable $action
+     * @return $this
+     */
+    public function setReturnItemCustomType($action = null)
+    {
+        $this->addAction($this->resolveAction(StagedOrderSetReturnItemCustomTypeAction::class, $action));
+        return $this;
+    }
+
     /**
      *
      * @param StagedOrderSetReturnPaymentStateAction|callable $action

src/Core/Client/HttpMethod.php

@@ -14,4 +14,5 @@ class HttpMethod
     const GET = 'GET';
     const POST = 'POST';
     const DELETE = 'DELETE';
+    const HEAD = 'HEAD';
 }

src/Core/Helper/Annotate/AnnotationGenerator.php

@@ -829,6 +829,12 @@ function ($link) {
                     $methodParams[] = [self::PARAM_DOC_TYPE => 'string', self::PARAM_NAME => '$' . $param];
                     $factoryCall = 'of' . ucfirst($param) . '($' . $param . ');';
                     break;
+                case preg_match('/^by([a-zA-Z]+)Head$/', $methodName, $matches) === 1:
+                    $param = lcfirst($matches[1]);
+                    $methodName = 'getBy' . ucfirst($param) . 'Head';
+                    $methodParams[] = [self::PARAM_DOC_TYPE => 'string', self::PARAM_NAME => '$' . $param];
+                    $factoryCall = 'of' . ucfirst($param) . '($' . $param . ');';
+                    break;
                 default:
                     $factoryCall = 'of();';
             }

src/Core/Model/Cart/LineItem.php

@@ -62,6 +62,8 @@
  * @method LineItem setAddedAt(DateTime $addedAt = null)
  * @method DateTime getLastModifiedAt()
  * @method LineItem setLastModifiedAt(DateTime $lastModifiedAt = null)
+ * @method string getProductKey()
+ * @method LineItem setProductKey(string $productKey = null)
  */
 class LineItem extends JsonObject
 {
@@ -77,6 +79,7 @@ public function fieldDefinitions()
         return [
             'id' => [static::TYPE => 'string'],
             'productId' => [static::TYPE => 'string'],
+            'productKey' => [static::TYPE => 'string'],
             'name' => [static::TYPE => LocalizedString::class],
             'productSlug' => [static::TYPE => LocalizedString::class],
             'variant' => [static::TYPE => ProductVariant::class],

src/Core/Model/Common/ContainerAndKey.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Commercetools\Core\Model\Common;
+
+/**
+ * @package Commercetools\Core\Model\Common
+ *
+ * @method string getContainer()
+ * @method ContainerAndKey setContainer(string $container = null)
+ * @method string getKey()
+ * @method ContainerAndKey setKey(string $key = null)
+ */
+class ContainerAndKey extends JsonObject
+{
+    public function fieldDefinitions()
+    {
+        return [
+            'container' => [self::TYPE => 'string'],
+            'key' => [self::TYPE => 'string'],
+        ];
+    }
+}

src/Core/Model/Message/InventoryEntryQuantitySetMessage.php

@@ -3,6 +3,7 @@
 
 namespace Commercetools\Core\Model\Message;
 
+use Commercetools\Core\Model\Channel\ChannelReference;
 use Commercetools\Core\Model\Common\DateTimeDecorator;
 use DateTime;
 use Commercetools\Core\Model\Common\Reference;
@@ -38,6 +39,8 @@
  * @method InventoryEntryQuantitySetMessage setOldAvailableQuantity(int $oldAvailableQuantity = null)
  * @method int getNewAvailableQuantity()
  * @method InventoryEntryQuantitySetMessage setNewAvailableQuantity(int $newAvailableQuantity = null)
+ * @method ChannelReference getSupplyChannel()
+ * @method InventoryEntryQuantitySetMessage setSupplyChannel(ChannelReference $supplyChannel = null)
  */
 class InventoryEntryQuantitySetMessage extends Message
 {
@@ -50,6 +53,7 @@ public function fieldDefinitions()
         $definitions['newQuantityOnStock'] = [static::TYPE => 'int'];
         $definitions['oldAvailableQuantity'] = [static::TYPE => 'int'];
         $definitions['newAvailableQuantity'] = [static::TYPE => 'int'];
+        $definitions['supplyChannel'] = [static::TYPE =>  ChannelReference::class];
 
         return $definitions;
     }