ci(release): v10 - #455

The v10 release, the first major release since 9.4.0.

Spotify changed its Web API on 2026-02-11 and kept adjusting it afterwards.
This release brings the library back in line with what Spotify actually serves today.
Most of the work here was not a choice: when Spotify stops returning a piece of data, a wrapper cannot invent it.

What changes for people who use this library

Some data is gone.
Spotify no longer returns it, so the library no longer offers it:

• popularity scores for tracks and albums
• the list of countries an album, track or show is available in
• the publisher of a show
• the "linked from" pointer to the original version of a relinked track

Playlists behave differently.
Spotify only returns the contents of playlists that belong to the user making the request.
Every other playlist comes back with its description data (name, images, owner) but without its list of songs.
Following Spotify's own wording, the playlist field that was called tracks is now called items.

Saving and removing library items is one operation now.
Instead of a separate call per content type (save a track, save an album, save a show, and so on) there is a single call that accepts any mix of items.
The per-type calls still exist and still work.

Nothing that worked in 9.4.0 became unreachable.
Endpoints that Spotify announced as removed are still shipped, marked deprecated, because credentials issued before the change can still reach them.
Deprecated here does not mean scheduled for deletion, no removal date is planned.
49 of 114 request builders now carry that marker, up from none.
The exception is a handful of old call variants that took a playlist owner id, since Spotify's endpoints no longer accept one.

Three audio analysis values start working.
getWindowSeconds() and getEndOfFadeIn() on a track's audio analysis, and getMode() on one of its sections, always came back empty.
The library was reading keys that Spotify does not send, two of them misspelled and one guarded on a field that sections do not carry.
Code that checked these for null will now take the other branch.

Two fewer dependencies.
Model objects are read with Gson alone now, so Jackson is no longer pulled in.
This only affects you if you passed these classes to a Jackson ObjectMapper of your own, which worked off annotations that no longer exist.
The nv-i18n country code library is gone too, replaced by an equivalent enum shipped here.
Only Gson and HttpComponents are left.

The jar is a Java module.
It carries a real module descriptor instead of just a name in the manifest, so a requires se.michaelthelin.spotify; now resolves the library's own dependencies too, and a jlink image can include it as a proper module.
The module name has not changed, so existing module declarations keep working, and nothing about this affects code on the classpath.

New ground is covered.
Audiobooks and chapters are supported for the first time, including searching for them and saving them to a library.
The list of markets where Spotify is available is back.
Creating a playlist works again, it had gone missing during the migration in 10.0.0-RC1.

What upgrading costs

This is not a drop-in upgrade, applications will need code changes.
Many classes and methods were renamed to carry the names Spotify uses in its own documentation, for example searchItem is now searchForItem and getInformationAboutUsersCurrentPlayback is now getPlaybackState.
Request classes were regrouped into packages that mirror Spotify's own grouping.
The complete before/after tables are in #460.
In exchange the library covers more of the API than before: 114 operations, up from 94.

Country codes come from this library now rather than from nv-i18n, which stopped being maintained in 2021 and could not be required safely from a module.
The constant names are unchanged, so that break is one import line per file.

- import com.neovisionaries.i18n.CountryCode;
+ import se.michaelthelin.spotify.enums.CountryCode;

A few types that nothing referenced any more were deleted too: PlaylistTrackPosition, the ProductType and AlbumGroup enums, and two paging helpers that threw whenever they were used.

The published API documentation moved with the module descriptor: pages now sit under a se.michaelthelin.spotify/ path segment. Links to the old locations are redirected, so existing bookmarks keep working.

Also in this release: shared interfaces so that full and simplified variants of the same object can be handled by the same code (#457), a vendored copy of Spotify's API specification so future syncs are a file comparison instead of a manual read-through (#469), and a migration guide with the complete rename tables (#471).