Add option to send contact first and last names instead of a single string

Author: joshbmarshall

README.md

@@ -25,7 +25,9 @@ Get a business account at Australia Post and request API access
 
 	$shipment = $auspost->newShipment()
 		->setFrom(new \Cognito\Auspost\Address([
-			'name' => 'Joe Tester',
+			'first_name' => 'Joe',
+			'last_name' => 'Tester',
+			// OR 'name' => 'Joe Tester',
 			'lines' => [
 				'11 MyStreetname Court',
 			],
@@ -35,7 +37,8 @@ Get a business account at Australia Post and request API access
 			'country' => 'AU',
 		]))
 		->setTo(new \Cognito\Auspost\Address([
-			'name' => 'Mary Tester',
+			'first_name' => 'Mary',
+			'last_name' => 'Tester',
 			'lines' => [
 				'10 ReceiverStreetname St',
 			],

src/Address.php

@@ -9,6 +9,8 @@
  * @author Josh Marshall <josh@jmarshall.com.au>
  *
  * @property string $type
+ * @property string $first_name
+ * @property string $last_name
  * @property string $name
  * @property string $business_name
  * @property string[] $lines
@@ -22,6 +24,8 @@
 class Address {
 
     public $type          = '';
+    public $first_name    = '';
+    public $last_name     = '';
     public $name          = '';
     public $business_name = '';
     public $lines         = [];
@@ -41,5 +45,18 @@ public function __construct($details = []) {
             }
             $this->$key = $data;
         }
+        if (!$this->name) {
+            $this->name = trim($this->first_name . ' ' . $this->last_name);
+        }
+        if (!$this->first_name) {
+            $parts = explode(' ', $this->name, 2);
+            if (count($parts) > 1) {
+                $this->first_name = $parts[0];
+                $this->last_name = $parts[1];
+            } else {
+                $this->first_name = $this->name;
+                $this->last_name = $this->name;
+            }
+        }
     }
 }

src/Auspost.php

@@ -470,7 +470,7 @@ private function closeSocket() {
 	/**
 	 * Convert the lines of response data into an associative array.
 	 *
-	 * @param array $data lines of response data
+	 * @param string $data lines of response data
 	 * @return array associative array
 	 */
 	private function convertResponse($data) {