Php Discogs Api Laravel Package

Added

• Support for guzzlehttp/guzzle 8.0 alongside 7.0 (^7.0 || ^8.0).
• Compatibility testing and CI matrix coverage for PHP 8.1–8.6 and both Guzzle 7 & 8.
• Built-in retry resilience for Discogs rate limits (429 and 503) with exponential backoff and Retry-After header support.

Changed

• Upgraded PHPStan to 2.x (Level 8) and GitHub Actions to Node 24 compatible runners.
• Updated default User-Agent version to 4.1.0.

Fixed

• Fixed documentation example for search() named parameter (q instead of query) (#4 by [@JamieBradders](https://github.com/JamieBradders)).

Removed

• Dropped legacy guzzlehttp/guzzle 6.5 constraint.

This release represents a fundamental architectural overhaul, prioritizing developer experience, type safety, and minimal code footprint.

Breaking Changes

• Class Renaming: DiscogsApiClient → DiscogsClient, ClientFactory → DiscogsClientFactory
• Method Naming: All 60 methods follow consistent verb-first pattern (getArtist, listArtistReleases, createMarketplaceListing)
• Clean Parameters: Array parameters eliminated - direct typed parameters with IDE autocomplete support
• Authentication: Enhanced security with RFC 5849 OAuth 1.0a implementation

Migration Required

All method calls must be updated. See CHANGELOG.md and UPGRADE.md for detailed migration guide.

Features

• Ultra-lightweight architecture (~750 lines, 2 core classes)
• Full type safety with automatic parameter validation
• Perfect IDE autocomplete support
• PHP 8.1 - 8.5 compatibility
• Zero bloat, direct API mapping

Documentation

• README
• Migration Guide
• Development Guidelines
• Changelog

Hotfix release adding complete PHPDoc coverage for all Discogs API endpoints.

For Library Users:

• Better IDE autocomplete for all 60+ API methods
• Complete method documentation with proper type hints
• Breaking Change: collectionFolder() → collectionFolderGet() (bugfix for non-functional method)

Developer Experience:

• Full IntelliSense support for all API operations
• Accurate method signatures and parameter hints
• PSR-12 compliant documentation examples

Breaking Change Note: The collectionFolder() method was broken in v3.0.0 (mapped to non-existent endpoint). Users must update to collectionFolderGet(). This is classified as a bugfix since the original method never worked.

• Ultra-minimalist Discogs API client with only 2 core classes
• Complete rewrite with modern PHP 8.1+ architecture and comprehensive testing
• Magic method calls: \->artistGet(['id' => 123])\
• 100% code coverage with comprehensive test suite (43 tests)
• PHPStan Level 8 static analysis with full type safety
• Reduced memory footprint and faster response times
• GitHub Actions CI testing across PHP 8.1-8.5
• Complete migration guide from v2.x available

Breaking Changes: Requires PHP 8.1+, new namespace, ultra-lightweight architecture Tested: PHP 8.1 through 8.5 (dev)

• Repository restructuring: Renamed master branch to main
• Updated CI workflow to use the main branch instead of master
• Complete CHANGELOG reconstruction with full release history
• Enhanced README badges, structure, and v3.0.0 preparation notes
• Added markdownlint configuration for documentation quality
• Added PHPUnit 10.x compatibility for modern PHP versions
• Maintained compatibility with existing PHP 7.3+ testing matrix

Breaking Changes: None
Tested: PHP 7.3 through 8.5 (beta)