feat: add playlist item drill-down support

[bautistaaa]

Summary

Yes — the Spotify API supports playlist contents, and this PR adds drill-down for them the same way albums and podcasts already work.

API support

• Search already included playlists (PLAYLIST in the results column)
• Playback via context_uri already worked
• New: GET /v1/playlists/{id}/items for browsing tracks/episodes inside a playlist
• Spotify Development Mode only returns items for playlists you own or collaborate on; other playlists get HTTP 403

What changed

• Added Spotify:playlist_items with pagination and additional_types=track,episode
• <CR> on a playlist opens its items when allowed
• On 403, jam.nvim notifies and plays the playlist instead
• Added l: search prefix for playlists-only filtering
• Mixed search now interleaves types so PLAYLIST rows aren't buried under tracks/albums/artists
• Search limit capped at Spotify Dev Mode max of 10
• Docs/tests updated for the new behavior

How to see playlists

• Unfiltered search: look for the PLAYLIST label in the left column (now mixed in earlier)
• Playlist-only: type l: discover weekly (or any playlist query)

Testing

• tests/provider.lua (playlist items, l: filter, interleaved results, limit cap)
• tests/smoke.lua (capability flag)
• Existing picker/oauth smoke tests

  

[Copilot]

Pull request overview

Adds Spotify playlist drill-down support to jam.nvim so users can browse and play individual tracks/episodes inside playlists (with a Development Mode fallback when Spotify denies access).

Changes:

• Implemented Spotify:playlist_items (paginated) and exposed a playlist_items capability.
• Updated the Telescope picker to drill down into playlist contents on <CR>, and to fall back to playing the playlist on HTTP 403.
• Added l: search prefix for playlists and updated docs/tests accordingly.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
lua/jam/providers/spotify.lua	Adds playlist-items fetch with pagination, extends normalization for playlist item counts, and adds l: search filtering.
lua/jam/ui/picker.lua	Adds playlist drill-down workflow with a 403-handling fallback to “play playlist”.
tests/provider.lua	Adds coverage for playlist items pagination/normalization and the new l: prefix behavior.
tests/smoke.lua	Validates the new playlist_items capability flag exists.
README.md	Documents playlist drill-down and the new l: filter prefix.
doc/jam.txt	Updates help docs to include playlist drill-down behavior and l: prefix.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.