Customer: add regenerate token endpoint

Author: glaubinix

README.md

@@ -82,6 +82,16 @@ $packageName = 'acme-website/package';
 $client->customers()->removePackage($customerId, $packageName);
 ```
 
+#### Regenerate a customer's Composer repository token
+```php
+$customerId = 42;
+$confirmation = [
+    'IConfirmOldTokenWillStopWorkingImmediately' => true,
+];
+$composerRepository = $client->customers()->regenerateToken($customerId, $confirmation);
+```
+Returns the updated Composer repository.
+
 #### Package
 
 ##### List an organization's packages

src/Api/Customers.php

@@ -41,4 +41,13 @@ public function removePackage($customerId, $packageName)
     {
         return $this->delete(sprintf('/customers/%s/packages/%s/', $customerId, $packageName));
     }
+
+    public function regenerateToken($customerId, array $confirmation)
+    {
+        if (!isset($confirmation['IConfirmOldTokenWillStopWorkingImmediately'])) {
+            throw new InvalidArgumentException('Confirmation is required to regenerate the Composer repository token.');
+        }
+
+        return $this->post(sprintf('/customers/%s/token/regenerate', $customerId), $confirmation);
+    }
 }

tests/Api/CustomersTest.php

@@ -129,6 +129,42 @@ public function testRemovePackage()
         $this->assertSame($expected, $api->removePackage(1, $packageName));
     }
 
+    public function testRegenerateToken()
+    {
+        $expected = [
+            'url' => 'https://repo.packagist.com/acme-website/',
+            'user' => 'token',
+            'token' => 'regenerated-token',
+            'lastUsed' => null,
+        ];
+
+        $confirmation = [
+            'IConfirmOldTokenWillStopWorkingImmediately' => true,
+        ];
+
+        /** @var Customers&\PHPUnit_Framework_MockObject_MockObject $api */
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with($this->equalTo('/customers/1/token/regenerate'), $this->equalTo($confirmation))
+            ->will($this->returnValue($expected));
+
+        $this->assertSame($expected, $api->regenerateToken(1, $confirmation));
+    }
+
+    /**
+     * @expectedException \PrivatePackagist\ApiClient\Exception\InvalidArgumentException
+     */
+    public function testRegenerateTokenMissingConfirmation()
+    {
+        /** @var Customers&\PHPUnit_Framework_MockObject_MockObject $api */
+        $api = $this->getApiMock();
+        $api->expects($this->never())
+            ->method('post');
+
+        $api->regenerateToken(1, []);
+    }
+
     protected function getApiClass()
     {
         return Customers::class;