feat(Store): support in-store requests

Author: nikossvnk

src/Core/Request/Carts/CartByCustomerIdGetRequest.php

@@ -5,6 +5,8 @@
 
 namespace Commercetools\Core\Request\Carts;
 
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Psr\Http\Message\ResponseInterface;
 use Commercetools\Core\Client\HttpMethod;
 use Commercetools\Core\Client\HttpRequest;
@@ -21,10 +23,12 @@
  * @link https://docs.commercetools.com/http-api-projects-carts.html#get-cart-by-customer-id
  * @method Cart mapResponse(ApiResponseInterface $response)
  * @method Cart mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method CartByCustomerIdGetRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class CartByCustomerIdGetRequest extends AbstractApiRequest
 {
     use CustomerIdTrait;
+    use InStoreTrait;
 
     protected $resultClass = Cart::class;
 

src/Core/Request/Carts/CartByIdGetRequest.php

@@ -8,6 +8,8 @@
 use Commercetools\Core\Model\Cart\Cart;
 use Commercetools\Core\Model\Common\Context;
 use Commercetools\Core\Request\AbstractByIdGetRequest;
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Commercetools\Core\Response\ApiResponseInterface;
 use Commercetools\Core\Model\MapperInterface;
 
@@ -16,9 +18,12 @@
  * @link https://docs.commercetools.com/http-api-projects-carts.html#get-cart-by-id
  * @method Cart mapResponse(ApiResponseInterface $response)
  * @method Cart mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method CartByIdGetRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class CartByIdGetRequest extends AbstractByIdGetRequest
 {
+    use InStoreTrait;
+
     protected $resultClass = Cart::class;
 
     /**

src/Core/Request/Carts/CartCreateRequest.php

@@ -7,8 +7,10 @@
 
 use Commercetools\Core\Model\Cart\CartDraft;
 use Commercetools\Core\Model\Common\Context;
-use Commercetools\Core\Request\AbstractCreateRequest;
 use Commercetools\Core\Model\Cart\Cart;
+use Commercetools\Core\Request\AbstractCreateRequest;
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Commercetools\Core\Response\ApiResponseInterface;
 use Commercetools\Core\Model\MapperInterface;
 
@@ -17,9 +19,12 @@
  * @link https://docs.commercetools.com/http-api-projects-carts.html#create-cart
  * @method Cart mapResponse(ApiResponseInterface $response)
  * @method Cart mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method CartCreateRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class CartCreateRequest extends AbstractCreateRequest
 {
+    use InStoreTrait;
+
     protected $resultClass = Cart::class;
 
     /**
@@ -34,7 +39,7 @@ public function __construct(CartDraft $cartDraft, Context $context = null)
     /**
      * @param CartDraft $cartDraft
      * @param Context $context
-     * @return static
+     * @return CartCreateRequest
      */
     public static function ofDraft(CartDraft $cartDraft, Context $context = null)
     {

src/Core/Request/Carts/CartDeleteRequest.php

@@ -10,6 +10,8 @@
 use Commercetools\Core\Request\AbstractDeleteRequest;
 use Commercetools\Core\Model\Cart\Cart;
 use Commercetools\Core\Request\DataErasureTrait;
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Commercetools\Core\Response\ApiResponseInterface;
 use Commercetools\Core\Model\MapperInterface;
 
@@ -18,10 +20,12 @@
  * @link https://docs.commercetools.com/http-api-projects-carts.html#delete-cart
  * @method Cart mapResponse(ApiResponseInterface $response)
  * @method Cart mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method CartDeleteRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class CartDeleteRequest extends AbstractDeleteRequest
 {
     use DataErasureTrait;
+    use InStoreTrait;
 
     protected $resultClass = Cart::class;
 

src/Core/Request/Carts/CartQueryRequest.php

@@ -8,6 +8,8 @@
 use Commercetools\Core\Model\Cart\CartCollection;
 use Commercetools\Core\Model\Common\Context;
 use Commercetools\Core\Request\AbstractQueryRequest;
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Commercetools\Core\Response\ApiResponseInterface;
 use Commercetools\Core\Model\MapperInterface;
 
@@ -16,9 +18,12 @@
  * @link https://docs.commercetools.com/http-api-projects-carts.html#query-carts
  * @method CartCollection mapResponse(ApiResponseInterface $response)
  * @method CartCollection mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method CartQueryRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class CartQueryRequest extends AbstractQueryRequest
 {
+    use InStoreTrait;
+
     protected $resultClass = CartCollection::class;
 
     /**

src/Core/Request/Carts/CartUpdateRequest.php

@@ -8,6 +8,8 @@
 use Commercetools\Core\Model\Cart\Cart;
 use Commercetools\Core\Model\Common\Context;
 use Commercetools\Core\Request\AbstractUpdateRequest;
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Commercetools\Core\Response\ApiResponseInterface;
 use Commercetools\Core\Model\MapperInterface;
 
@@ -16,9 +18,12 @@
  * @link https://docs.commercetools.com/http-api-projects-carts.html#update-cart
  * @method Cart mapResponse(ApiResponseInterface $response)
  * @method Cart mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method CartUpdateRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class CartUpdateRequest extends AbstractUpdateRequest
 {
+    use InStoreTrait;
+
     protected $resultClass = Cart::class;
 
     /**

src/Core/Request/InStores/InStoreEndpoint.php

@@ -0,0 +1,22 @@
+<?php
+/**
+ */
+
+namespace Commercetools\Core\Request\InStores;
+
+use Commercetools\Core\Client\JsonEndpoint;
+
+/**
+ * @package Commercetools\Core\Request\InStores
+ */
+class InStoreEndpoint
+{
+    /**
+     * @param string $storeKey
+     * @return JsonEndpoint
+     */
+    public static function endpoint($storeKey)
+    {
+        return new JsonEndpoint('in-store/key=' . $storeKey . '/');
+    }
+}

src/Core/Request/InStores/InStoreRequestDecorator.php

@@ -0,0 +1,82 @@
+<?php
+/**
+ *
+ */
+
+namespace Commercetools\Core\Request\InStores;
+
+use Commercetools\Core\Model\Common\Context;
+use Commercetools\Core\Model\MapperInterface;
+use Commercetools\Core\Request\ClientRequestInterface;
+use Commercetools\Core\Response\ApiResponseInterface;
+use Psr\Http\Message\RequestInterface;
+use Psr\Http\Message\ResponseInterface;
+
+class InStoreRequestDecorator implements ClientRequestInterface
+{
+
+    private $request;
+    private $endpoint;
+
+    /**
+     * InStoreDecorator constructor.
+     * @param string $storeKey
+     * @param ClientRequestInterface $request
+     */
+    public function __construct($storeKey, ClientRequestInterface $request)
+    {
+        //
+        $this->request = $request;
+        $this->endpoint = InStoreEndpoint::endpoint($storeKey);
+    }
+
+    public function getIdentifier()
+    {
+        return $this->request->getIdentifier();
+    }
+
+    public function setIdentifier($identifier)
+    {
+        return $this->request->setIdentifier($identifier);
+    }
+
+    public function httpRequest()
+    {
+        return $this->decorateUri($this->request->httpRequest());
+    }
+
+    private function decorateUri(RequestInterface $request)
+    {
+        return $request->withUri($request->getUri()->withPath($this->endpoint . $request->getUri()->getPath()));
+    }
+
+    public function buildResponse(ResponseInterface $response)
+    {
+        return $this->request->buildResponse($response);
+    }
+
+    public function mapResult(array $result, Context $context = null)
+    {
+        return $this->request->mapResult($result, $context);
+    }
+
+    public function mapResponse(ApiResponseInterface $response)
+    {
+        return $this->request->mapResponse($response);
+    }
+
+    public function map(array $data, Context $context = null, MapperInterface $mapper = null)
+    {
+        return $this->request->map($data, $context, $mapper);
+    }
+
+    public function mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+    {
+        return $this->request->mapFromResponse($response, $mapper);
+    }
+
+    public static function ofStoreAndRequest($storeKey, ClientRequestInterface $request)
+    {
+        return new static($storeKey, $request);
+    }
+}

src/Core/Request/InStores/InStoreTrait.php

@@ -0,0 +1,17 @@
+<?php
+/**
+ */
+
+namespace Commercetools\Core\Request\InStores;
+
+trait InStoreTrait
+{
+    /**
+     * @param $storeKey
+     * @return InStoreRequestDecorator
+     */
+    public function inStore($storeKey)
+    {
+        return new InStoreRequestDecorator($storeKey, $this);
+    }
+}

src/Core/Request/Me/MeActiveCartRequest.php

@@ -9,8 +9,9 @@
 use Commercetools\Core\Client\HttpRequest;
 use Commercetools\Core\Model\Common\Context;
 use Commercetools\Core\Request\AbstractApiRequest;
-use Commercetools\Core\Request\AbstractByIdGetRequest;
 use Commercetools\Core\Model\Cart\Cart;
+use Commercetools\Core\Request\InStores\InStoreRequestDecorator;
+use Commercetools\Core\Request\InStores\InStoreTrait;
 use Commercetools\Core\Response\ApiResponseInterface;
 use Commercetools\Core\Response\ResourceResponse;
 use Psr\Http\Message\ResponseInterface;
@@ -21,9 +22,12 @@
  * @link https://docs.commercetools.com/http-api-projects-me-carts.html#get-active-cart
  * @method Cart mapResponse(ApiResponseInterface $response)
  * @method Cart mapFromResponse(ApiResponseInterface $response, MapperInterface $mapper = null)
+ * @method MeActiveCartRequest|InStoreRequestDecorator inStore($storeKey)
  */
 class MeActiveCartRequest extends AbstractApiRequest
 {
+    use InStoreTrait;
+
     protected $resultClass = Cart::class;
 
     /**