Skip to main content

cnctd_service_spotify/
lib.rs

1//! cnctd-service-spotify: Spotify API integration for cnctd.world
2//!
3//! Provides read-only access to Spotify listening data (top artists, top tracks,
4//! saved albums, recently played, search, artist albums). Designed as a built-in
5//! tool service following the SSH service pattern.
6//!
7//! The service takes an access token per-call — token management (OAuth flow,
8//! refresh, storage) is handled by the cnctd.world server, not this library.
9
10pub mod client;
11pub mod error;
12pub mod tools;
13
14pub use client::SpotifyClient;
15pub use error::SpotifyError;
16pub use tools::{
17    SpotifyService,
18    ToolDefinition,
19    get_tool_definitions,
20    // Args types
21    GetTopArtistsArgs,
22    GetTopTracksArgs,
23    GetSavedAlbumsArgs,
24    GetRecentlyPlayedArgs,
25    SearchArgs,
26    GetArtistAlbumsArgs,
27    // Result types
28    ArtistResult,
29    TrackResult,
30    AlbumResult,
31    SavedAlbumResult,
32    RecentlyPlayedResult,
33    SearchResult,
34};