Added support for order costs estimate (#16)

Added support for order costs estimate. Now you calculate all costs for an order through the API

Author: kievins

src/PrintfulOrder.php

@@ -3,6 +3,7 @@
 namespace Printful;
 
 use Printful\Structures\Order\Order;
+use Printful\Structures\Order\OrderCostGroup;
 use Printful\Structures\Order\OrderCreationParameters;
 use Printful\Structures\Order\OrderItemCreationParameters;
 use Printful\Structures\Order\OrderList;
@@ -126,6 +127,21 @@ public function getList($offset = 0, $limit = 10, $status = null)
         return new OrderList($rawOrders, $total, $offset);
     }
 
+    /**
+     * @param OrderCreationParameters $parameters
+     * @return OrderCostGroup
+     * @throws Exceptions\PrintfulApiException
+     * @throws Exceptions\PrintfulException
+     */
+    public function estimateCosts(OrderCreationParameters $parameters)
+    {
+        $request = $this->getRequestBodyFromParams($parameters);
+
+        $raw = $this->printfulClient->post('orders/estimate-costs', $request);
+
+        return OrderCostGroup::fromArray($raw);
+    }
+
     /**
      * Formats request body array from order creation parameters object
      *

src/Structures/Order/OrderCostGroup.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Printful\Structures\Order;
+
+class OrderCostGroup
+{
+    /** @var OrderCostsItem|null */
+    public $printfulCosts;
+
+    /** @var OrderCostsItem|null */
+    public $retailCosts;
+
+    /**
+     * @param array $raw
+     * @return OrderCostGroup
+     */
+    public static function fromArray(array $raw)
+    {
+        $orderCosts = new self;
+
+        $orderCosts->printfulCosts = !empty($raw['costs']) ? OrderCostsItem::fromArray($raw['costs']) : null;
+        $orderCosts->printfulCosts = !empty($raw['retail_costs']) ? OrderCostsItem::fromArray($raw['retail_costs']) : null;
+
+        return $orderCosts;
+    }
+}

tests/Order/OrderCreationAndRetrievalTest.php

@@ -3,6 +3,8 @@
 
 use Printful\PrintfulOrder;
 use Printful\Structures\Order\Order;
+use Printful\Structures\Order\OrderCostGroup;
+use Printful\Structures\Order\OrderCostsItem;
 use Printful\Structures\Order\OrderCreationParameters;
 use Printful\Structures\Order\OrderItemCreationParameters;
 use Printful\Structures\Order\OrderItemFile;
@@ -96,6 +98,18 @@ public function testOrderListCanBeRetrieved()
         self::assertInstanceOf(OrderList::class, $orderList, 'Order List retrieved');
     }
 
+    public function testOrderCostsCanBeEstimated()
+    {
+        $externalId = uniqid();
+        $params = $this->getTestOrderParams();
+        $params->externalId = $externalId;
+
+        $estimate = $this->printfulOrder->estimateCosts($params);
+
+        self::assertInstanceOf(OrderCostGroup::class, $estimate, 'Costs estimate retrieved');
+        self::assertInstanceOf(OrderCostsItem::class, $estimate->printfulCosts, 'Cost estimate correct type');
+    }
+
     /**
      * @return OrderCreationParameters
      */