feat: integrate transport layer, DotEnv support and Openapi namespace from upkeep

- Rename namespace from OpenApi\ to Openapi\ across all classes
- Replace Client with OpenapiClient supporting injectable HTTP transport
- Add OpenapiCurlTransport as default cURL-based transport
- Add OpenapiHttpTransportInterface for custom client injection (Guzzle, PSR-18)
- Add OpenapiDotEnv for lightweight .env loading without framework dependencies
- Add OpenapiBootstrap for automatic .env loading via Composer files autoload
- Rename OauthClient → OpenapiOauthClient with env var fallback for credentials
- Rename Exception → OpenapiException, CacheInterface → OpenapiCacheInterface
- Rename ArrayCache → OpenapiArrayCache
- Add phpunit.xml.dist with env fixtures for unit tests
- Add OpenapiClientTest with fake transport for isolated unit testing
- Add psr/http-client dependency

Co-authored-by: Mario Ugurcu <mario.ugurcu@wum-studios.de>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 3 people

composer.json

@@ -1,33 +1,42 @@
-{
-    "name": "openapi/openapi-sdk",
-    "description": "Minimal and agnostic PHP SDK for Openapi® (https://openapi.com)",
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Altravia",
-            "email": "info@altravia.com"
-        }
-    ],
-    "minimum-stability": "stable",
-    "require": {
-        "php": ">=8.0.0",
-        "ext-curl": "*",
-        "ext-json": "*"
-    },
-    "require-dev": {
-        "symfony/dotenv": "^5.3",
-        "phpunit/phpunit": "^9.5"
-    },
-    "autoload": {
-        "psr-4": {
-            "OpenApi\\": "src"
-        }
-    },
-    "scripts": {
-        "test": "phpunit tests/",
-        "test:unit": "phpunit tests/ --testsuite=unit",
-        "example:token": "php examples/token_generation.php",
-        "example:api": "php examples/api_calls.php",
-        "example:complete": "php examples/complete_workflow.php"
-    }
-}
+{
+    "name": "openapi/openapi-sdk",
+    "description": "Minimal and agnostic PHP SDK for Openapi® (https://openapi.com)",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Altravia",
+            "email": "info@altravia.com"
+        }
+    ],
+    "minimum-stability": "stable",
+    "require": {
+        "php": ">=8.0.0",
+        "ext-curl": "*",
+        "ext-json": "*",
+        "psr/http-client": "^1.0"
+    },
+    "require-dev": {
+        "symfony/dotenv": "^5.3",
+        "phpunit/phpunit": "^9.5"
+    },
+    "autoload": {
+        "psr-4": {
+            "Openapi\\": "src"
+        },
+        "files": [
+            "src/OpenapiBootstrap.php"
+        ]
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests"
+        }
+    },
+    "scripts": {
+        "test": "phpunit tests/",
+        "test:unit": "phpunit tests/ --testsuite=unit",
+        "example:token": "php examples/token_generation.php",
+        "example:api": "php examples/api_calls.php",
+        "example:complete": "php examples/complete_workflow.php"
+    }
+}

examples/api_calls.php

@@ -2,16 +2,16 @@
 
 require_once __DIR__ . '/../vendor/autoload.php';
 
-use OpenApi\Client;
+use Openapi\OpenapiClient;
 
 try {
     $token = '<your_access_token>';
-    $client = new Client($token);
+    $client = new OpenapiClient($token);
 
     // GET request with parameters
     $params = [
         'denominazione' => 'altravia',
-        'provincia' => 'RM', 
+        'provincia' => 'RM',
         'codice_ateco' => '6201'
     ];
 
@@ -31,4 +31,4 @@
 
 } catch (Exception $e) {
     echo "Error: " . $e->getMessage() . PHP_EOL;
-}
+}

examples/complete_workflow.php

@@ -2,16 +2,16 @@
 
 require_once __DIR__ . '/../vendor/autoload.php';
 
-use OpenApi\OauthClient;
-use OpenApi\Client;
-use OpenApi\Exception;
+use Openapi\OpenapiOauthClient;
+use Openapi\OpenapiClient;
+use Openapi\OpenapiException;
 
 try {
     echo "=== OpenAPI PHP SDK Complete Workflow Example ===" . PHP_EOL . PHP_EOL;
 
     // Step 1: Create OAuth client
     echo "Step 1: Creating OAuth client..." . PHP_EOL;
-    $oauthClient = new OauthClient('<your_username>', '<your_apikey>', true);
+    $oauthClient = new OpenapiOauthClient('<your_username>', '<your_apikey>', true);
     echo "✓ OAuth client created" . PHP_EOL . PHP_EOL;
 
     // Step 2: Generate token
@@ -25,15 +25,15 @@
     $tokenData = json_decode($tokenResult, true);
 
     if (!isset($tokenData['token'])) {
-        throw new Exception('Failed to generate token: ' . $tokenResult);
+        throw new OpenapiException('Failed to generate token: ' . $tokenResult);
     }
 
     $token = $tokenData['token'];
     echo "✓ Token generated: " . substr($token, 0, 20) . "..." . PHP_EOL . PHP_EOL;
 
     // Step 3: Create API client
     echo "Step 3: Creating API client..." . PHP_EOL;
-    $apiClient = new Client($token);
+    $apiClient = new OpenapiClient($token);
     echo "✓ API client created" . PHP_EOL . PHP_EOL;
 
     // Step 4: Make API calls
@@ -49,7 +49,7 @@
     $getResponse = $apiClient->get('https://test.imprese.openapi.it/advance', $getParams);
     echo "  ✓ GET response received (" . strlen($getResponse) . " bytes)" . PHP_EOL;
 
-    // POST request  
+    // POST request
     echo "  → Making POST request..." . PHP_EOL;
     $postPayload = [
         'limit' => 10,
@@ -62,14 +62,14 @@
 
     echo "=== Workflow completed successfully! ===" . PHP_EOL;
 
-} catch (Exception $e) {
+} catch (OpenapiException $e) {
     echo "✗ Error: " . $e->getMessage() . PHP_EOL;
-    
+
     if ($e->getHttpCode()) {
         echo "  HTTP Code: " . $e->getHttpCode() . PHP_EOL;
     }
-    
+
     if ($e->getServerResponse()) {
         echo "  Server Response: " . json_encode($e->getServerResponse()) . PHP_EOL;
     }
-}
+}

examples/token_generation.php

@@ -2,21 +2,21 @@
 
 require_once __DIR__ . '/../vendor/autoload.php';
 
-use OpenApi\OauthClient;
+use Openapi\OpenapiOauthClient;
 
 try {
-    $oauthClient = new OauthClient('<your_username>', '<your_apikey>', true);
+    $oauthClient = new OpenapiOauthClient('<your_username>', '<your_apikey>', true);
 
     $scopes = [
         'GET:test.imprese.openapi.it/advance',
         'POST:test.postontarget.com/fields/country'
     ];
-    
+
     $ttl = 3600;
     $result = $oauthClient->createToken($scopes, $ttl);
 
     $tokenData = json_decode($result, true);
-    
+
     if (isset($tokenData['token'])) {
         echo "Generated token: " . $tokenData['token'] . PHP_EOL;
         echo "Token created successfully!" . PHP_EOL;
@@ -26,4 +26,4 @@
 
 } catch (Exception $e) {
     echo "Error: " . $e->getMessage() . PHP_EOL;
-}
+}

phpunit.xml.dist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true">
+
+    <testsuites>
+        <testsuite name="unit">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <php>
+        <env name="OPENAPI_BASE_URL" value="https://example.com" force="true"/>
+        <env name="OPENAPI_USERNAME" value="test_user" force="true"/>
+        <env name="OPENAPI_SANDBOX_KEY" value="test_key" force="true"/>
+        <env name="OPENAPI_OAUTH_SANDBOX_URL" value="https://api.com" force="true"/>
+        <env name="OPENAPI_OAUTH_URL" value="https://api.com" force="true"/>
+    </php>
+</phpunit>

src/Cache/CacheInterface.php

@@ -1,27 +1,18 @@
 <?php
 
-namespace OpenApi\Cache;
+namespace Openapi\Cache;
 
-/**
- * In-memory cache implementation
- * Data is stored in PHP arrays and cleared at end of script execution
- */
-class ArrayCache implements CacheInterface
+class OpenapiArrayCache implements OpenapiCacheInterface
 {
     private array $cache = [];
     private array $expiry = [];
 
-    /**
-     * Retrieve value from cache
-     * Returns null if key doesn't exist or has expired
-     */
     public function get(string $key): mixed
     {
         if (!isset($this->cache[$key])) {
             return null;
         }
 
-        // Check if expired
         if (isset($this->expiry[$key]) && time() > $this->expiry[$key]) {
             $this->delete($key);
             return null;
@@ -30,9 +21,6 @@ public function get(string $key): mixed
         return $this->cache[$key];
     }
 
-    /**
-     * Save value to cache with expiration
-     */
     public function save(string $key, mixed $value, int $ttl = 3600): bool
     {
         $this->cache[$key] = $value;
@@ -41,24 +29,18 @@ public function save(string $key, mixed $value, int $ttl = 3600): bool
         return true;
     }
 
-    /**
-     * Delete value from cache
-     */
     public function delete(string $key): bool
     {
         unset($this->cache[$key], $this->expiry[$key]);
 
         return true;
     }
 
-    /**
-     * Clear all cached values
-     */
     public function clear(): bool
     {
         $this->cache = [];
         $this->expiry = [];
 
         return true;
     }
-}
+}

src/Cache/ArrayCache.php src/Cache/OpenapiArrayCache.phpsrc/Cache/ArrayCache.php renamed to src/Cache/OpenapiArrayCache.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Openapi\Cache;
+
+interface OpenapiCacheInterface
+{
+    public function get(string $key): mixed;
+
+    public function save(string $key, mixed $value, int $ttl = 3600): bool;
+
+    public function delete(string $key): bool;
+
+    public function clear(): bool;
+}