add support for auth claims. (#8)

Co-authored-by: David Regimbal <dave@bitboss.org>

README.md

@@ -53,6 +53,21 @@ print_r($client->get('account'));
 ?>
 ```
 
+Making a Claims Request
+----------
+
+```php
+<?php
+// Instantiate.
+require __DIR__ . '/vendor/autoload.php';
+use OpenXBL\Auth;
+
+$auth = new Auth('YOUR_PUBLIC_KEY');
+
+$response = $auth->claim('CODE_VALUE');
+?>
+```
+
 Optional Parameters
 ----------
 ```php

src/Auth.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace OpenXBL;
+
+use GuzzleHttp\Client as GuzzleClient;
+use GuzzleHttp\Exception\GuzzleException;
+use OpenXBL\Models\ClaimsResponse;
+
+class Auth extends GuzzleClient
+{
+	private string $publicKey;
+	private string $baseUrl = 'https://xbl.io/app/';
+
+	public function __construct(string $publicKey)
+	{
+		$this->publicKey = $publicKey;
+		parent::__construct([
+			'base_uri' => $this->baseUrl,
+		]);
+	}
+
+	/**
+	 * @throws GuzzleException
+	 */
+	public function claim(string $code): ClaimsResponse
+	{
+		$options = [
+			'headers' => [
+				'Accept' => 'application/json',
+			],
+			'json' => [
+				'code' => $code,
+				'app_key' => $this->publicKey,
+			],
+		];
+
+		$request = $this->request('POST', 'claim', $options);
+
+		return new ClaimsResponse((string) $request->getBody());
+	}
+
+	public function getLoginUrl(): string
+	{
+		return "https://xbl.io/app/auth/{$this->publicKey}";
+	}
+}

src/HttpService.php

@@ -73,6 +73,6 @@ protected function request(): ?string
 
         $request = $this->client->request($this->method, $this->endpoint, $options);
 
-        return $request->getBody()->getContents();
+        return (string) $request->getBody();
 	}
 }

src/Models/ClaimsResponse.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace OpenXBL\Models;
+
+class ClaimsResponse
+{
+	public string $appKey;
+	public string $xuid;
+	public string $gamertag;
+	public string $email;
+	public ?string $avatar = null;
+
+	public function __construct(string $json) {
+		$json = json_decode($json, true);
+		foreach ($json as $key => $value) {
+			if (property_exists(__CLASS__, $key)) {
+				$this->$key = $value;
+			}
+		}
+	}
+}