feat: add all test files

Author: walmir-silva

src/AbstractException.php

@@ -13,8 +13,10 @@ abstract class AbstractException extends \Exception implements Throwable
 
     public function __construct(ErrorMessage $errorMessage, ?\Throwable $previous = null, array $context = [])
     {
+
+        $this->context = array_merge(['code' => $errorMessage->getCode()], $context);
+
         parent::__construct($errorMessage->getMessage(), 0, $previous);
-        $this->context = $context;
     }
 
     public function getContext(): array

src/Contract/ErrorMessage.php

@@ -6,7 +6,9 @@
 
 interface ErrorMessage
 {
-    public function getCode(): string;
+    public function getCode(): int;
+
+    public function getErrorCode(): string;
 
     public function getMessage(): string;
 }

src/ExceptionMessage.php

@@ -9,16 +9,22 @@
 final class ExceptionMessage implements ErrorMessage
 {
     public function __construct(
-        private readonly string $code,
+        private readonly int $code,
+        private readonly string $errorCode,
         private readonly string $message
     ) {
     }
 
-    public function getCode(): string
+    public function getCode(): int
     {
         return $this->code;
     }
 
+    public function getErrorCode(): string
+    {
+        return $this->errorCode;
+    }
+
     public function getMessage(): string
     {
         return $this->message;

tests/AbstractErrorMessageTest.php

@@ -1,3 +1,69 @@
 <?php
 
 declare(strict_types=1);
+
+namespace KaririCode\Exception\Tests;
+
+use KaririCode\Exception\AbstractException;
+use KaririCode\Exception\ExceptionMessage;
+use PHPUnit\Framework\TestCase;
+
+class AbstractExceptionTest extends TestCase
+{
+    private ConcreteTestException $exception;
+
+    protected function setUp(): void
+    {
+        $errorMessage = new ExceptionMessage('TEST_CODE', 'Test message');
+        $this->exception = new ConcreteTestException($errorMessage);
+    }
+
+    public function testExceptionCreation(): void
+    {
+        $this->assertSame('Test message', $this->exception->getMessage());
+        $this->assertSame(['code' => 'TEST_CODE'], $this->exception->getContext());
+    }
+
+    public function testExceptionWithContext(): void
+    {
+        $errorMessage = new ExceptionMessage('TEST_CODE', 'Test message');
+        $context = ['key' => 'value'];
+        $exception = new ConcreteTestException($errorMessage, null, $context);
+
+        $this->assertSame(['code' => 'TEST_CODE', 'key' => 'value'], $exception->getContext());
+    }
+
+    public function testAddContext(): void
+    {
+        $this->exception->addTestContext('newKey', 'newValue');
+
+        $expectedContext = ['code' => 'TEST_CODE', 'newKey' => 'newValue'];
+        $this->assertSame($expectedContext, $this->exception->getContext());
+    }
+
+    public function testExceptionWithPrevious(): void
+    {
+        $previousException = new \Exception('Previous exception');
+        $errorMessage = new ExceptionMessage('TEST_CODE', 'Test message');
+        $exception = new ConcreteTestException($errorMessage, $previousException);
+
+        $this->assertSame($previousException, $exception->getPrevious());
+    }
+
+    protected function assertExceptionStructure(AbstractException $exception, string $expectedCode, string $expectedMessage): void
+    {
+        $this->assertInstanceOf(AbstractException::class, $exception);
+        $this->assertSame($expectedMessage, $exception->getMessage());
+        $this->assertArrayHasKey('code', $exception->getContext());
+        $this->assertSame($expectedCode, $exception->getContext()['code']);
+    }
+}
+
+// Concrete implementation of AbstractException for testing
+final class ConcreteTestException extends AbstractException
+{
+    public function addTestContext(string $key, mixed $value): self
+    {
+        return $this->addContext($key, $value);
+    }
+}

tests/AbstractExceptionTest.php

@@ -1,3 +1,29 @@
 <?php
 
 declare(strict_types=1);
+
+namespace KaririCode\Exception\Tests\Auth;
+
+use KaririCode\Exception\Auth\AuthenticationException;
+use KaririCode\Exception\Tests\AbstractExceptionTest;
+
+final class AuthenticationExceptionTest extends AbstractExceptionTest
+{
+    public function testInvalidCredentials(): void
+    {
+        $exception = AuthenticationException::invalidCredentials();
+        $this->assertExceptionStructure($exception, 'INVALID_CREDENTIALS', 'Invalid credentials provided');
+    }
+
+    public function testAccountLocked(): void
+    {
+        $exception = AuthenticationException::accountLocked();
+        $this->assertExceptionStructure($exception, 'ACCOUNT_LOCKED', 'Account is locked');
+    }
+
+    public function testTwoFactorRequired(): void
+    {
+        $exception = AuthenticationException::twoFactorRequired();
+        $this->assertExceptionStructure($exception, 'TWO_FACTOR_REQUIRED', 'Two-factor authentication is required');
+    }
+}

tests/Auth/AuthenticationExceptionTest.php

@@ -1,3 +1,25 @@
 <?php
 
 declare(strict_types=1);
+
+namespace KaririCode\Exception\Tests\Auth;
+
+use KaririCode\Exception\Auth\AuthorizationException;
+use KaririCode\Exception\Tests\AbstractExceptionTest;
+
+final class AuthorizationExceptionTest extends AbstractExceptionTest
+{
+    public function testInsufficientPermissions(): void
+    {
+        $action = 'delete_user';
+        $exception = AuthorizationException::insufficientPermissions($action);
+        $this->assertExceptionStructure($exception, 'INSUFFICIENT_PERMISSIONS', "Insufficient permissions for action: {$action}");
+    }
+
+    public function testRoleRequired(): void
+    {
+        $role = 'admin';
+        $exception = AuthorizationException::roleRequired($role);
+        $this->assertExceptionStructure($exception, 'ROLE_REQUIRED', "Required role not present: {$role}");
+    }
+}

tests/Auth/AuthorizationExceptionTest.php

@@ -1,3 +1,32 @@
 <?php
 
 declare(strict_types=1);
+
+namespace KaririCode\Exception\Tests\Cache;
+
+use KaririCode\Exception\Cache\CacheException;
+use KaririCode\Exception\Tests\AbstractExceptionTest;
+
+final class CacheExceptionTest extends AbstractExceptionTest
+{
+    public function testItemNotFound(): void
+    {
+        $key = 'user_profile_1';
+        $exception = CacheException::itemNotFound($key);
+        $this->assertExceptionStructure($exception, 'CACHE_ITEM_NOT_FOUND', "Cache item not found: {$key}");
+    }
+
+    public function testStorageError(): void
+    {
+        $details = 'Redis connection failed';
+        $exception = CacheException::storageError($details);
+        $this->assertExceptionStructure($exception, 'CACHE_STORAGE_ERROR', "Cache storage error: {$details}");
+    }
+
+    public function testInvalidTtl(): void
+    {
+        $ttl = -1;
+        $exception = CacheException::invalidTtl($ttl);
+        $this->assertExceptionStructure($exception, 'INVALID_TTL', "Invalid TTL value: {$ttl}");
+    }
+}

tests/Cache/CacheExceptionTest.php

@@ -1,3 +1,33 @@
 <?php
 
 declare(strict_types=1);
+
+namespace KaririCode\Exception\Tests\Config;
+
+use KaririCode\Exception\Config\ConfigurationException;
+use KaririCode\Exception\Tests\AbstractExceptionTest;
+
+final class ConfigurationExceptionTest extends AbstractExceptionTest
+{
+    public function testMissingKey(): void
+    {
+        $key = 'database.host';
+        $exception = ConfigurationException::missingKey($key);
+        $this->assertExceptionStructure($exception, 'MISSING_CONFIG_KEY', "Missing configuration key: {$key}");
+    }
+
+    public function testInvalidValue(): void
+    {
+        $key = 'app.debug';
+        $value = 'not_a_boolean';
+        $exception = ConfigurationException::invalidValue($key, $value);
+        $this->assertExceptionStructure($exception, 'INVALID_CONFIG_VALUE', "Invalid configuration value for key '{$key}': " . var_export($value, true));
+    }
+
+    public function testEnvironmentNotSet(): void
+    {
+        $envVar = 'APP_KEY';
+        $exception = ConfigurationException::environmentNotSet($envVar);
+        $this->assertExceptionStructure($exception, 'ENVIRONMENT_NOT_SET', "Environment variable not set: {$envVar}");
+    }
+}