@lucaperret/tidal-cli 1.1.0

package/dist/track.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTrackInfo = getTrackInfo;
+exports.getTrackRadio = getTrackRadio;
+exports.getTrackByIsrc = getTrackByIsrc;
+exports.getSimilarTracks = getSimilarTracks;
+const auth_1 = require("./auth");
+function formatDuration(isoDuration) {
+    if (!isoDuration)
+        return '';
+    const match = isoDuration.match(/PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?/);
+    if (!match)
+        return isoDuration;
+    const h = match[1] ? `${match[1]}:` : '';
+    const m = (match[2] ?? '0').padStart(h ? 2 : 1, '0');
+    const s = (match[3] ?? '0').padStart(2, '0');
+    return `${h}${m}:${s}`;
+}
+async function getTrackInfo(trackId, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const { data, error } = await client.GET('/tracks/{id}', {
+        params: {
+            path: { id: trackId },
+            query: {
+                countryCode: await (0, auth_1.getCountryCode)(),
+                include: ['artists', 'albums'],
+            },
+        },
+    });
+    if (error || !data) {
+        console.error(`Error: Failed to get track info — ${JSON.stringify(error)}`);
+        process.exit(1);
+    }
+    const attrs = data.data?.attributes ?? {};
+    const included = data.included ?? [];
+    const artists = included
+        .filter((item) => item.type === 'artists')
+        .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'] },
+                },
+            });
+            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 = {
+        id: trackId,
+        title: attrs.title ?? 'Unknown',
+        artists,
+        album: albumName,
+        duration: formatDuration(attrs.duration),
+        isrc: attrs.isrc,
+        bpm: attrs.bpm,
+        key: attrs.key,
+        popularity: attrs.popularity,
+        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) {
+    const client = await (0, auth_1.getApiClient)();
+    const { data, error } = await client.GET('/tracks/{id}/relationships/radio', {
+        params: {
+            path: { id: trackId },
+            query: {
+                countryCode: await (0, auth_1.getCountryCode)(),
+                include: ['radio'],
+            },
+        },
+    });
+    if (error || !data) {
+        console.error(`Error: Failed to get track radio — ${JSON.stringify(error)}`);
+        process.exit(1);
+    }
+    // Radio returns playlists (mix playlists), not individual tracks
+    const radioData = data.data ?? [];
+    const included = data.included ?? [];
+    const playlists = radioData.map((item) => {
+        const incl = included.find((i) => i.id === item.id && i.type === 'playlists');
+        const attrs = incl?.attributes ?? {};
+        return {
+            id: item.id,
+            type: item.type,
+            name: attrs.name,
+            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;
+    }
+    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();
+}
+async function getTrackByIsrc(isrc, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const { data, error } = await client.GET('/tracks', {
+        params: {
+            query: {
+                countryCode: await (0, auth_1.getCountryCode)(),
+                'filter[isrc]': [isrc],
+                include: ['artists'],
+            },
+        },
+    });
+    if (error || !data) {
+        console.error(`Error: Failed to get track by ISRC — ${JSON.stringify(error)}`);
+        process.exit(1);
+    }
+    const items = data.data ?? [];
+    const included = data.included ?? [];
+    const tracks = items.map((item) => {
+        const attrs = item.attributes;
+        const artistRels = item.relationships?.artists?.data ?? [];
+        const artistNames = artistRels.map((rel) => {
+            const artist = included.find((inc) => inc.type === 'artists' && inc.id === rel.id);
+            return artist?.attributes?.name ?? rel.id;
+        });
+        return {
+            id: item.id,
+            title: attrs?.title ?? 'Unknown',
+            artists: artistNames,
+            duration: formatDuration(attrs?.duration),
+            isrc: attrs?.isrc,
+            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;
+    }
+    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();
+}
+async function getSimilarTracks(trackId, json) {
+    const client = await (0, auth_1.getApiClient)();
+    const { data, error } = await client.GET('/tracks/{id}/relationships/similarTracks', {
+        params: {
+            path: { id: trackId },
+            query: {
+                countryCode: await (0, auth_1.getCountryCode)(),
+                include: ['similarTracks'],
+            },
+        },
+    });
+    if (error || !data) {
+        console.error(`Error: Failed to get similar tracks — ${JSON.stringify(error)}`);
+        process.exit(1);
+    }
+    const included = data.included ?? [];
+    const tracks = included
+        .filter((item) => item.type === 'tracks')
+        .map((item) => {
+        const attrs = item.attributes;
+        return {
+            id: item.id,
+            title: attrs?.title ?? 'Unknown',
+            duration: formatDuration(attrs?.duration),
+            isrc: attrs?.isrc,
+            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;
+    }
+    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();
+}
+//# sourceMappingURL=track.js.map

package/dist/user.d.ts

@@ -0,0 +1 @@
+export declare function getUserProfile(json: boolean): Promise<void>;

package/dist/user.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserProfile = getUserProfile;
+const auth_1 = require("./auth");
+async function getUserProfile(json) {
+    const client = await (0, auth_1.getApiClient)();
+    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);
+    }
+    const attrs = data.data?.attributes ?? {};
+    const result = {
+        id: data.data?.id,
+        username: attrs.username,
+        country: attrs.country,
+        email: attrs.email,
+    };
+    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();
+}
+//# sourceMappingURL=user.js.map

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@lucaperret/tidal-cli",
+  "version": "1.1.0",
+  "description": "CLI for Tidal music streaming service, designed for LLM agent automation",
+  "main": "dist/index.js",
+  "bin": {
+    "tidal-cli": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "tidal",
+    "music",
+    "cli",
+    "streaming",
+    "llm",
+    "agent",
+    "automation",
+    "openclaw",
+    "playlist",
+    "hifi"
+  ],
+  "author": "Luca Perret",
+  "license": "MIT",
+  "homepage": "https://github.com/lucaperret/tidal-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lucaperret/tidal-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lucaperret/tidal-cli/issues"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "!dist/__tests__",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@tidal-music/api": "^0.9.1",
+    "@tidal-music/auth": "^1.4.0",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}