@bzenky/spoti 0.1.0 → 0.3.0

package/dist/services/models.d.ts

@@ -18,3 +18,48 @@ export interface CurrentPlayback {
     progressMs: number;
     deviceName?: string;
 }
+export interface Album {
+    id: string;
+    uri: string;
+    name: string;
+    artists: string[];
+    releaseDate?: string;
+    totalTracks: number;
+    imageUrl?: string;
+    externalUrl?: string;
+}
+export interface AlbumDetail extends Album {
+    tracks: Track[];
+}
+export interface Artist {
+    id: string;
+    uri: string;
+    name: string;
+    imageUrl?: string;
+    externalUrl?: string;
+}
+export interface Playlist {
+    id: string;
+    uri: string;
+    name: string;
+    description: string;
+    ownerName: string;
+    isPublic: boolean | null;
+    totalTracks: number;
+    imageUrl?: string;
+    externalUrl?: string;
+}
+export interface PlaylistDetail extends Playlist {
+    tracks: Track[];
+}
+export interface SavedTrack {
+    addedAt: string;
+    track: Track;
+}
+export interface RecentlyPlayedTrack {
+    playedAt: string;
+    track: Track;
+    contextUri?: string;
+}
+export type RepeatMode = 'off' | 'track' | 'context';
+export type SpotifyContextType = 'album' | 'artist' | 'playlist';

package/dist/services/player.service.d.ts

@@ -1,12 +1,22 @@
 import type { SpotifyApi } from '../spotify/client.js';
-import type { CurrentPlayback } from './models.js';
+import type { DeviceService } from './device.service.js';
+import type { CurrentPlayback, RepeatMode } from './models.js';
 export declare class PlayerService {
     private readonly spotify;
-    constructor(spotify: SpotifyApi);
+    private readonly deviceService?;
+    constructor(spotify: SpotifyApi, deviceService?: Pick<DeviceService, "getControllableDevices"> | undefined);
     getCurrentPlayback(): Promise<CurrentPlayback | null>;
     playTrack(uri: string): Promise<void>;
+    playContext(contextUri: string): Promise<void>;
+    setShuffle(state: boolean): Promise<void>;
+    setRepeat(state: RepeatMode): Promise<void>;
     pause(): Promise<void>;
     resume(): Promise<void>;
     next(): Promise<void>;
     previous(): Promise<void>;
+    setVolume(volumePercent: number): Promise<number>;
+    changeVolume(delta: number): Promise<number>;
+    seek(positionMs: number): Promise<number>;
+    changePosition(deltaMs: number): Promise<number>;
+    private putWithDeviceFallback;
 }

package/dist/services/player.service.js

@@ -1,27 +1,49 @@
+import { AppError, NoActiveDeviceError } from '../utils/errors.js';
+import { mapPlaybackItem } from './mappers.js';
 export class PlayerService {
     spotify;
-    constructor(spotify) {
+    deviceService;
+    constructor(spotify, deviceService) {
         this.spotify = spotify;
+        this.deviceService = deviceService;
     }
     async getCurrentPlayback() {
         const playback = await this.spotify.get('/me/player');
         if (!playback?.item)
             return null;
+        const track = mapPlaybackItem(playback.item);
+        if (!track)
+            return null;
         return {
             isPlaying: playback.is_playing,
-            track: mapTrack(playback.item),
+            track,
             progressMs: playback.progress_ms ?? 0,
             deviceName: playback.device.name,
         };
     }
     async playTrack(uri) {
-        await this.spotify.put('/me/player/play', { body: { uris: [uri] } });
+        await this.putWithDeviceFallback('/me/player/play', { body: { uris: [uri] } });
+    }
+    async playContext(contextUri) {
+        await this.putWithDeviceFallback('/me/player/play', {
+            body: { context_uri: contextUri },
+        });
+    }
+    async setShuffle(state) {
+        await this.putWithDeviceFallback('/me/player/shuffle', {
+            query: { state },
+        });
+    }
+    async setRepeat(state) {
+        await this.putWithDeviceFallback('/me/player/repeat', {
+            query: { state },
+        });
     }
     async pause() {
         await this.spotify.put('/me/player/pause');
     }
     async resume() {
-        await this.spotify.put('/me/player/play');
+        await this.putWithDeviceFallback('/me/player/play');
     }
     async next() {
         await this.spotify.post('/me/player/next');
@@ -29,17 +51,60 @@ export class PlayerService {
     async previous() {
         await this.spotify.post('/me/player/previous');
     }
+    async setVolume(volumePercent) {
+        const volume = clampVolume(volumePercent);
+        await this.spotify.put('/me/player/volume', {
+            query: { volume_percent: volume },
+        });
+        return volume;
+    }
+    async changeVolume(delta) {
+        const playback = await this.spotify.get('/me/player');
+        if (!playback)
+            throw new NoActiveDeviceError();
+        if (!playback.device.supports_volume || playback.device.volume_percent === null) {
+            throw new AppError('The active Spotify device does not support volume control.');
+        }
+        return this.setVolume(playback.device.volume_percent + delta);
+    }
+    async seek(positionMs) {
+        const position = Math.max(0, Math.round(positionMs));
+        await this.spotify.put('/me/player/seek', {
+            query: { position_ms: position },
+        });
+        return position;
+    }
+    async changePosition(deltaMs) {
+        const playback = await this.spotify.get('/me/player');
+        if (!playback?.item) {
+            throw new AppError('Nothing is currently playing, so there is no position to seek.');
+        }
+        return this.seek((playback.progress_ms ?? 0) + deltaMs);
+    }
+    async putWithDeviceFallback(path, options) {
+        try {
+            await this.spotify.put(path, options);
+            return;
+        }
+        catch (error) {
+            if (!(error instanceof NoActiveDeviceError) || !this.deviceService)
+                throw error;
+        }
+        const devices = await this.deviceService.getControllableDevices();
+        const device = devices.length === 1 ? devices[0] : undefined;
+        if (!device?.id) {
+            if (devices.length > 1) {
+                throw new AppError('Multiple Spotify devices are available, but none is active.\n\nRun: spoti devices\nThen select one with: spoti device <number>');
+            }
+            throw new NoActiveDeviceError();
+        }
+        await this.spotify.put(path, {
+            ...options,
+            query: { ...options?.query, device_id: device.id },
+        });
+    }
 }
-function mapTrack(track) {
-    const externalUrl = track.external_urls?.spotify;
-    return {
-        id: track.id,
-        uri: track.uri,
-        name: track.name,
-        artists: track.artists.map((artist) => artist.name),
-        album: track.album.name,
-        durationMs: track.duration_ms,
-        ...(externalUrl ? { externalUrl } : {}),
-    };
+function clampVolume(volume) {
+    return Math.min(100, Math.max(0, Math.round(volume)));
 }
 //# sourceMappingURL=player.service.js.map

package/dist/services/player.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"player.service.js","sourceRoot":"","sources":["../../src/services/player.service.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,kBAAkB;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAmC,YAAY,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,EAAE,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,UAAU;YAC9B,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC9B,UAAU,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;YACrC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAO,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAO,kBAAkB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAO,iBAAiB,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAO,iBAAiB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAO,qBAAqB,CAAC,CAAC;IACvD,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAwC;IACxD,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC;IACjD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACnD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACvB,UAAU,EAAE,KAAK,CAAC,WAAW;QAC7B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"player.service.js","sourceRoot":"","sources":["../../src/services/player.service.ts"],"names":[],"mappings":"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"}

package/dist/services/playlist.service.d.ts

@@ -0,0 +1,9 @@
+import type { SpotifyApi } from '../spotify/client.js';
+import type { Playlist, PlaylistDetail, Track } from './models.js';
+export declare class PlaylistService {
+    private readonly spotify;
+    constructor(spotify: SpotifyApi);
+    listPlaylists(limit?: number): Promise<Playlist[]>;
+    getPlaylist(id: string, itemLimit?: number): Promise<PlaylistDetail>;
+    getPlaylistItems(id: string, limit?: number): Promise<Track[]>;
+}

package/dist/services/playlist.service.js

@@ -0,0 +1,33 @@
+import { mapPlaybackItem, mapPlaylist, normalizeLimit } from './mappers.js';
+const DEFAULT_PLAYLIST_LIMIT = 20;
+const DEFAULT_ITEM_LIMIT = 50;
+export class PlaylistService {
+    spotify;
+    constructor(spotify) {
+        this.spotify = spotify;
+    }
+    async listPlaylists(limit = DEFAULT_PLAYLIST_LIMIT) {
+        const response = await this.spotify.get('/me/playlists', { query: { limit: normalizeLimit(limit) } });
+        return response.items.map(mapPlaylist).sort(comparePlaylists);
+    }
+    async getPlaylist(id, itemLimit = DEFAULT_ITEM_LIMIT) {
+        const playlist = await this.spotify.get(`/playlists/${encodeURIComponent(id)}`);
+        const tracks = await this.getPlaylistItems(id, itemLimit);
+        return { ...mapPlaylist(playlist), tracks };
+    }
+    async getPlaylistItems(id, limit = DEFAULT_ITEM_LIMIT) {
+        const response = await this.spotify.get(`/playlists/${encodeURIComponent(id)}/items`, { query: { limit: normalizeLimit(limit) } });
+        return response.items
+            .map(({ item }) => mapPlaybackItem(item))
+            .filter((track) => track !== null);
+    }
+}
+function comparePlaylists(left, right) {
+    const nameComparison = left.name.localeCompare(right.name, undefined, {
+        sensitivity: 'base',
+    });
+    if (nameComparison !== 0)
+        return nameComparison;
+    return left.id.localeCompare(right.id);
+}
+//# sourceMappingURL=playlist.service.js.map

package/dist/services/playlist.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlist.service.js","sourceRoot":"","sources":["../../src/services/playlist.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG5E,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,aAAa,CAAC,KAAK,GAAG,sBAAsB;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,eAAe,EACf,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAC5C,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,SAAS,GAAG,kBAAkB;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,CACvC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,EAAU,EAAE,KAAK,GAAG,kBAAkB;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,cAAc,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAC5C,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAC5C,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK;aAClB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;aACxC,MAAM,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACvD,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,IAAc,EAAE,KAAe;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE;QACpE,WAAW,EAAE,MAAM;KACpB,CAAC,CAAC;IACH,IAAI,cAAc,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAChD,OAAO,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/services/queue.service.d.ts

@@ -0,0 +1,18 @@
+import type { SpotifyApi } from '../spotify/client.js';
+export interface QueueItem {
+    name: string;
+    uri: string;
+    type: 'track' | 'episode';
+    subtitle: string;
+    durationMs: number;
+}
+export interface PlaybackQueue {
+    currentlyPlaying: QueueItem | null;
+    queue: QueueItem[];
+}
+export declare class QueueService {
+    private readonly spotify;
+    constructor(spotify: SpotifyApi);
+    getQueue(): Promise<PlaybackQueue>;
+    addItem(uri: string): Promise<void>;
+}

package/dist/services/queue.service.js

@@ -0,0 +1,43 @@
+export class QueueService {
+    spotify;
+    constructor(spotify) {
+        this.spotify = spotify;
+    }
+    async getQueue() {
+        const response = await this.spotify.get('/me/player/queue');
+        return {
+            currentlyPlaying: response.currently_playing
+                ? mapQueueItem(response.currently_playing)
+                : null,
+            queue: response.queue
+                .map(mapQueueItem)
+                .filter((item) => item !== null),
+        };
+    }
+    async addItem(uri) {
+        await this.spotify.post('/me/player/queue', { query: { uri } });
+    }
+}
+function mapQueueItem(item) {
+    switch (item.type) {
+        case 'track':
+            return {
+                name: item.name,
+                uri: item.uri,
+                type: item.type,
+                subtitle: item.artists.map((artist) => artist.name).join(', '),
+                durationMs: item.duration_ms,
+            };
+        case 'episode':
+            return {
+                name: item.name,
+                uri: item.uri,
+                type: item.type,
+                subtitle: item.show.name,
+                durationMs: item.duration_ms,
+            };
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=queue.service.js.map

package/dist/services/queue.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.service.js","sourceRoot":"","sources":["../../src/services/queue.service.ts"],"names":[],"mappings":"AAsCA,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAuB,kBAAkB,CAAC,CAAC;QAElF,OAAO;YACL,gBAAgB,EAAE,QAAQ,CAAC,iBAAiB;gBAC1C,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAC1C,CAAC,CAAC,IAAI;YACR,KAAK,EAAE,QAAQ,CAAC,KAAK;iBAClB,GAAG,CAAC,YAAY,CAAC;iBACjB,MAAM,CAAC,CAAC,IAAI,EAAqB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAO,kBAAkB,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;CACF;AAED,SAAS,YAAY,CAAC,IAAsB;IAC1C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9D,UAAU,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;gBACxB,UAAU,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/services/recent.service.d.ts

@@ -0,0 +1,7 @@
+import type { SpotifyApi } from '../spotify/client.js';
+import type { RecentlyPlayedTrack } from './models.js';
+export declare class RecentService {
+    private readonly spotify;
+    constructor(spotify: SpotifyApi);
+    getRecentlyPlayed(limit?: number): Promise<RecentlyPlayedTrack[]>;
+}

package/dist/services/recent.service.js

@@ -0,0 +1,24 @@
+import { mapPlaybackItem, normalizeLimit } from './mappers.js';
+const DEFAULT_RECENT_LIMIT = 20;
+export class RecentService {
+    spotify;
+    constructor(spotify) {
+        this.spotify = spotify;
+    }
+    async getRecentlyPlayed(limit = DEFAULT_RECENT_LIMIT) {
+        const response = await this.spotify.get('/me/player/recently-played', { query: { limit: normalizeLimit(limit) } });
+        return response.items.flatMap(({ track, played_at: playedAt, context }) => {
+            const mapped = mapPlaybackItem(track);
+            if (!mapped)
+                return [];
+            return [
+                {
+                    playedAt,
+                    track: mapped,
+                    ...(context?.uri ? { contextUri: context.uri } : {}),
+                },
+            ];
+        });
+    }
+}
+//# sourceMappingURL=recent.service.js.map

package/dist/services/recent.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent.service.js","sourceRoot":"","sources":["../../src/services/recent.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG/D,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,iBAAiB,CAAC,KAAK,GAAG,oBAAoB;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,4BAA4B,EAC5B,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAC5C,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YACxE,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YACvB,OAAO;gBACL;oBACE,QAAQ;oBACR,KAAK,EAAE,MAAM;oBACb,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrD;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/services/search.service.d.ts

@@ -1,7 +1,11 @@
 import type { SpotifyApi } from '../spotify/client.js';
-import type { Track } from './models.js';
+import type { Album, Artist, Playlist, Track } from './models.js';
 export declare class SearchService {
     private readonly spotify;
     constructor(spotify: SpotifyApi);
     searchTracks(query: string, limit?: number): Promise<Track[]>;
+    searchAlbums(query: string, limit?: number): Promise<Album[]>;
+    searchArtists(query: string, limit?: number): Promise<Artist[]>;
+    searchPlaylists(query: string, limit?: number): Promise<Playlist[]>;
+    private search;
 }

package/dist/services/search.service.js

@@ -1,28 +1,43 @@
+import { mapAlbum, mapArtist, mapPlaylist, mapTrack, normalizeLimit } from './mappers.js';
+const DEFAULT_SEARCH_LIMIT = 10;
 export class SearchService {
     spotify;
     constructor(spotify) {
         this.spotify = spotify;
     }
-    async searchTracks(query, limit = 10) {
+    async searchTracks(query, limit = DEFAULT_SEARCH_LIMIT) {
+        const response = await this.search(query, 'track', limit);
+        return (response?.tracks?.items ?? [])
+            .map(mapTrack)
+            .filter((track) => track !== null);
+    }
+    async searchAlbums(query, limit = DEFAULT_SEARCH_LIMIT) {
+        const response = await this.search(query, 'album', limit);
+        return (response?.albums?.items ?? [])
+            .map(mapAlbum)
+            .filter((album) => album !== null);
+    }
+    async searchArtists(query, limit = DEFAULT_SEARCH_LIMIT) {
+        const response = await this.search(query, 'artist', limit);
+        return (response?.artists?.items ?? []).map(mapArtist);
+    }
+    async searchPlaylists(query, limit = DEFAULT_SEARCH_LIMIT) {
+        const response = await this.search(query, 'playlist', limit);
+        return (response?.playlists?.items ?? [])
+            .filter((playlist) => playlist !== null)
+            .map(mapPlaylist);
+    }
+    async search(query, type, limit) {
         const normalizedQuery = query.trim();
         if (!normalizedQuery)
-            return [];
-        const response = await this.spotify.get('/search', {
-            query: { q: normalizedQuery, type: 'track', limit },
+            return null;
+        return this.spotify.get('/search', {
+            query: {
+                q: normalizedQuery,
+                type,
+                limit: normalizeLimit(limit, DEFAULT_SEARCH_LIMIT, 10),
+            },
         });
-        return response.tracks.items.map(mapTrack);
     }
 }
-function mapTrack(track) {
-    const externalUrl = track.external_urls?.spotify;
-    return {
-        id: track.id,
-        uri: track.uri,
-        name: track.name,
-        artists: track.artists.map((artist) => artist.name),
-        album: track.album.name,
-        durationMs: track.duration_ms,
-        ...(externalUrl ? { externalUrl } : {}),
-    };
-}
 //# sourceMappingURL=search.service.js.map

package/dist/services/search.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.service.js","sourceRoot":"","sources":["../../src/services/search.service.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC1C,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAwB,SAAS,EAAE;YACxE,KAAK,EAAE,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;SACpD,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAmB;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC;IACjD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACnD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACvB,UAAU,EAAE,KAAK,CAAC,WAAW;QAC7B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search.service.js","sourceRoot":"","sources":["../../src/services/search.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG1F,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,oBAAoB;QAC5D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;aACnC,GAAG,CAAC,QAAQ,CAAC;aACb,MAAM,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,oBAAoB;QAC5D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;aACnC,GAAG,CAAC,QAAQ,CAAC;aACb,MAAM,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,KAAK,GAAG,oBAAoB;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa,EAAE,KAAK,GAAG,oBAAoB;QAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;aACtC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC;aACvC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,KAAa,EACb,IAA+C,EAC/C,KAAa;QAEb,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAwB,SAAS,EAAE;YACxD,KAAK,EAAE;gBACL,CAAC,EAAE,eAAe;gBAClB,IAAI;gBACJ,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,CAAC;aACvD;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/services/update.service.d.ts

@@ -0,0 +1,57 @@
+import { type UpdateCacheStore } from '../storage/update-cache.js';
+export declare const SPOTI_PACKAGE_NAME = "@bzenky/spoti";
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/%40bzenky%2Fspoti";
+export declare const UPDATE_CHECK_INTERVAL_MS: number;
+export declare const UPDATE_CHECK_TIMEOUT_MS = 3000;
+export declare const UPDATE_COMMAND = "npm install -g @bzenky/spoti@latest";
+export type UpdateStatus = 'current' | 'update-available';
+export type UpdateCheckSource = 'cache' | 'registry';
+export interface UpdateCheckResult {
+    status: UpdateStatus;
+    currentVersion: string;
+    latestVersion: string;
+    checkedAt: number;
+    source: UpdateCheckSource;
+}
+export interface UpdateChecker {
+    checkInBackground(): Promise<UpdateCheckResult | null>;
+}
+export interface UpdateCommandRunner {
+    run(command: string, args: readonly string[]): Promise<void>;
+}
+export interface UpdateServiceDependencies {
+    cache?: UpdateCacheStore;
+    fetch?: typeof globalThis.fetch;
+    now?: () => number;
+    timeoutMs?: number;
+    checkIntervalMs?: number;
+    commandRunner?: UpdateCommandRunner;
+}
+export declare class UpdateCheckError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class UpdateInstallError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class UpdateService implements UpdateChecker {
+    private readonly currentVersion;
+    private readonly cache;
+    private readonly fetchImplementation;
+    private readonly clock;
+    private readonly timeoutMs;
+    private readonly checkIntervalMs;
+    private readonly commandRunner;
+    constructor(currentVersion: string, dependencies?: UpdateServiceDependencies);
+    /** Always contacts npm and reports actionable failures. Intended for `spoti update --check`. */
+    checkForeground(): Promise<UpdateCheckResult>;
+    /** Uses the 24-hour cache and hides failures so normal commands remain unaffected. */
+    checkInBackground(): Promise<UpdateCheckResult | null>;
+    /** The caller must obtain explicit user confirmation before setting `confirmed` to true. */
+    installLatest(confirmed: boolean, version: string): Promise<void>;
+    private fetchLatest;
+    private recordFailedCheck;
+}
+export declare class NodeUpdateCommandRunner implements UpdateCommandRunner {
+    run(command: string, args: readonly string[]): Promise<void>;
+}
+export declare function compareSemanticVersions(left: string, right: string): number;