v4.0.0 - Complete Library Redesign with Clean Parameter API

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

Complete API Coverage

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.

Complete Rewrite with Ultra-Lightweight PHP 8.1+ Architecture

• 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 & Main Branch Migration

• 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)