@lucaperret/tidal-cli 1.1.0 → 1.2.2

package/dist/track.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTrackInfoData = getTrackInfoData;
 exports.getTrackInfo = getTrackInfo;
+exports.getTrackRadioData = getTrackRadioData;
 exports.getTrackRadio = getTrackRadio;
+exports.getTrackByIsrcData = getTrackByIsrcData;
 exports.getTrackByIsrc = getTrackByIsrc;
+exports.getSimilarTracksData = getSimilarTracksData;
 exports.getSimilarTracks = getSimilarTracks;
 const auth_1 = require("./auth");
 function formatDuration(isoDuration) {
@@ -16,20 +20,18 @@ function formatDuration(isoDuration) {
     const s = (match[3] ?? '0').padStart(2, '0');
     return `${h}${m}:${s}`;
 }
-async function getTrackInfo(trackId, json) {
-    const client = await (0, auth_1.getApiClient)();
+async function getTrackInfoData(trackId, client, countryCode) {
     const { data, error } = await client.GET('/tracks/{id}', {
         params: {
             path: { id: trackId },
             query: {
-                countryCode: await (0, auth_1.getCountryCode)(),
+                countryCode,
                 include: ['artists', 'albums'],
             },
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to get track info — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to get track info — ${JSON.stringify(error)}`);
     }
     const attrs = data.data?.attributes ?? {};
     const included = data.included ?? [];
@@ -38,25 +40,23 @@ async function getTrackInfo(trackId, json) {
         .map((item) => item.attributes?.name ?? item.id);
     const album = included.find((item) => item.type === 'albums');
     const albumName = album?.attributes?.title ?? undefined;
-    // Fetch cover art if we have an album
     let coverUrl;
     if (album?.id) {
         try {
             const { data: artData } = await client.GET('/albums/{id}/relationships/coverArt', {
                 params: {
                     path: { id: album.id },
-                    query: { countryCode: await (0, auth_1.getCountryCode)(), include: ['coverArt'] },
+                    query: { countryCode, include: ['coverArt'] },
                 },
             });
             const artwork = (artData?.included ?? []).find((i) => i.type === 'artworks');
             const files = artwork?.attributes?.files ?? [];
-            // Pick 640x640 or the largest available
             const preferred = files.find((f) => f.meta?.width === 640) ?? files[0];
             coverUrl = preferred?.href;
         }
         catch { }
     }
-    const result = {
+    return {
         id: trackId,
         title: attrs.title ?? 'Unknown',
         artists,
@@ -69,50 +69,58 @@ async function getTrackInfo(trackId, json) {
         explicit: attrs.explicit,
         coverUrl,
     };
-    if (json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    console.log(`\nTrack: [${result.id}] ${result.title}`);
-    if (result.artists.length > 0)
-        console.log(`  Artists: ${result.artists.join(', ')}`);
-    if (result.album)
-        console.log(`  Album: ${result.album}`);
-    if (result.duration)
-        console.log(`  Duration: ${result.duration}`);
-    if (result.isrc)
-        console.log(`  ISRC: ${result.isrc}`);
-    if (result.bpm !== undefined)
-        console.log(`  BPM: ${result.bpm}`);
-    if (result.key !== undefined)
-        console.log(`  Key: ${result.key}`);
-    if (result.popularity !== undefined)
-        console.log(`  Popularity: ${result.popularity}`);
-    if (result.explicit !== undefined)
-        console.log(`  Explicit: ${result.explicit}`);
-    if (result.coverUrl)
-        console.log(`  Cover: ${result.coverUrl}`);
-    console.log();
 }
-async function getTrackRadio(trackId, json) {
+async function getTrackInfo(trackId, json) {
     const client = await (0, auth_1.getApiClient)();
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const result = await getTrackInfoData(trackId, client, countryCode);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nTrack: [${result.id}] ${result.title}`);
+        if (result.artists.length > 0)
+            console.log(`  Artists: ${result.artists.join(', ')}`);
+        if (result.album)
+            console.log(`  Album: ${result.album}`);
+        if (result.duration)
+            console.log(`  Duration: ${result.duration}`);
+        if (result.isrc)
+            console.log(`  ISRC: ${result.isrc}`);
+        if (result.bpm !== undefined)
+            console.log(`  BPM: ${result.bpm}`);
+        if (result.key !== undefined)
+            console.log(`  Key: ${result.key}`);
+        if (result.popularity !== undefined)
+            console.log(`  Popularity: ${result.popularity}`);
+        if (result.explicit !== undefined)
+            console.log(`  Explicit: ${result.explicit}`);
+        if (result.coverUrl)
+            console.log(`  Cover: ${result.coverUrl}`);
+        console.log();
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function getTrackRadioData(trackId, client, countryCode) {
     const { data, error } = await client.GET('/tracks/{id}/relationships/radio', {
         params: {
             path: { id: trackId },
             query: {
-                countryCode: await (0, auth_1.getCountryCode)(),
+                countryCode,
                 include: ['radio'],
             },
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to get track radio — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to get track radio — ${JSON.stringify(error)}`);
     }
-    // Radio returns playlists (mix playlists), not individual tracks
     const radioData = data.data ?? [];
     const included = data.included ?? [];
-    const playlists = radioData.map((item) => {
+    return radioData.map((item) => {
         const incl = included.find((i) => i.id === item.id && i.type === 'playlists');
         const attrs = incl?.attributes ?? {};
         return {
@@ -122,38 +130,47 @@ async function getTrackRadio(trackId, json) {
             numberOfItems: attrs.numberOfItems,
         };
     });
-    if (json) {
-        console.log(JSON.stringify(playlists, null, 2));
-        return;
-    }
-    if (playlists.length === 0) {
-        console.log(`No radio found for track ${trackId}.`);
-        return;
+}
+async function getTrackRadio(trackId, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const playlists = await getTrackRadioData(trackId, client, countryCode);
+        if (json) {
+            console.log(JSON.stringify(playlists, null, 2));
+            return;
+        }
+        if (playlists.length === 0) {
+            console.log(`No radio found for track ${trackId}.`);
+            return;
+        }
+        console.log(`\nRadio for track ${trackId}:\n`);
+        for (const p of playlists) {
+            console.log(`  [${p.id}] ${p.name ?? 'Radio Mix'}${p.numberOfItems ? ` (${p.numberOfItems} tracks)` : ''}`);
+        }
+        console.log();
     }
-    console.log(`\nRadio for track ${trackId}:\n`);
-    for (const p of playlists) {
-        console.log(`  [${p.id}] ${p.name ?? 'Radio Mix'}${p.numberOfItems ? ` (${p.numberOfItems} tracks)` : ''}`);
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log();
 }
-async function getTrackByIsrc(isrc, json) {
-    const client = await (0, auth_1.getApiClient)();
+async function getTrackByIsrcData(isrc, client, countryCode) {
     const { data, error } = await client.GET('/tracks', {
         params: {
             query: {
-                countryCode: await (0, auth_1.getCountryCode)(),
+                countryCode,
                 'filter[isrc]': [isrc],
                 include: ['artists'],
             },
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to get track by ISRC — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to get track by ISRC — ${JSON.stringify(error)}`);
     }
     const items = data.data ?? [];
     const included = data.included ?? [];
-    const tracks = items.map((item) => {
+    return items.map((item) => {
         const attrs = item.attributes;
         const artistRels = item.relationships?.artists?.data ?? [];
         const artistNames = artistRels.map((rel) => {
@@ -169,41 +186,50 @@ async function getTrackByIsrc(isrc, json) {
             popularity: attrs?.popularity,
         };
     });
-    if (json) {
-        console.log(JSON.stringify(tracks, null, 2));
-        return;
-    }
-    if (tracks.length === 0) {
-        console.log(`No tracks found for ISRC ${isrc}.`);
-        return;
+}
+async function getTrackByIsrc(isrc, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const tracks = await getTrackByIsrcData(isrc, client, countryCode);
+        if (json) {
+            console.log(JSON.stringify(tracks, null, 2));
+            return;
+        }
+        if (tracks.length === 0) {
+            console.log(`No tracks found for ISRC ${isrc}.`);
+            return;
+        }
+        console.log(`\nTracks matching ISRC ${isrc}:\n`);
+        for (const t of tracks) {
+            const artistStr = t.artists.length > 0 ? ` by ${t.artists.join(', ')}` : '';
+            const extras = [t.duration, t.popularity !== undefined ? `popularity: ${t.popularity}` : undefined]
+                .filter(Boolean)
+                .join(', ');
+            console.log(`  [${t.id}] ${t.title}${artistStr}${extras ? ` (${extras})` : ''}`);
+        }
+        console.log();
     }
-    console.log(`\nTracks matching ISRC ${isrc}:\n`);
-    for (const t of tracks) {
-        const artistStr = t.artists.length > 0 ? ` by ${t.artists.join(', ')}` : '';
-        const extras = [t.duration, t.popularity !== undefined ? `popularity: ${t.popularity}` : undefined]
-            .filter(Boolean)
-            .join(', ');
-        console.log(`  [${t.id}] ${t.title}${artistStr}${extras ? ` (${extras})` : ''}`);
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log();
 }
-async function getSimilarTracks(trackId, json) {
-    const client = await (0, auth_1.getApiClient)();
+async function getSimilarTracksData(trackId, client, countryCode) {
     const { data, error } = await client.GET('/tracks/{id}/relationships/similarTracks', {
         params: {
             path: { id: trackId },
             query: {
-                countryCode: await (0, auth_1.getCountryCode)(),
+                countryCode,
                 include: ['similarTracks'],
             },
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to get similar tracks — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to get similar tracks — ${JSON.stringify(error)}`);
     }
     const included = data.included ?? [];
-    const tracks = included
+    return included
         .filter((item) => item.type === 'tracks')
         .map((item) => {
         const attrs = item.attributes;
@@ -215,21 +241,32 @@ async function getSimilarTracks(trackId, json) {
             popularity: attrs?.popularity,
         };
     });
-    if (json) {
-        console.log(JSON.stringify(tracks, null, 2));
-        return;
-    }
-    if (tracks.length === 0) {
-        console.log(`No similar tracks found for track ${trackId}.`);
-        return;
+}
+async function getSimilarTracks(trackId, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const tracks = await getSimilarTracksData(trackId, client, countryCode);
+        if (json) {
+            console.log(JSON.stringify(tracks, null, 2));
+            return;
+        }
+        if (tracks.length === 0) {
+            console.log(`No similar tracks found for track ${trackId}.`);
+            return;
+        }
+        console.log(`\nSimilar tracks to ${trackId}:\n`);
+        for (const t of tracks) {
+            const extras = [t.duration, t.popularity !== undefined ? `popularity: ${t.popularity}` : undefined]
+                .filter(Boolean)
+                .join(', ');
+            console.log(`  [${t.id}] ${t.title}${extras ? ` (${extras})` : ''}`);
+        }
+        console.log();
     }
-    console.log(`\nSimilar tracks to ${trackId}:\n`);
-    for (const t of tracks) {
-        const extras = [t.duration, t.popularity !== undefined ? `popularity: ${t.popularity}` : undefined]
-            .filter(Boolean)
-            .join(', ');
-        console.log(`  [${t.id}] ${t.title}${extras ? ` (${extras})` : ''}`);
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log();
 }
 //# sourceMappingURL=track.js.map

package/dist/types.d.ts

@@ -0,0 +1,158 @@
+export type SearchType = 'artist' | 'album' | 'track' | 'video' | 'playlist';
+export interface SearchResult {
+    id: string;
+    type: string;
+    name: string;
+    extra?: Record<string, unknown>;
+}
+export interface SearchSuggestionsResult {
+    suggestions: string[];
+    directHits: Array<{
+        id: string;
+        type: string;
+        name: string;
+    }>;
+}
+export interface ArtistInfo {
+    id: string;
+    name: string;
+    popularity?: number;
+    handle?: string;
+    biography?: string;
+}
+export interface ArtistTrack {
+    id: string;
+    title: string;
+    duration: string;
+    isrc?: string;
+    popularity?: number;
+}
+export interface ArtistAlbum {
+    id: string;
+    title: string;
+    albumType?: string;
+    releaseDate?: string;
+    numberOfItems?: number;
+}
+export interface SimilarArtist {
+    id: string;
+    name: string;
+    popularity?: number;
+}
+export interface RadioPlaylist {
+    id: string;
+    type?: string;
+    name: string;
+    numberOfItems?: number;
+}
+export interface TrackInfo {
+    id: string;
+    title: string;
+    artists: string[];
+    album?: string;
+    duration: string;
+    isrc?: string;
+    bpm?: number;
+    key?: string;
+    popularity?: number;
+    explicit?: boolean;
+    coverUrl?: string;
+}
+export interface SimilarTrack {
+    id: string;
+    title: string;
+    duration: string;
+    isrc?: string;
+    popularity?: number;
+}
+export interface AlbumInfo {
+    id: string;
+    title: string;
+    artists: string[];
+    albumType?: string;
+    releaseDate?: string;
+    numberOfItems?: number;
+    duration: string;
+    popularity?: number;
+    explicit?: boolean;
+    barcodeId?: string;
+    coverUrl?: string;
+}
+export interface AlbumResult {
+    id: string;
+    title: string;
+    albumType?: string;
+    releaseDate?: string;
+    numberOfItems?: number;
+    duration: string;
+    barcodeId?: string;
+}
+export interface PlaylistInfo {
+    id: string;
+    name: string;
+    description?: string;
+    numberOfItems?: number;
+    createdAt?: string;
+    lastModifiedAt?: string;
+}
+export interface PlaybackInfo {
+    trackId: string;
+    presentation?: string;
+    previewReason?: string;
+    audioQuality?: string;
+    formats?: string[];
+    manifestMimeType?: string;
+    trackReplayGain?: number;
+    trackPeakAmplitude?: number;
+    albumReplayGain?: number;
+    albumPeakAmplitude?: number;
+}
+export interface PlaybackUrl {
+    trackId: string;
+    audioQuality?: string;
+    url?: string;
+    type?: 'direct' | 'dash';
+    initUrl?: string;
+    segmentCount?: number;
+}
+export interface UserProfile {
+    id: string;
+    username: string;
+    country: string;
+    email?: string;
+}
+export type MixCategory = 'daily' | 'discovery' | 'new-release' | 'offline';
+export interface RecommendationItem {
+    id: string;
+    type: string;
+    name: string;
+    category?: MixCategory;
+}
+export interface MixItem {
+    id: string;
+    type: string;
+    name: string;
+}
+export interface RecentItem {
+    id: string;
+    name: string;
+    addedAt?: string;
+}
+export interface SearchHistoryEntry {
+    id: string;
+    query: string;
+}
+export type SavedItemType = 'tracks' | 'albums' | 'artists' | 'playlists' | 'videos';
+export interface SavedItem {
+    id: string;
+    type: string;
+    name: string;
+}
+export interface ShareLink {
+    id: string;
+    code: string;
+    createdAt?: string;
+    url?: string;
+}
+export type LibraryResourceType = 'artist' | 'album' | 'track' | 'video';
+export type RecentType = 'tracks' | 'albums' | 'artists';

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Shared types for *Data() functions used by both CLI and MCP server
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/user.d.ts

@@ -1 +1,4 @@
+import type { UserProfile } from './types';
+export type { UserProfile };
+export declare function getUserProfileData(client: any): Promise<UserProfile>;
 export declare function getUserProfile(json: boolean): Promise<void>;

package/dist/user.js

@@ -1,36 +1,45 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserProfileData = getUserProfileData;
 exports.getUserProfile = getUserProfile;
 const auth_1 = require("./auth");
-async function getUserProfile(json) {
-    const client = await (0, auth_1.getApiClient)();
+async function getUserProfileData(client) {
     const { data, error } = await client.GET('/users/me', {
         params: {},
     });
     if (error || !data) {
-        console.error(`Error: Failed to get user profile — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to get user profile — ${JSON.stringify(error)}`);
     }
     const attrs = data.data?.attributes ?? {};
-    const result = {
+    return {
         id: data.data?.id,
         username: attrs.username,
         country: attrs.country,
         email: attrs.email,
     };
-    if (json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
+}
+async function getUserProfile(json) {
+    const client = await (0, auth_1.getApiClient)();
+    try {
+        const result = await getUserProfileData(client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log('\nUser profile:');
+        if (result.id)
+            console.log(`  ID: ${result.id}`);
+        if (result.username)
+            console.log(`  Username: ${result.username}`);
+        if (result.country)
+            console.log(`  Country: ${result.country}`);
+        if (result.email)
+            console.log(`  Email: ${result.email}`);
+        console.log();
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log('\nUser profile:');
-    if (result.id)
-        console.log(`  ID: ${result.id}`);
-    if (result.username)
-        console.log(`  Username: ${result.username}`);
-    if (result.country)
-        console.log(`  Country: ${result.country}`);
-    if (result.email)
-        console.log(`  Email: ${result.email}`);
-    console.log();
 }
 //# sourceMappingURL=user.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaperret/tidal-cli",
-  "version": "1.1.0",
+  "version": "1.2.2",
   "description": "CLI for Tidal music streaming service, designed for LLM agent automation",
   "main": "dist/index.js",
   "bin": {
@@ -35,6 +35,10 @@
   "bugs": {
     "url": "https://github.com/lucaperret/tidal-cli/issues"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "type": "commonjs",
   "engines": {
     "node": ">=20"
@@ -47,13 +51,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tidal-music/api": "^0.9.1",
-    "@tidal-music/auth": "^1.4.0",
+    "@tidal-music/api": "^0.22.0",
+    "@tidal-music/auth": "^1.6.0",
     "commander": "^14.0.3"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5",
+    "zod": "^4.4.3"
   }
 }