feat: add unittests

tests/AbstractTestCase.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace DarthSoup\Tests\Whmcs;
 
 use DarthSoup\Whmcs\Facades\Whmcs;
@@ -21,7 +23,7 @@ protected function getPackageAliases($app)
     /**
      * Define environment setup.
      *
-     * @param  \Illuminate\Foundation\Application  $app
+     * @param \Illuminate\Foundation\Application $app
      * @return void
      */
     protected function getEnvironmentSetUp($app)

tests/Auth/AuthFactoryTest.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DarthSoup\Tests\Whmcs\Auth;
+
+use DarthSoup\Whmcs\Auth\AuthFactory;
+use DarthSoup\Whmcs\Auth\Method\PasswordAuth;
+use DarthSoup\Whmcs\Auth\Method\TokenAuth;
+use InvalidArgumentException;
+use PHPUnit\Framework\TestCase;
+
+class AuthFactoryTest extends TestCase
+{
+    protected AuthFactory $factory;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->factory = new AuthFactory();
+    }
+
+    public function testMakePasswordAuth()
+    {
+        $method = $this->factory->make('password');
+
+        $this->assertInstanceOf(PasswordAuth::class, $method);
+    }
+
+    public function testMakeTokenAuth()
+    {
+        $method = $this->factory->make('token');
+
+        $this->assertInstanceOf(TokenAuth::class, $method);
+    }
+
+    public function testMakeInvalidAuth()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('Unsupported authentication method [fail].');
+
+        $this->factory->make('fail');
+    }
+}

tests/Auth/Method/PasswordAuthTest.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DarthSoup\Tests\Whmcs\Auth\Method;
+
+use DarthSoup\Whmcs\Auth\Method\PasswordAuth;
+use DarthSoup\WhmcsApi\Client;
+use InvalidArgumentException;
+use Mockery;
+use PHPUnit\Framework\TestCase;
+
+class PasswordAuthTest extends TestCase
+{
+    protected PasswordAuth $auth;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->auth = new PasswordAuth();
+    }
+
+    public function testMakeWithMethod()
+    {
+        $client = Mockery::mock(Client::class);
+        $client->shouldReceive('authenticate')
+            ->once()->with('identifier', 'secret', Client::AUTH_LOGIN_CREDENTIALS);
+
+        $auth = $this->auth
+            ->with($client)
+            ->authenticate([
+                'username' => 'identifier',
+                'password' => 'secret',
+            ]);
+
+        $this->assertInstanceOf(Client::class, $auth);
+    }
+
+    public function testWithoutUsername()
+    {
+        $client = Mockery::mock(Client::class);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The password authenticator requires a username.');
+
+        $this->auth->with($client)->authenticate([]);
+    }
+
+    public function testWithoutPassword()
+    {
+        $client = Mockery::mock(Client::class);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The password authenticator requires a password.');
+
+        $this->auth->with($client)->authenticate(['username' => 'foo']);
+    }
+
+    public function testMakeWithoutSettingClient()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The client instance was not given to the auth process.');
+
+        $this->auth->authenticate([
+            'username' => 'foo',
+            'password' => 'bar',
+        ]);
+    }
+
+}

tests/Auth/Method/TokenAuthTest.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DarthSoup\Tests\Whmcs\Auth\Method;
+
+use DarthSoup\Whmcs\Auth\Method\TokenAuth;
+use DarthSoup\WhmcsApi\Client;
+use InvalidArgumentException;
+use Mockery;
+use PHPUnit\Framework\TestCase;
+
+class TokenAuthTest extends TestCase
+{
+    protected TokenAuth $auth;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->auth = new TokenAuth();
+    }
+
+    public function testMakeWithMethod()
+    {
+        $client = Mockery::mock(Client::class);
+        $client->shouldReceive('authenticate')
+            ->once()->with('identifier', 'secret', Client::AUTH_API_CREDENTIALS);
+
+        $auth = $this->auth
+            ->with($client)
+            ->authenticate([
+                'identifier' => 'identifier',
+                'secret' => 'secret',
+            ]);
+
+        $this->assertInstanceOf(Client::class, $auth);
+    }
+
+    public function testWithoutUsername()
+    {
+        $client = Mockery::mock(Client::class);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The token authenticator requires a identifier.');
+
+        $this->auth->with($client)->authenticate([]);
+    }
+
+    public function testWithoutPassword()
+    {
+        $client = Mockery::mock(Client::class);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The token authenticator requires a secret.');
+
+        $this->auth->with($client)->authenticate(['identifier' => 'foo']);
+    }
+
+    public function testMakeWithoutSettingClient()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The client instance was not given to the auth process.');
+
+        $this->auth->authenticate([
+            'identifier' => 'foo',
+            'secret' => 'bar',
+        ]);
+    }
+
+}

tests/ServiceProviderTest.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace DarthSoup\Tests\Whmcs;
 
 use DarthSoup\Whmcs\Auth\AuthFactory;

tests/WhmcsFactoryTest.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DarthSoup\Tests\Whmcs;
+
+use DarthSoup\Whmcs\Auth\AuthFactory;
+use DarthSoup\Whmcs\WhmcsFactory;
+use DarthSoup\WhmcsApi\Client;
+use Http\Client\Common\HttpMethodsClientInterface;
+use InvalidArgumentException;
+
+class WhmcsFactoryTest extends AbstractTestCase
+{
+    protected WhmcsFactory $factory;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->factory = new WhmcsFactory(new AuthFactory());
+    }
+
+    public function testMakeConnectionWithMethod()
+    {
+        $client = $this->factory->make([
+            'method' => 'token',
+            'identifier' => 'foo',
+            'secret' => 'bar',
+            'url' => 'https://whmcs.example.com/includes/api.php'
+        ]);
+
+        $this->assertInstanceOf(Client::class, $client);
+        $this->assertInstanceOf(HttpMethodsClientInterface::class, $client->getHttpClient());
+    }
+
+    public function testWithoutMethod()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The whmcs factory requires an auth method');
+
+        $this->factory->make([]);
+    }
+}

tests/WhmcsManagerTest.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DarthSoup\Tests\Whmcs;
+
+use DarthSoup\Whmcs\WhmcsFactory;
+use DarthSoup\Whmcs\WhmcsManager;
+use DarthSoup\WhmcsApi\Client;
+use Illuminate\Contracts\Config\Repository;
+use Mockery;
+
+class WhmcsManagerTest extends AbstractTestCase
+{
+    public function testCreateConnection()
+    {
+        $configRepository = Mockery::mock(Repository::class);
+        $factory = Mockery::mock(WhmcsFactory::class);
+        $manager = new WhmcsManager($configRepository, $factory);
+
+        $config = ['token' => 'your-token'];
+        $config['name'] = 'primary';
+
+        $manager->getConfig()->shouldReceive('get')->once()
+            ->with('whmcs.connections')->andReturn(['primary' => $config]);
+        $manager->getFactory()->shouldReceive('make')->once()
+            ->with($config)->andReturn(Mockery::mock(Client::class));
+        $manager->getConfig()->shouldReceive('get')->once()
+            ->with('whmcs.default')->andReturn('primary');
+
+        $this->assertSame([], $manager->getConnections());
+
+        $return = $manager->connection();
+        $this->assertInstanceOf(Client::class, $return);
+        $this->assertArrayHasKey('primary', $manager->getConnections());
+    }
+}