@lucaperret/tidal-cli 1.1.0 → 1.2.2

package/dist/playlist.d.ts

@@ -1,9 +1,52 @@
+import type { PlaylistInfo } from './types';
+export type { PlaylistInfo };
+export declare function listPlaylistsData(client: any, countryCode: string): Promise<PlaylistInfo[]>;
 export declare function listPlaylists(json: boolean): Promise<void>;
+export declare function createPlaylistData(name: string, description: string, client: any): Promise<{
+    id: string;
+    name: string;
+    description: string;
+}>;
 export declare function createPlaylist(name: string, description: string, json: boolean): Promise<void>;
+export declare function renamePlaylistData(playlistId: string, name: string, client: any): Promise<{
+    id: string;
+    name: string;
+    success: boolean;
+}>;
 export declare function renamePlaylist(playlistId: string, name: string, json: boolean): Promise<void>;
+export declare function deletePlaylistData(playlistId: string, client: any): Promise<{
+    id: string;
+    deleted: boolean;
+}>;
 export declare function deletePlaylist(playlistId: string, json: boolean): Promise<void>;
+export declare function addTrackToPlaylistData(playlistId: string, trackId: string, client: any): Promise<{
+    playlistId: string;
+    trackId: string;
+    added: boolean;
+}>;
 export declare function addTrackToPlaylist(playlistId: string, trackId: string, json: boolean): Promise<void>;
+export declare function removeTrackFromPlaylistData(playlistId: string, trackId: string, client: any): Promise<{
+    playlistId: string;
+    trackId: string;
+    removed: boolean;
+}>;
 export declare function removeTrackFromPlaylist(playlistId: string, trackId: string, json: boolean): Promise<void>;
+export declare function addAlbumToPlaylistData(playlistId: string, albumId: string, client: any, countryCode: string): Promise<{
+    playlistId: string;
+    albumId: string;
+    tracksAdded: number;
+}>;
 export declare function addAlbumToPlaylist(playlistId: string, albumId: string, json: boolean): Promise<void>;
+export declare function moveTrackInPlaylistData(playlistId: string, trackId: string, positionBefore: string, client: any): Promise<{
+    playlistId: string;
+    trackId: string;
+    positionBefore: string;
+    moved: boolean;
+}>;
 export declare function moveTrackInPlaylist(playlistId: string, trackId: string, positionBefore: string, json: boolean): Promise<void>;
+export declare function updatePlaylistDescriptionData(playlistId: string, description: string, client: any): Promise<{
+    id: string;
+    description: string;
+    success: boolean;
+}>;
 export declare function updatePlaylistDescription(playlistId: string, description: string, json: boolean): Promise<void>;

package/dist/playlist.js

@@ -1,30 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.listPlaylistsData = listPlaylistsData;
 exports.listPlaylists = listPlaylists;
+exports.createPlaylistData = createPlaylistData;
 exports.createPlaylist = createPlaylist;
+exports.renamePlaylistData = renamePlaylistData;
 exports.renamePlaylist = renamePlaylist;
+exports.deletePlaylistData = deletePlaylistData;
 exports.deletePlaylist = deletePlaylist;
+exports.addTrackToPlaylistData = addTrackToPlaylistData;
 exports.addTrackToPlaylist = addTrackToPlaylist;
+exports.removeTrackFromPlaylistData = removeTrackFromPlaylistData;
 exports.removeTrackFromPlaylist = removeTrackFromPlaylist;
+exports.addAlbumToPlaylistData = addAlbumToPlaylistData;
 exports.addAlbumToPlaylist = addAlbumToPlaylist;
+exports.moveTrackInPlaylistData = moveTrackInPlaylistData;
 exports.moveTrackInPlaylist = moveTrackInPlaylist;
+exports.updatePlaylistDescriptionData = updatePlaylistDescriptionData;
 exports.updatePlaylistDescription = updatePlaylistDescription;
 const auth_1 = require("./auth");
-async function listPlaylists(json) {
-    const client = await (0, auth_1.getApiClient)();
+async function listPlaylistsData(client, countryCode) {
     const { data, error } = await client.GET('/playlists', {
         params: {
             query: {
                 'filter[owners.id]': ['me'],
-                countryCode: await (0, auth_1.getCountryCode)(),
+                countryCode,
             },
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to list playlists — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to list playlists — ${JSON.stringify(error)}`);
     }
-    const playlists = (data.data ?? []).map((p) => ({
+    return (data.data ?? []).map((p) => ({
         id: p.id,
         name: p.attributes?.name ?? 'Untitled',
         description: p.attributes?.description,
@@ -32,24 +39,34 @@ async function listPlaylists(json) {
         createdAt: p.attributes?.createdAt,
         lastModifiedAt: p.attributes?.lastModifiedAt,
     }));
-    if (json) {
-        console.log(JSON.stringify(playlists, null, 2));
-        return;
-    }
-    if (playlists.length === 0) {
-        console.log('No playlists found.');
-        return;
+}
+async function listPlaylists(json) {
+    const client = await (0, auth_1.getApiClient)();
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const playlists = await listPlaylistsData(client, countryCode);
+        if (json) {
+            console.log(JSON.stringify(playlists, null, 2));
+            return;
+        }
+        if (playlists.length === 0) {
+            console.log('No playlists found.');
+            return;
+        }
+        console.log('\nYour playlists:\n');
+        for (const p of playlists) {
+            console.log(`  [${p.id}] ${p.name} (${p.numberOfItems ?? 0} tracks)`);
+            if (p.description)
+                console.log(`    ${p.description}`);
+        }
+        console.log();
     }
-    console.log('\nYour playlists:\n');
-    for (const p of playlists) {
-        console.log(`  [${p.id}] ${p.name} (${p.numberOfItems ?? 0} tracks)`);
-        if (p.description)
-            console.log(`    ${p.description}`);
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log();
 }
-async function createPlaylist(name, description, json) {
-    const client = await (0, auth_1.getApiClient)();
+async function createPlaylistData(name, description, client) {
     const { data, error } = await client.POST('/playlists', {
         body: {
             data: {
@@ -63,23 +80,31 @@ async function createPlaylist(name, description, json) {
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to create playlist — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to create playlist — ${JSON.stringify(error)}`);
     }
     const created = data.data;
-    const result = {
+    return {
         id: created.id,
         name: created.attributes?.name ?? name,
         description: created.attributes?.description ?? description,
     };
-    if (json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    console.log(`\nPlaylist created: [${result.id}] ${result.name}`);
 }
-async function renamePlaylist(playlistId, name, json) {
+async function createPlaylist(name, description, json) {
     const client = await (0, auth_1.getApiClient)();
+    try {
+        const result = await createPlaylistData(name, description, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nPlaylist created: [${result.id}] ${result.name}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function renamePlaylistData(playlistId, name, client) {
     const { error } = await client.PATCH('/playlists/{id}', {
         params: { path: { id: playlistId } },
         body: {
@@ -91,32 +116,50 @@ async function renamePlaylist(playlistId, name, json) {
         },
     });
     if (error) {
-        console.error(`Error: Failed to rename playlist — ${JSON.stringify(error)}`);
-        process.exit(1);
-    }
-    if (json) {
-        console.log(JSON.stringify({ id: playlistId, name, success: true }, null, 2));
-        return;
+        throw new Error(`Failed to rename playlist — ${JSON.stringify(error)}`);
     }
-    console.log(`\nPlaylist ${playlistId} renamed to "${name}".`);
+    return { id: playlistId, name, success: true };
 }
-async function deletePlaylist(playlistId, json) {
+async function renamePlaylist(playlistId, name, json) {
     const client = await (0, auth_1.getApiClient)();
+    try {
+        const result = await renamePlaylistData(playlistId, name, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nPlaylist ${playlistId} renamed to "${name}".`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function deletePlaylistData(playlistId, client) {
     const { error } = await client.DELETE('/playlists/{id}', {
         params: { path: { id: playlistId } },
     });
     if (error) {
-        console.error(`Error: Failed to delete playlist — ${JSON.stringify(error)}`);
-        process.exit(1);
-    }
-    if (json) {
-        console.log(JSON.stringify({ id: playlistId, deleted: true }, null, 2));
-        return;
+        throw new Error(`Failed to delete playlist — ${JSON.stringify(error)}`);
     }
-    console.log(`\nPlaylist ${playlistId} deleted.`);
+    return { id: playlistId, deleted: true };
 }
-async function addTrackToPlaylist(playlistId, trackId, json) {
+async function deletePlaylist(playlistId, json) {
     const client = await (0, auth_1.getApiClient)();
+    try {
+        const result = await deletePlaylistData(playlistId, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nPlaylist ${playlistId} deleted.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function addTrackToPlaylistData(playlistId, trackId, client) {
     const { error } = await client.POST('/playlists/{id}/relationships/items', {
         params: { path: { id: playlistId } },
         body: {
@@ -124,30 +167,36 @@ async function addTrackToPlaylist(playlistId, trackId, json) {
         },
     });
     if (error) {
-        console.error(`Error: Failed to add track — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to add track — ${JSON.stringify(error)}`);
     }
-    if (json) {
-        console.log(JSON.stringify({ playlistId, trackId, added: true }, null, 2));
-        return;
-    }
-    console.log(`\nTrack ${trackId} added to playlist ${playlistId}.`);
+    return { playlistId, trackId, added: true };
 }
-async function removeTrackFromPlaylist(playlistId, trackId, json) {
+async function addTrackToPlaylist(playlistId, trackId, json) {
     const client = await (0, auth_1.getApiClient)();
-    // Get playlist items to find the item index (required by the API)
+    try {
+        const result = await addTrackToPlaylistData(playlistId, trackId, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nTrack ${trackId} added to playlist ${playlistId}.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function removeTrackFromPlaylistData(playlistId, trackId, client) {
     const { data: itemsData, error: itemsError } = await client.GET('/playlists/{id}/relationships/items', {
         params: { path: { id: playlistId } },
     });
     if (itemsError || !itemsData) {
-        console.error(`Error: Failed to get playlist items — ${JSON.stringify(itemsError)}`);
-        process.exit(1);
+        throw new Error(`Failed to get playlist items — ${JSON.stringify(itemsError)}`);
     }
     const items = itemsData.data ?? [];
     const item = items.find((i) => i.id === trackId);
     if (!item) {
-        console.error(`Error: Track ${trackId} not found in playlist ${playlistId}.`);
-        process.exit(1);
+        throw new Error(`Track ${trackId} not found in playlist ${playlistId}.`);
     }
     const { error } = await client.DELETE('/playlists/{id}/relationships/items', {
         params: { path: { id: playlistId } },
@@ -156,71 +205,82 @@ async function removeTrackFromPlaylist(playlistId, trackId, json) {
         },
     });
     if (error) {
-        console.error(`Error: Failed to remove track — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to remove track — ${JSON.stringify(error)}`);
     }
-    if (json) {
-        console.log(JSON.stringify({ playlistId, trackId, removed: true }, null, 2));
-        return;
-    }
-    console.log(`\nTrack ${trackId} removed from playlist ${playlistId}.`);
+    return { playlistId, trackId, removed: true };
 }
-async function addAlbumToPlaylist(playlistId, albumId, json) {
+async function removeTrackFromPlaylist(playlistId, trackId, json) {
     const client = await (0, auth_1.getApiClient)();
-    // First get album tracks
+    try {
+        const result = await removeTrackFromPlaylistData(playlistId, trackId, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nTrack ${trackId} removed from playlist ${playlistId}.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function addAlbumToPlaylistData(playlistId, albumId, client, countryCode) {
     const { data: albumData, error: albumError } = await client.GET('/albums/{id}', {
         params: {
             path: { id: albumId },
-            query: { countryCode: await (0, auth_1.getCountryCode)(), include: ['items'] },
+            query: { countryCode, include: ['items'] },
         },
     });
     if (albumError || !albumData) {
-        console.error(`Error: Failed to get album — ${JSON.stringify(albumError)}`);
-        process.exit(1);
+        throw new Error(`Failed to get album — ${JSON.stringify(albumError)}`);
     }
-    // Extract track IDs from included items
     const included = albumData.included ?? [];
     const trackIds = included
         .filter((item) => item.type === 'tracks')
         .map((item) => ({ id: item.id, type: 'tracks' }));
     if (trackIds.length === 0) {
-        console.error('Error: No tracks found in album.');
-        process.exit(1);
+        throw new Error('No tracks found in album.');
     }
     const { error } = await client.POST('/playlists/{id}/relationships/items', {
         params: { path: { id: playlistId } },
         body: { data: trackIds },
     });
     if (error) {
-        console.error(`Error: Failed to add album tracks — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to add album tracks — ${JSON.stringify(error)}`);
     }
-    if (json) {
-        console.log(JSON.stringify({ playlistId, albumId, tracksAdded: trackIds.length }, null, 2));
-        return;
-    }
-    console.log(`\n${trackIds.length} tracks from album ${albumId} added to playlist ${playlistId}.`);
+    return { playlistId, albumId, tracksAdded: trackIds.length };
 }
-async function moveTrackInPlaylist(playlistId, trackId, positionBefore, json) {
+async function addAlbumToPlaylist(playlistId, albumId, json) {
     const client = await (0, auth_1.getApiClient)();
-    // Get playlist items to find the itemId for the track
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const result = await addAlbumToPlaylistData(playlistId, albumId, client, countryCode);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\n${result.tracksAdded} tracks from album ${albumId} added to playlist ${playlistId}.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function moveTrackInPlaylistData(playlistId, trackId, positionBefore, client) {
     const { data: itemsData, error: itemsError } = await client.GET('/playlists/{id}/relationships/items', {
         params: { path: { id: playlistId } },
     });
     if (itemsError || !itemsData) {
-        console.error(`Error: Failed to get playlist items — ${JSON.stringify(itemsError)}`);
-        process.exit(1);
+        throw new Error(`Failed to get playlist items — ${JSON.stringify(itemsError)}`);
     }
     const items = itemsData.data ?? [];
     const item = items.find((i) => i.id === trackId);
     if (!item) {
-        console.error(`Error: Track ${trackId} not found in playlist ${playlistId}.`);
-        process.exit(1);
+        throw new Error(`Track ${trackId} not found in playlist ${playlistId}.`);
     }
     const itemId = item.meta?.itemId;
     if (!itemId) {
-        console.error(`Error: Could not find itemId for track ${trackId}.`);
-        process.exit(1);
+        throw new Error(`Could not find itemId for track ${trackId}.`);
     }
     const meta = {};
     if (positionBefore !== 'end') {
@@ -234,18 +294,27 @@ async function moveTrackInPlaylist(playlistId, trackId, positionBefore, json) {
         },
     });
     if (error) {
-        console.error(`Error: Failed to move track — ${JSON.stringify(error)}`);
-        process.exit(1);
-    }
-    if (json) {
-        console.log(JSON.stringify({ playlistId, trackId, positionBefore, moved: true }, null, 2));
-        return;
+        throw new Error(`Failed to move track — ${JSON.stringify(error)}`);
     }
-    const posDesc = positionBefore === 'end' ? 'to end of playlist' : `before item ${positionBefore}`;
-    console.log(`\nTrack ${trackId} moved ${posDesc} in playlist ${playlistId}.`);
+    return { playlistId, trackId, positionBefore, moved: true };
 }
-async function updatePlaylistDescription(playlistId, description, json) {
+async function moveTrackInPlaylist(playlistId, trackId, positionBefore, json) {
     const client = await (0, auth_1.getApiClient)();
+    try {
+        const result = await moveTrackInPlaylistData(playlistId, trackId, positionBefore, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const posDesc = positionBefore === 'end' ? 'to end of playlist' : `before item ${positionBefore}`;
+        console.log(`\nTrack ${trackId} moved ${posDesc} in playlist ${playlistId}.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function updatePlaylistDescriptionData(playlistId, description, client) {
     const { error } = await client.PATCH('/playlists/{id}', {
         params: { path: { id: playlistId } },
         body: {
@@ -257,13 +326,23 @@ async function updatePlaylistDescription(playlistId, description, json) {
         },
     });
     if (error) {
-        console.error(`Error: Failed to update playlist description — ${JSON.stringify(error)}`);
-        process.exit(1);
+        throw new Error(`Failed to update playlist description — ${JSON.stringify(error)}`);
     }
-    if (json) {
-        console.log(JSON.stringify({ id: playlistId, description, success: true }, null, 2));
-        return;
+    return { id: playlistId, description, success: true };
+}
+async function updatePlaylistDescription(playlistId, description, json) {
+    const client = await (0, auth_1.getApiClient)();
+    try {
+        const result = await updatePlaylistDescriptionData(playlistId, description, client);
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nPlaylist ${playlistId} description updated.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log(`\nPlaylist ${playlistId} description updated.`);
 }
 //# sourceMappingURL=playlist.js.map

package/dist/recommend.d.ts

@@ -1 +1,4 @@
-export declare function getRecommendations(json: boolean): Promise<void>;
+import type { MixCategory, RecommendationItem } from './types';
+export type { MixCategory, RecommendationItem };
+export declare function getRecommendationsData(client: any, countryCode: string, category?: MixCategory): Promise<RecommendationItem[]>;
+export declare function getRecommendations(category: MixCategory | undefined, json: boolean): Promise<void>;

package/dist/recommend.js

@@ -1,36 +1,88 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecommendationsData = getRecommendationsData;
 exports.getRecommendations = getRecommendations;
 const auth_1 = require("./auth");
-async function getRecommendations(json) {
-    const client = await (0, auth_1.getApiClient)();
-    const { data, error } = await client.GET('/userRecommendations/me', {
+const categoryEndpoints = {
+    daily: '/userDailyMixes/{id}',
+    discovery: '/userDiscoveryMixes/{id}',
+    'new-release': '/userNewReleaseMixes/{id}',
+    offline: '/userOfflineMixes/{id}',
+};
+async function getCategoryItems(category, client, countryCode) {
+    const { data, error } = await client.GET(categoryEndpoints[category], {
         params: {
+            path: { id: 'me' },
             query: {
-                countryCode: await (0, auth_1.getCountryCode)(),
-                include: ['discoveryMixes', 'myMixes', 'newArrivalMixes'],
+                countryCode,
+                include: ['items'],
             },
         },
     });
     if (error || !data) {
-        console.error(`Error: Failed to get recommendations — ${JSON.stringify(error)}`);
-        process.exit(1);
+        // Some categories (e.g. offline) may 404 for users without entitlement — treat as empty.
+        return [];
     }
     const included = data.included ?? [];
-    if (json) {
-        console.log(JSON.stringify(included, null, 2));
-        return;
+    return included.map((item) => {
+        const attrs = item.attributes ?? {};
+        return {
+            id: item.id,
+            type: item.type,
+            name: attrs.title ?? attrs.name ?? 'Untitled',
+            category,
+        };
+    });
+}
+async function getRecommendationsData(client, countryCode, category) {
+    if (category) {
+        return getCategoryItems(category, client, countryCode);
     }
-    if (included.length === 0) {
-        console.log('No recommendations found.');
-        return;
+    const categories = ['daily', 'discovery', 'new-release', 'offline'];
+    const results = await Promise.all(categories.map((c) => getCategoryItems(c, client, countryCode)));
+    return results.flat();
+}
+async function getRecommendations(category, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const countryCode = await (0, auth_1.getCountryCode)();
+    try {
+        const items = await getRecommendationsData(client, countryCode, category);
+        if (json) {
+            console.log(JSON.stringify(items, null, 2));
+            return;
+        }
+        if (items.length === 0) {
+            console.log('No recommendations found.');
+            return;
+        }
+        if (category) {
+            console.log(`\nYour ${category} mixes:\n`);
+            for (const item of items) {
+                console.log(`  [${item.id}] (${item.type}) ${item.name}`);
+            }
+        }
+        else {
+            console.log('\nYour recommendations:\n');
+            const grouped = items.reduce((acc, item) => {
+                const key = item.category ?? 'other';
+                (acc[key] ??= []).push(item);
+                return acc;
+            }, {});
+            for (const cat of ['daily', 'discovery', 'new-release', 'offline']) {
+                const list = grouped[cat];
+                if (!list?.length)
+                    continue;
+                console.log(`  ${cat}:`);
+                for (const item of list) {
+                    console.log(`    [${item.id}] (${item.type}) ${item.name}`);
+                }
+            }
+        }
+        console.log();
     }
-    console.log('\nYour recommendations:\n');
-    for (const item of included) {
-        const attrs = item.attributes;
-        const name = attrs?.title ?? attrs?.name ?? 'Untitled';
-        console.log(`  [${item.id}] (${item.type}) ${name}`);
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
     }
-    console.log();
 }
 //# sourceMappingURL=recommend.js.map

package/dist/saved.d.ts

@@ -0,0 +1,16 @@
+import type { SavedItem, SavedItemType } from './types';
+export type { SavedItem, SavedItemType };
+export declare function listSavedItemsData(client: any): Promise<SavedItem[]>;
+export declare function listSavedItems(json: boolean): Promise<void>;
+export declare function addSavedItemData(itemType: SavedItemType, itemId: string, client: any): Promise<{
+    id: string;
+    type: SavedItemType;
+    added: boolean;
+}>;
+export declare function addSavedItem(itemType: SavedItemType, itemId: string, json: boolean): Promise<void>;
+export declare function removeSavedItemData(itemType: SavedItemType, itemId: string, client: any): Promise<{
+    id: string;
+    type: SavedItemType;
+    removed: boolean;
+}>;
+export declare function removeSavedItem(itemType: SavedItemType, itemId: string, json: boolean): Promise<void>;