feat: add shipping information post endpoint

Author: ahinkle

src/Api/Carts.php

@@ -41,4 +41,17 @@ public function totalsInformation($body = [])
 
         return $this->post('/carts/mine/totals-information', $body);
     }
+
+    /**
+     * Save the total shipping information.
+     *
+     * @param  array  $body
+     * @return array
+     */
+    public function shippingInformation($body = [])
+    {
+        $this->validateSingleStoreCode();
+
+        return $this->post('/carts/mine/shipping-information', $body);
+    }
 }

src/Api/GuestCarts.php

@@ -86,4 +86,16 @@ public function totalsInformation($cartId, $body = [])
     {
         return $this->post('/guest-carts/'.$cartId.'/totals-information', $body);
     }
+
+    /**
+     * Save the total shipping information.
+     *
+     * @param  string $cartId
+     * @param  array  $body
+     * @return array
+     */
+    public function shippingInformation($cartId, $body = [])
+    {
+        return $this->post('/guest-carts/'.$cartId.'/shipping-information', $body);
+    }
 }

tests/Api/CartsTest.php

@@ -78,4 +78,26 @@ public function test_must_pass_a_single_store_code_to_totals_information()
         $magento = new Magento();
         $magento->api('carts')->totalsInformation([]);
     }
+
+    public function test_can_call_carts_shipping_information()
+    {
+        Http::fake([
+            '*rest/default/V1/carts/mine/shipping-information' => Http::response([], 200),
+        ]);
+
+        $magento = new Magento();
+        $magento->storeCode = 'default';
+
+        $api = $magento->api('carts')->shippingInformation([]);
+
+        $this->assertTrue($api->ok());
+    }
+
+    public function test_must_pass_a_single_store_code_to_shipping_information()
+    {
+        $this->expectException('exception');
+
+        $magento = new Magento();
+        $magento->api('carts')->shippingInformation([]);
+    }
 }

tests/Api/GuestCartsTest.php

@@ -95,4 +95,17 @@ public function test_can_call_guest_carts_totals_information()
 
         $this->assertTrue($api->ok());
     }
+
+    public function test_can_call_guest_carts_shipping_information()
+    {
+        Http::fake([
+            '*rest/all/V1/guest-carts/foo/shipping-information' => Http::response([], 200),
+        ]);
+
+        $magento = new Magento();
+
+        $api = $magento->api('guestCarts')->shippingInformation('foo');
+
+        $this->assertTrue($api->ok());
+    }
 }