API: Orders

src/Duffel/Api/Orders.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Duffel\Api;
+
+class Orders extends AbstractApi {
+  public function all() {
+    return $this->get('/air/orders');
+  }
+
+  public function show(string $id) {
+    return $this->get('/air/orders/'.self::encodePath($id));
+  }
+
+  public function create(array $params) {
+    return $this->post('/air/orders', \array_filter($params, function ($value) {
+      return null !== $value && (!\is_string($value) || '' !== $value);
+    }));
+  }
+}

src/Duffel/Client.php

@@ -9,6 +9,7 @@
 use Duffel\Api\Airports;
 use Duffel\Api\OfferRequests;
 use Duffel\Api\Offers;
+use Duffel\Api\Orders;
 use Duffel\Exception\InvalidAccessTokenException;
 use Duffel\HttpClient\Builder;
 use Http\Client\Common\HttpMethodsClientInterface;
@@ -63,6 +64,10 @@ public function offers(): Offers {
     return new Offers($this);
   }
 
+  public function orders(): Orders {
+    return new Orders($this);
+  }
+
   public function getAccessToken() {
     return $this->accessToken;
   }

tests/Duffel/Api/OrdersTest.php

@@ -0,0 +1,118 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Duffel\Tests\Api;
+
+use Duffel\Api\Orders;
+use Duffel\Client;
+use Http\Client\Common\HttpMethodsClientInterface;
+use PHPUnit\Framework\TestCase;
+
+class TestOrders extends TestCase {
+  private $mock;
+  private $stub;
+
+  public function setUp(): void {
+    $this->mock = $this->createMock(HttpMethodsClientInterface::class);
+    $this->stub = $this->createStub(Client::class);
+    $this->stub->method('getHttpClient')
+               ->willReturn($this->mock);
+  }
+
+  public function testAllCallsGetWithExpectedUri(): void {
+    $this->mock->expects($this->once())
+               ->method('get')
+               ->with($this->equalTo('/air/orders'));
+
+    $actual = new Orders($this->stub);
+    $actual->all();
+  }
+
+  public function testShowWithIdCallsGetWithExpectedUri(): void {
+    $this->mock->expects($this->once())
+               ->method('get')
+               ->with($this->equalTo('/air/orders/some-id'));
+
+    $actual = new Orders($this->stub);
+    $actual->show('some-id');
+  }
+
+  public function testCreateWithOfferAndPassengersAndPaymentsCallsGetWithExpectedUri(): void {
+    $this->mock->expects($this->once())
+               ->method('post')
+               ->with(
+                 $this->equalTo('/air/orders'),
+                 $this->equalTo(['Content-Type' => 'application/json']),
+                 $this->equalTo('{"data":{"selected_offers":"off_00009htyDGjIfajdNBZRlw","payments":[{"type":"balance","amount":"30.20","currency":"GBP"}],"passengers":[{"id":"pas_00009hj8USM7Ncg31cBCLL","title":"ms","gender":"f","given_name":"Amelia","family_name":"Earhart","born_on":"1987-07-24","phone_number":"+442080160509","email":"amelia@duffel.dev"}]}}')
+               );
+
+    $actual = new Orders($this->stub);
+    $actual->create(
+      [
+        'selected_offers' => 'off_00009htyDGjIfajdNBZRlw',
+        'payments' => [
+          [
+            'type' => 'balance',
+            'amount' => '30.20',
+            'currency' => 'GBP'
+          ]
+        ],
+        'passengers' => [
+          [
+            'id' => 'pas_00009hj8USM7Ncg31cBCLL',
+            'title' => 'ms',
+            'gender' => 'f',
+            'given_name' => 'Amelia',
+            'family_name' => 'Earhart',
+            'born_on' => '1987-07-24',
+            'phone_number' => '+442080160509',
+            'email' => 'amelia@duffel.dev',
+          ]
+        ]
+      ]
+    );
+  }
+
+  public function testCreateWithOfferAndServicesAndPassengersAndPaymentsCallsGetWithExpectedUri(): void {
+    $this->mock->expects($this->once())
+               ->method('post')
+               ->with(
+                 $this->equalTo('/air/orders'),
+                 $this->equalTo(['Content-Type' => 'application/json']),
+                 $this->equalTo('{"data":{"selected_offers":"off_00009htyDGjIfajdNBZRlw","services":[{"id":"ase_00009hj8USM7Ncg31cB123","quantity":1}],"payments":[{"type":"balance","amount":"30.20","currency":"GBP"}],"passengers":[{"id":"pas_00009hj8USM7Ncg31cBCLL","title":"ms","gender":"f","given_name":"Amelia","family_name":"Earhart","born_on":"1987-07-24","phone_number":"+442080160509","email":"amelia@duffel.dev"}]}}')
+               );
+
+    $actual = new Orders($this->stub);
+    $actual->create(
+      [
+        'selected_offers' => 'off_00009htyDGjIfajdNBZRlw',
+        'services' => [
+          [
+            'id' => 'ase_00009hj8USM7Ncg31cB123',
+            "quantity" => 1,
+          ]
+        ],
+        'payments' => [
+          [
+            'type' => 'balance',
+            'amount' => '30.20',
+            'currency' => 'GBP'
+          ]
+        ],
+        'passengers' => [
+          [
+            'id' => 'pas_00009hj8USM7Ncg31cBCLL',
+            'title' => 'ms',
+            'gender' => 'f',
+            'given_name' => 'Amelia',
+            'family_name' => 'Earhart',
+            'born_on' => '1987-07-24',
+            'phone_number' => '+442080160509',
+            'email' => 'amelia@duffel.dev',
+          ]
+        ]
+      ]
+    );
+  }
+}

tests/Duffel/ClientTest.php

@@ -9,6 +9,7 @@
 use Duffel\Api\Airports;
 use Duffel\Api\OfferRequests;
 use Duffel\Api\Offers;
+use Duffel\Api\Orders;
 use Duffel\Client;
 use Duffel\Exception\InvalidAccessTokenException;
 use Duffel\HttpClient\Builder;
@@ -57,6 +58,10 @@ public function testOffersUsesApiClass(): void {
     $this->assertInstanceOf(Offers::class, $this->subject->offers());
   }
 
+  public function testOrdersUsesApiClass(): void {
+    $this->assertInstanceOf(Orders::class, $this->subject->orders());
+  }
+
   public function testSetAccessTokenChangesValue(): void {
     $this->subject->setAccessToken('some-token');