feat(http): add configurable HTTP handler with Guzzle HTTP client support

Author: saeedhosan

config/openai.php

@@ -46,4 +46,15 @@
     */
 
     'request_timeout' => env('OPENAI_REQUEST_TIMEOUT', 30),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTP Handler
+    |--------------------------------------------------------------------------
+    |
+    | Define a custom HTTP handler (class-string or callable) for OpenAI requests.
+    | Useful for adding Laravel Http Events, logging, or retries via Guzzle HandlerStack.
+    | Base Handler: OpenAI\Laravel\Http\Handler::class
+    */
+    'http_handler' => env('OPENAI_HTTP_HANDLER', null),
 ];

src/ServiceProvider.php

@@ -11,6 +11,7 @@
 use OpenAI\Contracts\ClientContract;
 use OpenAI\Laravel\Commands\InstallCommand;
 use OpenAI\Laravel\Exceptions\ApiKeyIsMissing;
+use OpenAI\Laravel\Http\Handler;
 
 /**
  * @internal
@@ -35,7 +36,10 @@ public function register(): void
             $client = OpenAI::factory()
                 ->withApiKey($apiKey)
                 ->withOrganization($organization)
-                ->withHttpClient(new \GuzzleHttp\Client(['timeout' => config('openai.request_timeout', 30)]));
+                ->withHttpClient(new \GuzzleHttp\Client([
+                    'timeout' => config('openai.request_timeout', 30),
+                    'handler' => Handler::resolve(config('openai.http_handler')),
+                ]));
 
             if (is_string($project)) {
                 $client->withProject($project);