# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.1.0] - 2025-04-12

### Added
- Suporte completo para Text-to-Speech via método `speech()`
- Suporte aprimorado para processamento em lote via método `batch()`
- Novas configurações para Speech API e Batch Processing
- Documentação atualizada com exemplos de uso das novas funcionalidades

### Changed
- Atualizada dependência do groq-php para ^1.2.0
- Melhorada a documentação do Facade com PHPDoc atualizado
- Refatorado GroqClient para melhor gerenciamento de configurações

### Fixed
- Corrigido o método `batch()` para usar o nome correto do método no cliente groq-php

## [Unreleased]

### Changed
- Updated vision model to use `meta-llama/llama-4-scout-17b-16e-instruct`, the latest recommended model by Groq
- Improved file upload test to ensure proper text/plain MIME type recognition
- Fixed file upload test to use correct purpose 'batch'

### Notes
- The new vision model `meta-llama/llama-4-scout-17b-16e-instruct` offers improved multimodal performance with support for a 128K token context window and image input up to 5 images
- Current performance: 607 tokens per second (TPS) as benchmarked by Groq

## v0.0.10
* [29/10/2024](https://github.com/lucianotonet/groq-laravel/commits/09f1be747860f9de89d5158d6370352c96b7020a) Update setting options
* [29/10/2024](https://github.com/lucianotonet/groq-laravel/commits/588556a8c0871c7e0a842a7844202ba6f57ee489) Merge tag 'v0.0.10'
* [29/10/2024](https://github.com/lucianotonet/groq-laravel/commits/db9d9ba7ed78253fa775ab3e0a7dd266d05ed7d4) Bump version to 0.0.10
* [29/10/2024](https://github.com/lucianotonet/groq-laravel/commits/60bea6c9775e2570b30d06f706afa24bc29c77bb) Bump version to 0.0.10

## v0.0.9
* [06/09/2024](https://github.com/lucianotonet/groq-laravel/commits/bbdd64aabccd07d9772d880b7891405595b7f8b1) Update README.md
* [05/09/2024](https://github.com/lucianotonet/groq-laravel/commits/d4d04350d161eb3c8a09b528d8a9b85d1c4ca7de) Update image URL and translate README
* [05/09/2024](https://github.com/lucianotonet/groq-laravel/commits/b9fb852bb81ac2409385b17100e5a709a9010758) Add Vision API functionality to v0.0.9 in CHANGELOG.md.
* [05/09/2024](https://github.com/lucianotonet/groq-laravel/commits/11639a559206f1d5eebd65951cec45c606f08fc4) Add Vision API functionality
* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/9868df67da994a011c573f4cd037d8a2eafb52cd) Atualiza links de badge para HTTPS no README
* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/6515f555cd92cd79d2c0bdfe8c002f6b4859d933) Atualiza badges no README para incluir versões instáveis

## v0.0.8
* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/3505dc510883ed34fae610524292cbb014750aa8) Update README.md
* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/6c36e8ff9f953ce3eead317b1b40865c065be012) Adiciona documentação e melhora a configuração do Groq Laravel
* [02/09/2024](https://github.com/lucianotonet/groq-laravel/commits/62af4e4ba5674ffb13cc5ae48cfab0c1aad8fedc) Atualiza integração do Groq com novas funcionalidades
* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/c078490e3b5c20c815097c8d247b9541b8d25426) docs: Update README to reflect changes
* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/959a5cf1d8c393b95b300c47384a58a5c4e284e5) feat: Integrate GROQ API with configuration flexibility
* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/b2500a8e4af9505222db7b4be54e63de81e57011) chore: Update Groq facade for simplified access to GroqPHP library methods
* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/aee513a150845068e062b5e7bf707bee6bddf08b) chore: Update composer.json description and version
* [20/04/2024](https://github.com/lucianotonet/groq-laravel/commits/049dac61eff527a6dc16c303e513720475732fb8) Refactored code to improve readability and maintainability.

## v0.0.4
* [20/04/2024](https://github.com/lucianotonet/groq-laravel/commits/cf503b1326cd7126eda08acda4323e7b2bbb994e) Refactored code to improve readability and maintainability.

## v0.0.3
* [30/03/2024](https://github.com/lucianotonet/groq-laravel/commits/5caedeae2e250fb2287e9aa47ac4c1ad1b673d37) Udpate version dependency
* [28/03/2024](https://github.com/lucianotonet/groq-laravel/commits/4b7e53f25e9918c512d0b6cdeec833bb3d880d65) Udpate readme

## v0.0.2
* [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.

## [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