feat: Integrate GROQ API with configuration flexibility

Enables seamless integration with the GROQ API by introducing a service provider and a dedicated configuration file. This allows for easy interaction with the GROQ API within Laravel applications and provides developers with the flexibility to customize API settings according to their needs.

Author: lucianotonet

config/groq.php

@@ -0,0 +1,16 @@
+<?php
+
+/**
+ * Configuration settings for the GROQ API integration.
+ *
+ * @return array
+ *   An array of GROQ API configuration settings.
+ *   - api_key: The API key to authenticate with the GROQ API.
+ *   - api_base: The base URL for the GROQ API endpoint.
+ *   - options: Additional options to pass to the GROQ API client.
+ */
+return [
+    'api_key' => env('GROQ_API_KEY'),
+    'api_base' => env('GROQ_API_BASE', 'https://api.groq.com/openai/v1'),
+    'options' => [],
+];

src/GroqServiceProvider.php

@@ -5,16 +5,46 @@
 use Illuminate\Support\ServiceProvider;
 use LucianoTonet\GroqPHP\Groq;
 
+/**
+ * Provides the Groq service provider for the Laravel application.
+ *
+ * The GroqServiceProvider registers the Groq class with the application's service
+ * container, allowing it to be resolved and used throughout the application. It
+ * also publishes the default Groq configuration file to the application's config
+ * directory, allowing the user to customize the configuration as needed.
+ */
 class GroqServiceProvider extends ServiceProvider
 {
-    public function register()
+    /**
+     * Registers the Groq service with the application's service container.
+     *
+     * This method binds the Groq class to the service container, allowing it to be
+     * resolved and used throughout the application. The Groq instance is configured
+     * with the API key and base URL specified in the application's environment.
+     *
+     * @return void
+     */
+    public function register(): void
     {
-        $this->app->bind(Groq::class, function ($app, $parameters) {
+        $this->app->bind(Groq::class, function ($app, $parameters = []) {
             return new Groq(
                 $parameters['apiKey'] ?? env('GROQ_API_KEY'),
-                $parameters['options'] ?? []
+                array_merge($parameters['options'] ?? [], ['baseUrl' => env('GROQ_API_BASE', 'https://api.groq.com/openai/v1')])
             );
         });
     }
-}
 
+    /**
+     * Publishes the Groq configuration file to the application's config directory.
+     *
+     * This method is called during the package's boot process. It allows the user to
+     * publish the default Groq configuration file to their application, so they can
+     * customize the configuration as needed.
+     */
+    public function boot(): void
+    {
+        $this->publishes([
+            __DIR__ . '/../config/groq.php' => config_path('groq.php'),
+        ]);
+    }
+}