feat: update batch processing configuration and enhance validation

- Added support for JSONL file format in batch processing, restricting file extensions to `.jsonl`.
- Updated `composer.json` to require `groq-php` version `^1.3`.
- Enhanced validation for batch processing, including allowed MIME types and content validation.
- Updated `.env.example` to include new configuration options for batch processing.

Author: lucianotonet

.env.example

@@ -1,7 +1,7 @@
 # Groq API Configuration
 GROQ_API_KEY=your-api-key-here
-GROQ_MODEL=llama-3.1-8b-instant
 GROQ_API_BASE=https://api.groq.com/openai/v1
+GROQ_MODEL=llama-3.1-8b-instant
 GROQ_TIMEOUT=30
 
 # Cache Configuration
@@ -28,6 +28,7 @@ GROQ_VISION_MAX_TOKENS=300
 GROQ_BATCH_COMPLETION_WINDOW=5m
 GROQ_BATCH_MAX_SIZE=20
 GROQ_BATCH_AUTO_PROCESS=true
+GROQ_BATCH_VALIDATE_CONTENT=true
 
 # Speech Configuration
 GROQ_SPEECH_MODEL=playai-tts

CHANGELOG.md

@@ -67,4 +67,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * [28/03/2024](https://github.com/lucianotonet/groq-laravel/commits/9c67dbf59149b8de7bee19be83aebe7fabd9617c) Udpate readme
 * [28/03/2024](https://github.com/lucianotonet/groq-laravel/commits/59993d56c3ee35f97ec644b165ae2c0c502f26ba) Add basic stuff
 * [27/03/2024](https://github.com/lucianotonet/groq-laravel/commits/9bdbe7592acaa19b960ffc359fe2ee8c52b7143f) WIP
-* [22/03/2024](https://github.com/lucianotonet/groq-laravel/commits/0b5eb656b3930880654e0562f56859554b5cf15e) First commit. Add base skeleton.
+* [22/03/2024](https://github.com/lucianotonet/groq-laravel/commits/0b5eb656b3930880654e0562f56859554b5cf15e) First commit. Add base skeleton.
+
+## [1.3.0] - 2025-08-04
+
+### Breaking Changes in Files/Batches Module
+- Updated JSONL file format requirements for batch processing to match groq-php v1.3.0
+- Restricted file extensions to `.jsonl` only (removed support for `.json`, `.txt`, `.ndjson`)
+- Added stricter validation for file contents and structure
+
+### Changed
+- Updated groq-php dependency to ^1.3.0
+- Updated Files API validation to properly handle 'batch' purpose
+- Added support for additional MIME types in batch processing
+- Updated JSONL file format documentation and examples
+- Improved file validation in batch processing
+- Enhanced error messages for file validation
+
+### Added
+- Support for audio transcription and translation in batch processing
+- Support for chat completions in batch processing
+- New examples for batch processing with JSONL files
+- Improved error messages for file validation
+
+### Migration Guide for Files/Batches Module
+If you are using the Files/Batches module, you will need to:
+1. Update your JSONL files to include required fields:
+   - `custom_id`: Your unique identifier for tracking
+   - `method`: Must be "POST"
+   - `url`: One of: /v1/chat/completions, /v1/audio/transcriptions, or /v1/audio/translations
+   - `body`: Request parameters matching the endpoint format
+2. Ensure all files use `.jsonl` extension
+3. Update file content to match new validation requirements
+4. Review the updated documentation for complete format specifications

composer.json

@@ -13,7 +13,7 @@
         "php": "^8.1",
         "illuminate/support": "*",
         "illuminate/contracts": "*",
-        "lucianotonet/groq-php": "^1.2"
+        "lucianotonet/groq-php": "^1.3"
     },
     "require-dev": {
         "orchestra/testbench": "^6.0|^7.0|^8.0",

config/groq.php

@@ -98,6 +98,20 @@
         'completion_window' => env('GROQ_BATCH_COMPLETION_WINDOW', '5m'),
         'max_batch_size' => env('GROQ_BATCH_MAX_SIZE', 20),
         'auto_process' => env('GROQ_BATCH_AUTO_PROCESS', true),
+        'allowed_extensions' => ['.jsonl'], // Apenas arquivos JSONL são suportados
+        'allowed_mime_types' => [ // MIME types suportados para arquivos JSONL
+            'application/x-jsonlines',
+            'application/jsonl',
+            'application/x-ndjson',
+            'application/x-ndjason',
+            'text/jsonl'
+        ],
+        'validate_content' => env('GROQ_BATCH_VALIDATE_CONTENT', true), // Validar conteúdo do arquivo
+        'endpoints' => [ // Endpoints suportados para processamento em lote
+            '/v1/chat/completions',
+            '/v1/audio/transcriptions',
+            '/v1/audio/translations'
+        ]
     ],
 
     /*

src/GroqClient.php

@@ -64,6 +64,17 @@ protected function getDefaultConfig(): array
             'top_p' => config('groq.options.top_p', 1.0),
             'frequency_penalty' => config('groq.options.frequency_penalty', 0),
             'presence_penalty' => config('groq.options.presence_penalty', 0),
+            'batch' => [
+                'allowed_extensions' => ['.jsonl'],
+                'allowed_mime_types' => [
+                    'application/x-jsonlines',
+                    'application/jsonl',
+                    'application/x-ndjson',
+                    'application/x-ndjason',
+                    'text/jsonl'
+                ],
+                'validate_content' => true
+            ]
         ];
     }
 
@@ -141,6 +152,7 @@ public function speech()
      * Get batch instance
      * 
      * @return \LucianoTonet\GroqPHP\BatchManager
+     * @deprecated Use batches() instead
      */
     public function batch()
     {