#500

feat: Apple Music source

* Use id OR name for matching client to scrobble to, during transition period
* Deprecate using name-only and warn when this is detected
* Consolidate logging filtered clients to one statement to reduce log noise
* Improve filter matching by making strings case and whitepsace insensitive
* On startup log `clients` options for sources

Updated the Apple Music configuration documentation to use <kbd> tags for keyboard shortcuts, improving readability.

Updated Apple Music configuration documentation with step-by-step instructions and screenshots for extracting authorization tokens in Chrome, Edge, Firefox, and Safari.

latest_listen_ts is *always* the latest of *all-time*, not for the current min/max_ts range requested.

Instead, use count < than desired (and non-zero) to indicate more results

* Ensure ingress queue always has an updated timestamp before dead creation
* Don't re-assign createdAt for scrobble after dead queue has already been updated

* Use timeline summary formatting to fix spacing
* Provide client name from fetched component data, if present, so scrobble summary is explicit where it sent/response scrobble from

Replaces the generic `headers` configuration field with a specific `origin` field for Apple Music. Updates the config schema, environment variable handling, documentation, and source implementation to simplify origin header management.

Added test cases to ensure that ' - EP' and ' - Single' suffixes are correctly stripped from Apple Music album names during the formatting process.

Added the web URL to the track metadata in AppleMusicSource to provide a direct link to the track.

Added the isrc field to the track object in AppleMusicSource to improve track identification accuracy.

#636

Implemented album name normalization in AppleMusicSource to ensure consistency with other sources by removing standard suffixes from EPs and singles. Updated documentation to reflect this behavior.

Adjusted markdown heading levels to ensure proper document structure.

* allow core-tests from backend
* downgrade linting to warn

Updated the README to include Apple Music in the list of supported scrobbling sources with a link to its documentation.

Add new test suite for Apple Music backend logic

* move refresh/loading indicator into list type header
* Remove filter card title to trim filter real estate

Added logic to detect and recover 'top-rebound' history patterns where Apple Music deduplicates re-listened tracks by bumping them to the top. This ensures intermediate tracks are captured and re-listened top tracks are processed correctly. Includes a new configuration option `recoverUnchangedTopHistory` to toggle this behavior.

Refactored Apple Music source configuration to support token-based authentication via key files and custom headers. Renamed environment variable prefixes from 'AM' to 'APPLEMUSIC' for consistency.

Added documentation for the APPLEMUSIC_HEADERS environment variable and updated code blocks with titles for better clarity in the Apple Music source configuration.

Implemented status code validation for Apple Music authentication and connection checks. The module now throws errors instead of failing silently when the API is unreachable or auth is invalid.

Reorganized the Apple Music documentation to prioritize the Browser Token (Free) authentication method and clarify requirements for the paid MusicKit Key approach.

#500

Bump node-musickit-api to 3.1.0-next.5

Add Apple Music to the sources overview table and the main documentation index.

Updated node-musickit-api dependency to the latest next version.

Switched node-musickit-api dependency from a local path to version 3.1.0-next.4 from the registry.

Introduced a `headers` configuration option to allow setting custom request headers, such as 'Origin', for Apple Music API requests. Updated configuration schema and source implementation to apply these headers.

Update parseRecentAgainstResponse return type signature to use the HistoryConsistencyResult alias instead of an inline object definition.

Updated comments in applyCalculatedTimestamps to reflect that Apple Music lacks track timestamps, necessitating a hacky estimation method.

Moved the reduceRight logic for calculating play timestamps into a dedicated private method 'applyCalculatedTimestamps' to improve code readability and maintainability.

Cleaned up the type casting in the AppleMusicSource fetch logic by removing unnecessary unknown assertion.

Introduced constants for history limits and track polling constraints to improve maintainability and readability within AppleMusicSource.

Refactored AppleMusicSource to use defined types for history consistency, updated the getRecentlyPlayedTracks limit type, and renamed variable for clarity.

Removed local AppleMusicTrack interface and updated formatPlayObj to utilize the shared Song type for improved type consistency.

Removed the unused `getBackloggedPlays` method and cleaned up the `getRecentlyDiscoveredPlays` logic in `AppleMusicSource` to streamline track processing.

Implement Apple Music source, including configuration types, environment variable handling, and source initialization logic. Refactored SourceType definitions to improve maintainability.

Store opened state, and position/size, to local storage so logs stay where user wants them across refreshes/initial load.

Resets window to default position if any part of log window is outside viewport bounds on open.

Allow user-selected max grid width on non-mobile breakpoints

#500