Lastfm Client 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 Last.fm rate limits (503 and 429) with exponential backoff and Retry-After header support.
• LastFmClientFactory::create() method to instantiate unauthenticated clients or pass pre-configured GuzzleHttp\Client instances.

Changed

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

Removed

• Dropped legacy guzzlehttp/guzzle 6.5 constraint.

This release introduces significant improvements with enhanced authentication, performance optimizations, and a cleaner API design.

Breaking Changes

• Method Naming: All methods follow consistent verb-first pattern (getArtistInfo, getTrackInfo, scrobbleTrack)
• Authentication: Restructured with dedicated setApiCredentials() method and LastFmClientFactory
• Parameter Handling: Enhanced with named parameter support and camelCase conversion

New Features

• New AuthHelper class for streamlined Last.fm authentication workflows
• LastFmClientFactory with authentication methods (createWithApiKey, createWithSession, createWithMobileAuth)
• ConfigCache singleton for performance-optimized configuration management
• Enhanced parameter validation with security and performance limits
• Improved error handling with descriptive messages

Migration Required

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

Documentation

• README
• Migration Guide
• Development Guidelines
• Changelog

Initial release of an ultra-lightweight Last.fm API client for PHP 8.1+

Added

• Initial release of an ultra-lightweight Last.fm API client for PHP 8.1+
• Service-description-based architecture with only two classes
• Direct method mapping (trackGetInfo() → track.getInfo)
• Support for all 60+ Last.fm API endpoints (track, artist, album, user, chart, tag, geo, library, auth methods)
• Full authentication support (API key and OAuth session-based)
• Scrobbling and now playing functionality
• Comprehensive error handling and type safety
• IDE support with method documentation and Last.fm API links
• PHPStan Level 8 compatibility for maximum static analysis
• PSR-12 compliant code with 100% test coverage
• Complete authentication examples and setup documentation