Discogs Bundle Laravel Package

• v3.x: Legacy branch maintained for bug fixes only
• v4.0.0+: Active development branch with potential breaking changes

🚀 Complete Rewrite — Fresh Start

This version represents a complete architectural rewrite. v4.0.0 is essentially a new bundle that happens to have the same name.

Added

• Personal Access Token Support for simple authentication
• All 60 Discogs API Methods with consistent verb-first naming and modern parameter style
• Zero Configuration Mode for public API access
• Named Parameter Support – Methods accept individual parameters in camelCase instead of arrays
• Built-in OAuth 1.0a with no external dependencies
• Symfony Rate Limiter Integration – Optional advanced rate limiting with configurable policies (sliding_window, fixed_window, token_bucket)
• Symfony 6.4 | 7.x | 8.x Support with future compatibility
• Modern PHP 8.1+ Architecture with full type safety and modern features
• Comprehensive Test Suite with unit and integration tests
• Professional Documentation with clear examples and setup guides
• Modern Bundle Structure following all Symfony best practices
• Robust Configuration Validation with meaningful error messages
• Modern Music References throughout documentation and examples

Changed

• Configuration Structure simplified and more intuitive
• Method Parameter Style – All methods now accept individual parameters (e.g., getArtist(artistId: 123)) instead of arrays (getArtist(['id' => '123']))
• Method Names use consistent verb-first patterns (e.g., listArtistReleases())
• Parameter Naming – All parameters use camelCase convention (e.g., perPage instead of per_page)
• Rate Limiting – Replaced simple throttle system with Symfony Rate Limiter component integration
• Service Naming follows modern Symfony conventions with proper aliases
• Error Handling improved with better exceptions and validation
• Performance optimized for modern PHP versions
• Complete API Integration now based on calliostro/php-discogs-api
• Code Standards fully compliant with @Symfony and @Symfony:risky rules

Removed

• Complex Configuration – Simplified to essential options only
• Array Parameter Style – Methods no longer accept parameter arrays
• Throttle Configuration – Legacy throttle config replaced with modern rate_limiter integration
• Legacy Dependencies – No more Guzzle Services or external OAuth libraries
• Backward Compatibility – This is a fresh start, not an upgrade

Added

• Comprehensive @throws documentation for exception handling in source files
• Additional edge case tests for HWIOauthTokenProvider to achieve 100% code coverage

Fixed

• Deprecated getConfig() usage in functional tests replaced with future-safe implementation
• PHPStan warnings suppressed for defensive null checks in test assertions

Changed

• Improved exception documentation specificity (XML loading exceptions vs. generic exceptions)
• Enhanced test coverage from 96.9% to 100% with comprehensive OAuth token scenarios

Changed

• Enhanced CI workflow with comprehensive testing matrix (PHP 8.1–8.5, Symfony 6.4–8.0)
• Integrated PHP-CS-Fixer with Symfony coding standards (@Symfony + @Symfony:risky)
• Optimized code quality configuration and applied consistent formatting

Added

• Initial CHANGELOG.md for better release tracking
• PHPStan static analysis at Level 8 with comprehensive error checking
• Composer scripts for testing, code style checks, and static analysis
• Extended GitHub Actions workflow with a comprehensive PHP / Symfony version matrix
• Support for legacy, feature, hotfix, and release branch patterns
• Manual workflow dispatch option for GitHub Actions
• .markdownlint.json for consistent documentation formatting
• Comprehensive test suite with 97.46% code coverage across all source files

Fixed

• Fixed the static analysis warning in HWIOauthTokenProvider using type-safe method calls
• Resolved all PHPStan Level 8 issues throughout the codebase
• Applied Symfony coding standards consistently across all source files

Added

• PHP 8.5 compatibility – Early support for the upcoming PHP 8.5 release
• Symfony 8.0 testing – Ready for Symfony 8.0 when it arrives
• Enhanced stability – Improved build reliability and faster dependency resolution

Changed

• Migrated from Travis CI to GitHub Actions for improved reliability
• Streamlined testing workflow for faster releases
• Optimized dependency testing matrix
• Updated CI status badge in README

Fixed

• Better future-proofing – Early validation with next-generation PHP/Symfony combinations

Added

• Symfony 8.x support – Now compatible with the upcoming Symfony 8.0 release
• Extended CI testing matrix to include PHP 8.4 and 8.5 (beta)
• Comprehensive testing across Symfony 6.4 (LTS), 7.x, and 8.x versions

Changed

• Enhanced compatibility testing with different dependency combinations

Fixed

• Fix Discogs authentication when using only consumer key/secret (OAuth optional)
• Suppress warnings if HWIOAuthBundle is not installed
• Improved error messages for missing or invalid OAuth configuration

Changed

• All service classes are now final for better reliability and performance
• Added clear descriptions for configuration options
• Updated default user agent string
• README and UPGRADE guides rewritten with modern examples and clearer instructions
• Configuration documentation is now easier to understand

Breaking Changes

• PHP 8.1+ required (previously 7.3+)
• Symfony 6.4+ or 7.x required (previously 5.x+)
• Support for older PHP and Symfony versions has been dropped

Added

• Symfony 6 support

Fixed

• Fix Discogs authentication with only consumer key/secret

Changed

• Make service classes final
• Add description for configuration

Fixed

• Suppress warning if HWIOAuthBundle is not installed

Changed

• Replace default user agent
• Update documentation

Added

• Support for Symfony 5
• First release of this fork

Note: This repository follows semantic versioning starting from v3.1.3. Previous releases were published without a formal changelog.