refactor(exception): rename Exception to ApiException to avoid PHP built-in conflict

Author: francescobianco

CLAUDE.md

@@ -36,7 +36,7 @@ make dev-push
 
 ## Architecture Overview
 
-This is a minimal, agnostic PHP SDK for OpenAPI services with only essential HTTP primitives. The architecture follows a clean, simple design inspired by the Rust implementation found in `reference/openapi-rust-sdk/`.
+This is a minimal, agnostic PHP SDK for Openapi services with only essential HTTP primitives. The architecture follows a clean, simple design inspired by the Rust implementation found in `reference/openapi-rust-sdk/`.
 
 ### Core Components
 
@@ -60,7 +60,7 @@ This is a minimal, agnostic PHP SDK for OpenAPI services with only essential HTT
 
 ### Key Design Principles
 
-1. **Agnostic**: No API-specific classes - works with any OpenAPI service
+1. **Agnostic**: No API-specific classes - works with any Openapi service
 2. **Minimal**: Only core HTTP primitives, minimal dependencies (PHP 8.0+, cURL, JSON)
 3. **Clean Interface**: Simple method signatures following REST conventions
 4. **Environment Flexibility**: Built-in test/production environment switching

README.md

@@ -25,7 +25,7 @@ Before using the Openapi PHP Client, you will need an account at [Openapi](https
 
 ## Features
 
-- **Agnostic Design**: No API-specific classes, works with any OpenAPI service
+- **Agnostic Design**: No API-specific classes, works with any Openapi service
 - **Minimal Dependencies**: Only requires PHP 8.0+ and cURL
 - **OAuth Support**: Built-in OAuth client for token management  
 - **HTTP Primitives**: GET, POST, PUT, DELETE, PATCH methods

docs/contributing.md

@@ -52,4 +52,4 @@ To report bugs or request features, please **open an issue** on GitHub including
 - Steps to reproduce (if applicable).
 - Relevant logs or error output.
 
-Thank you for helping improve the OpenAPI PHP SDK!
+Thank you for helping improve the Openapi PHP SDK!

examples/complete_workflow.php

@@ -4,10 +4,10 @@
 
 use Openapi\OauthClient;
 use Openapi\Client;
-use Openapi\Exception;
+use Openapi\ApiException;
 
 try {
-    echo "=== OpenAPI PHP SDK Complete Workflow Example ===" . PHP_EOL . PHP_EOL;
+    echo "=== Openapi PHP SDK Complete Workflow Example ===" . PHP_EOL . PHP_EOL;
 
     // Step 1: Create OAuth client
     echo "Step 1: Creating OAuth client..." . PHP_EOL;
@@ -25,7 +25,7 @@
     $tokenData = json_decode($tokenResult, true);
 
     if (!isset($tokenData['token'])) {
-        throw new Exception('Failed to generate token: ' . $tokenResult);
+        throw new ApiException('Failed to generate token: ' . $tokenResult);
     }
 
     $token = $tokenData['token'];
@@ -62,7 +62,7 @@
 
     echo "=== Workflow completed successfully! ===" . PHP_EOL;
 
-} catch (Exception $e) {
+} catch (ApiException $e) {
     echo "✗ Error: " . $e->getMessage() . PHP_EOL;
 
     if ($e->getHttpCode()) {

src/Exception.php src/ApiException.phpsrc/Exception.php renamed to src/ApiException.php

@@ -2,7 +2,7 @@
 
 namespace Openapi;
 
-class Exception extends \Exception
+class ApiException extends \Exception
 {
     private mixed $serverResponse = null;
     private mixed $headers = null;

src/OauthClient.php

@@ -82,12 +82,12 @@ private function request(string $method, string $url, ?array $body = null): stri
 
         // TODO: Provide more graceful error message with connection context (timeout, DNS, SSL, etc.)
         if ($response === false) {
-            throw new Exception("cURL Error: " . $error);
+            throw new ApiException("cURL Error: " . $error);
         }
 
         // TODO: Parse response body and provide structured error details with auth-specific hints
         if ($httpCode >= 400) {
-            throw new Exception("HTTP Error {$httpCode}: " . $response);
+            throw new ApiException("HTTP Error {$httpCode}: " . $response);
         }
 
         return $response;

tests/ExceptionTest.php tests/ApiExceptionTest.phptests/ExceptionTest.php renamed to tests/ApiExceptionTest.php

@@ -1,24 +1,24 @@
 <?php
 
-use Openapi\Exception;
+use Openapi\ApiException;
 use PHPUnit\Framework\TestCase;
 
-final class ExceptionTest extends TestCase
+final class ApiExceptionTest extends TestCase
 {
-    public function testExceptionCreation(): void
+    public function testApiExceptionCreation(): void
     {
         $message = 'Test exception message';
         $code = 400;
 
-        $exception = new Exception($message, $code);
+        $exception = new ApiException($message, $code);
 
         $this->assertEquals($message, $exception->getMessage());
         $this->assertEquals($code, $exception->getCode());
     }
 
     public function testSetServerResponse(): void
     {
-        $exception = new Exception('Test message');
+        $exception = new ApiException('Test message');
 
         $response = ['error' => 'Server error'];
         $headers = 'Content-Type: application/json';