error code constants

README.md

@@ -19,7 +19,8 @@ $ composer require graze/gigya-client
 
 ``` php
 $client = new \Graze\Gigya\Gigya($key, $secret, Gigya::DC_EU);
-$account = $client->accounts()->getAccountInfo(['uid' => $uid]);
+$response = $client->accounts()->getAccountInfo(['uid' => $uid]);
+$account = $response->getData();
 ```
 
 ## Change log

src/Endpoints/Client.php

@@ -38,6 +38,16 @@ class Client
      */
     protected $options;
 
+    /**
+     * @var string
+     */
+    protected $namespace;
+
+    /**
+     * @var string
+     */
+    protected $certificate;
+
     /**
      * @param string $namespace
      * @param array  $params [:apiKey,:secret,:userKey]

src/Exceptions/ResponseException.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Graze\Gigya\Exceptions;
+
+use Exception;
+use Graze\Gigya\Response\ResponseInterface;
+use RuntimeException;
+
+/**
+ * Class ResponseException
+ *
+ * Generic Response Exception
+ *
+ * @package Graze\Gigya\Exceptions
+ */
+class ResponseException extends RuntimeException
+{
+    /**
+     * @var ResponseInterface
+     */
+    protected $response;
+
+    /**
+     * @param ResponseInterface $response
+     * @param string            $message
+     * @param Exception|null    $previous
+     */
+    public function __construct(ResponseInterface $response, $message = '', Exception $previous = null)
+    {
+        $this->response = $response;
+
+        $message = (($message) ? $message . "\n" : '') .
+            $response;
+
+        parent::__construct($message, $response->getErrorCode(), $previous);
+    }
+
+    /**
+     * @return ResponseInterface
+     */
+    public function getResponse()
+    {
+        return $this->response;
+    }
+}

src/Response/Response.php

@@ -58,6 +58,11 @@ class Response implements ResponseInterface
      */
     protected $data;
 
+    /**
+     * @var GuzzleResponseInterface
+     */
+    protected $response;
+
     /**
      * @param GuzzleResponseInterface $response
      */
@@ -164,4 +169,21 @@ public function getOriginalResponse()
     {
         return $this->response;
     }
+
+    /**
+     * @return string
+     */
+    public function __toString()
+    {
+        return sprintf(
+            "Response: %d: %s - %d: %s\n%s\n%s\n%s",
+            $this->getStatusCode(),
+            $this->getStatusReason(),
+            $this->getErrorCode(),
+            ErrorCode::getName($this->getErrorCode()),
+            ErrorCode::getDescription($this->getErrorCode()),
+            $this->getErrorMessage(),
+            $this->getErrorDetails()
+        );
+    }
 }

src/Response/ResponseInterface.php

@@ -54,4 +54,9 @@ public function getData();
      * @return GuzzleResponseInterface
      */
     public function getOriginalResponse();
+
+    /**
+     * @return string
+     */
+    public function __toString();
 }

tests/unit/Exception/ResponseExceptionTest.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Graze\Gigya\Test\Unit\Exception;
+
+use Graze\Gigya\Exceptions\ResponseException;
+use Graze\Gigya\Response\ResponseInterface;
+use Graze\Gigya\Test\TestCase;
+use Mockery as m;
+
+class ResponseExceptionTest extends TestCase
+{
+    public function testInstanceOfRuntimeException()
+    {
+        $response = m::mock(ResponseInterface::class);
+        $response->shouldReceive('getErrorCode')
+                 ->andReturn(0);
+        $exception = new ResponseException($response);
+
+        static::assertInstanceOf('RuntimeException', $exception);
+    }
+
+    public function testExceptionIncludeResponseStringAndCode()
+    {
+        $response = m::mock(ResponseInterface::class);
+        $response->shouldReceive('getErrorCode')
+                 ->andReturn(100001);
+        $response->shouldReceive('__toString')
+                 ->andReturn('some description from the response');
+        $exception = new ResponseException($response);
+
+        static::setExpectedException(
+            ResponseException::class,
+            'some description from the response',
+            100001
+        );
+
+        throw $exception;
+    }
+
+    public function testGetResponse()
+    {
+        $response = m::mock(ResponseInterface::class);
+        $response->shouldReceive('getErrorCode')
+                 ->andReturn(100001);
+        $exception = new ResponseException($response);
+
+        static::assertSame($response, $exception->getResponse());
+    }
+}

tests/unit/Response/ErrorCodeTest.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Graze\Gigya\Test\Unit\Response;
+
+use Graze\Gigya\Response\ErrorCode;
+use Graze\Gigya\Test\TestCase;
+
+class ErrorCodeTest extends TestCase
+{
+    public function testGetName()
+    {
+        static::assertEquals('Session migration error', ErrorCode::getName(ErrorCode::ERROR_SESSION_MIGRATION_ERROR));
+        static::assertEquals('Invalid Secret', ErrorCode::getName(ErrorCode::ERROR_INVALID_SECRET));
+    }
+
+    public function testGetNameWithUnknownErrorCodeWillReturnNull()
+    {
+        static::assertNull(ErrorCode::getName(3271863217367182));
+    }
+
+    public function testGetDescription()
+    {
+        static::assertEquals(
+            'When accounts.login, accounts.socialLogin, accounts.finalizeRegistration, socialize.notifyLogin, or socialize.login is called and the policy (in the site Policies) requires 2-factor authentication, and the device is not already in the verified device list for the account. The first time the method is called, the device needs to be registered, and for the following calls, the device needs to be verified.',
+            ErrorCode::getDescription(ErrorCode::ERROR_ACCOUNT_PENDING_TFA_VERIFICATION)
+        );
+        static::assertEquals(
+            'If Protect Against Account Harvesting policy is enabled and neither Email Validation nor CAPTCHA Validation policies are enabled.',
+            ErrorCode::getDescription(ErrorCode::ERROR_INVALID_POLICY_CONFIGURATION)
+        );
+    }
+
+    public function testGetDescriptionWithUnknownErrorCodeWillReturnNull()
+    {
+        static::assertNull(ErrorCode::getDescription(3271863217367182));
+    }
+}

tests/unit/Response/ResponseTest.php

@@ -5,6 +5,9 @@
 use DateTime;
 use Graze\Gigya\Response\Response;
 use Graze\Gigya\Test\TestCase;
+use Graze\Gigya\Test\TestFixtures;
+use GuzzleHttp\Message\ResponseInterface as GuzzleResponseInterface;
+use Mockery as m;
 
 class ResponseTest extends TestCase
 {
@@ -42,4 +45,22 @@ public function testOtherTimeZoneFormat()
         static::assertEquals("943000", $time->format('u'));
         static::assertEquals("+02:00", $time->getTimezone()->getName());
     }
+
+    public function testToString()
+    {
+        $guzzleResponse = m::mock(GuzzleResponseInterface::class);
+        $guzzleResponse->shouldReceive('getBody')->andReturn(TestFixtures::getFixture('accounts.getAccountInfo'));
+        $response = new Response($guzzleResponse);
+
+        static::assertRegExp('/Response: \d+: \w+ - \d+: .+\n.+/s', $response->__toString());
+    }
+
+    public function testToStringForFailure()
+    {
+        $guzzleResponse = m::mock(GuzzleResponseInterface::class);
+        $guzzleResponse->shouldReceive('getBody')->andReturn(TestFixtures::getFixture('failure_403'));
+        $response = new Response($guzzleResponse);
+
+        static::assertRegExp('/Response: \d+: \w+ - \d+: .+\n.+\n.+\n.+/s', $response->__toString());
+    }
 }