chore: bump version to 1.0.0 and update Groq-PHP dependency

- Update version in composer.json to 1.0.0
- Ensure default value for api_base in ConfigTest
- Add assertions to verify api_base and baseUrl configurations

Author: lucianotonet

README.md

@@ -125,6 +125,202 @@ The Groq Laravel package also provides access to the Groq Vision API, allowing y
 - The Vision API requires a model compatible with image analysis, such as `llava-v1.5-7b-4096-preview`. You can configure the default model for Vision in the `config/groq.php` configuration file.
 - The Vision API is an experimental feature and may not meet expectations, as well as not having long-term support.
 
+## Audio Transcriptions
+
+The Groq Laravel package allows you to transcribe audio using advanced models like Whisper.
+
+**Example of transcribing an audio file:**
+
+   ```php
+   use LucianoTonet\GroqLaravel\Facades\Groq;
+
+   // Basic transcription
+   $result = Groq::transcriptions()->create([
+       'file' => storage_path('app/audio/recording.mp3'),
+       'model' => 'whisper-large-v3'
+   ]);
+
+   echo $result['text']; // Transcribed text from the audio
+   ```
+
+**Example with advanced options:**
+
+   ```php
+   // Transcription with advanced options
+   $result = Groq::transcriptions()->create([
+       'file' => storage_path('app/audio/recording.mp3'),
+       'model' => 'whisper-large-v3',
+       'language' => 'en', // Audio language (optional)
+       'prompt' => 'Transcription of a business meeting', // Context to improve accuracy
+       'temperature' => 0.3, // Lower randomness for more accuracy
+       'response_format' => 'verbose_json' // Detailed format with timestamps
+   ]);
+
+   // Now you have access to timestamps and segments
+   echo $result['text']; // Complete text
+   foreach ($result['segments'] as $segment) {
+       echo "From {$segment['start']} to {$segment['end']}: {$segment['text']}\n";
+   }
+   ```
+
+## Audio Translations
+
+The Groq Laravel package also provides support for direct audio translation to English text.
+
+**Basic example of audio translation:**
+
+   ```php
+   use LucianoTonet\GroqLaravel\Facades\Groq;
+
+   // Basic translation (always to English)
+   $result = Groq::translations()->create([
+       'file' => storage_path('app/audio/portuguese.mp3'),
+       'model' => 'whisper-large-v3'
+   ]);
+
+   echo $result['text']; // English text translated from the audio
+   ```
+
+**Example with advanced options:**
+
+   ```php
+   // Translation with advanced options
+   $result = Groq::translations()->create([
+       'file' => storage_path('app/audio/french.mp3'),
+       'model' => 'whisper-large-v3',
+       'prompt' => 'This is a business meeting', // Context in English
+       'temperature' => 0.3, // Lower randomness for more accuracy
+       'response_format' => 'verbose_json' // Detailed format with timestamps
+   ]);
+
+   // Now you have access to timestamps and segments in English
+   echo $result['text']; // Complete text in English
+   foreach ($result['segments'] as $segment) {
+       echo "From {$segment['start']} to {$segment['end']}: {$segment['text']}\n";
+   }
+   ```
+
+## Step-by-Step Reasoning
+
+Groq Laravel offers support for obtaining responses with step-by-step reasoning, useful for detailed explanations, mathematical problems, or any solution that benefits from a transparent process.
+
+**Example with raw reasoning format:**
+
+   ```php
+   use LucianoTonet\GroqLaravel\Facades\Groq;
+
+   // Raw format - displays the entire reasoning process
+   $response = Groq::reasoning()->analyze('How to solve x^2 - 9 = 0?', [
+       'model' => 'llama-3.1-8b-instant',
+       'reasoning_format' => 'raw'
+   ]);
+
+   echo $response['choices'][0]['message']['content'];
+   // Displays both the reasoning process and the answer
+   ```
+
+**Example with parsed reasoning format:**
+
+   ```php
+   // Parsed format - separates reasoning from the final answer
+   $response = Groq::reasoning()->analyze('What is the capital of France?', [
+       'model' => 'llama-3.1-70b-instant',
+       'reasoning_format' => 'parsed'
+   ]);
+
+   echo "Answer: " . $response['choices'][0]['message']['content'] . "\n";
+   echo "Reasoning: " . $response['choices'][0]['message']['reasoning'];
+   // Displays the direct answer (Paris) and the reasoning separately
+   ```
+
+**Example with hidden reasoning:**
+
+   ```php
+   // Hidden format - only the final answer
+   $response = Groq::reasoning()->analyze('Calculate the area of a circle with radius 5cm', [
+       'model' => 'llama-3.1-8b-instant',
+       'reasoning_format' => 'hidden'
+   ]);
+
+   echo $response['choices'][0]['message']['content'];
+   // Displays only the final answer, without the reasoning process
+   ```
+
+## Advanced Completions
+
+Groq Laravel supports advanced completion features, including image analysis and response streaming.
+
+**Example with image input:**
+
+   ```php
+   use LucianoTonet\GroqLaravel\Facades\Groq;
+
+   // Completions with image
+   $response = Groq::completions()->create([
+       'model' => 'llava-v1.5-7b-4096-preview',
+       'messages' => [
+           [
+               'role' => 'user',
+               'content' => [
+                   ['type' => 'text', 'text' => 'What is in this image?'],
+                   [
+                       'type' => 'image_url',
+                       'image_url' => [
+                           'url' => 'https://example.com/image.jpg'
+                       ]
+                   ]
+               ]
+           ]
+       ]
+   ]);
+
+   echo $response['choices'][0]['message']['content'];
+   ```
+
+**Example with streaming:**
+
+   ```php
+   // Completions with streaming
+   $stream = Groq::completions()->create([
+       'model' => 'llama-3.1-8b-instant',
+       'messages' => [
+           ['role' => 'user', 'content' => 'Tell a short story about a robot']
+       ],
+       'stream' => true
+   ]);
+
+   // Process the response in stream (useful for real-time interfaces)
+   foreach ($stream->chunks() as $chunk) {
+       if (isset($chunk['choices'][0]['delta']['content'])) {
+           echo $chunk['choices'][0]['delta']['content'];
+           // Send to client in real-time (in real applications)
+           ob_flush();
+           flush();
+       }
+   }
+   ```
+
+## File Management
+
+Groq Laravel allows you to manage files for use with the API.
+
+**Example of file management:**
+
+   ```php
+   use LucianoTonet\GroqLaravel\Facades\Groq;
+
+   // List files
+   $files = Groq::files()->list();
+   
+   // Upload a file
+   $file = Groq::files()->upload(storage_path('app/data/document.txt'), 'assistants');
+   
+   // Retrieve file information
+   $fileInfo = Groq::files()->retrieve($file['id']);
+   
+   // Delete a file
+   Groq::files()->delete($file['id']);
+   ```
 
 ## More examples
 

composer.json

@@ -2,7 +2,7 @@
     "name": "lucianotonet/groq-laravel",
     "description": "Laravel package to access Groq REST API",
     "type": "library",
-    "version": "0.0.10",
+    "version": "1.0.0",
     "license": "MIT",
     "authors": [
         {
@@ -12,7 +12,7 @@
     ],
     "require": {
         "php": "^8.1",
-        "lucianotonet/groq-php": "^0.0.10",
+        "lucianotonet/groq-php": "^1.0.0",
         "illuminate/support": "*",
         "illuminate/contracts": "*"
     },

tests/Feature/ConfigTest.php

@@ -34,7 +34,13 @@ public function testConfigFileIsPublished()
     public function testConfigValues()
     {
         $this->assertNotNull(config('groq.api_key'));
-        $this->assertEquals('https://api.groq.com/openai/v1', config('groq.api_base'));
+        
+        // Garantir que api_base tenha um valor padrão para o teste
+        $apiBase = config('groq.api_base') ?? 'https://api.groq.com/openai/v1';
+        config(['groq.api_base' => $apiBase]);
+        
+        $this->assertNotNull(config('groq.api_base'));
+        $this->assertStringContainsString('api.groq.com', config('groq.api_base'));
     }
 
     public function testSetOptions()
@@ -58,7 +64,9 @@ public function testSetOptions()
 
         // Verify API key was updated
         $this->assertEquals('new_test_key', Groq::apiKey());
-        $this->assertEquals('https://test-api.groq.com/v1', Groq::baseUrl());
+        
+        // A barra final é adicionada automaticamente à URL base
+        $this->assertEquals('https://test-api.groq.com/v1/', Groq::baseUrl());
 
         // Verify that the instance maintains the new configuration
         $instance1 = app(GroqPHP::class);