gerdur 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2.6.0 - 2026-08-31
+
+### Added
+
+- **`gerdur-core@^2.6.0`** — re-exports the Flow / radios / library surface:
+  `getUserFlow`, `getUserFavoriteTracks` / `Albums` / `Artists`,
+  `getUserPlaylists`, `getUserRadios`, `getUserChartTracks`, `getRadios`,
+  `getRadioTracks`, `getRadioGenres` + their types.
+- **`Session` methods**: `flow`, `favoriteTracks`, `favoriteAlbums`,
+  `favoriteArtists`, `playlists`, `userRadios`, `radios`, `radioTracks` — the
+  `userId` argument defaults to the logged-in user.
+- **CLI `flow` / `flow:<userId>` / `radio:<id>`** — pick tracks from your (or
+  another user's) Flow, or a radio's current playlist, and download them.
+  Headless-friendly.
+
 ## 2.5.0 - 2026-08-31
 
 ### Changed

package/README.md

@@ -159,8 +159,11 @@ When `gerdur` asks for a URL, a search term, or a prefixed query:
 | `search:artist:"daft punk" bpm_min:120` | advanced track search (see operators below) |
 | `isrc:GBDUW0000059` | download the exact track for an ISRC |
 | `upc:0724384960650` | download the album for a UPC / EAN barcode |
+| `flow` | pick tracks from your Deezer **Flow** |
+| `flow:2064440442` | pick tracks from another user's Flow |
+| `radio:38305` | pick tracks from a radio's current playlist |
 
-`isrc:` and `upc:` also work in `--headless` mode (`-u isrc:…` / `-u upc:…`).
+`isrc:` / `upc:` / `flow` / `radio:` also work in `--headless` mode (`-u flow`, …).
 
 ### From flags (works headless)
 
@@ -258,6 +261,9 @@ Session methods:
 - **browse** — `genres`, `chart`, `chartTracks`, `editorialSections`,
   `artistTopTracks`, `relatedArtists`, `artistAlbums`, `artistRadio`,
   `trackByISRC`, `albumByUPC`
+- **flow / library** — `flow`, `favoriteTracks`, `favoriteAlbums`,
+  `favoriteArtists`, `playlists`, `userRadios`, `radios`, `radioTracks`
+  (the `userId` arg defaults to the logged-in user)
 - **user / download** — `getUser`, `getTrackBuffer`, `streamTrack`,
   `downloadTrack`, `downloadTracks`, `downloadUrl`, `trackPreview`, `downloadPreview`
 
@@ -319,6 +325,10 @@ or `createSession`):
   `getEditorialCharts`, `getArtistTopTracks`, `getRelatedArtists`,
   `getArtistAlbums`, `getArtistPlaylists`, `getArtistRadioTracks`,
   `getTrackByISRC`, `getAlbumByUPC`
+- **Flow / library** — `getUserFlow`, `getUserFavoriteTracks`,
+  `getUserFavoriteAlbums`, `getUserFavoriteArtists`, `getUserPlaylists`,
+  `getUserRadios`, `getUserChartTracks`, `getRadios`, `getRadioTracks`,
+  `getRadioGenres`
 - **Download** — `getTrackDownloadUrl`, `resolveDownloadUrls`,
   `streamTrackDownload`, `createDecryptStream`, `getStream`, `getTrackPreview`,
   `downloadPreview`, `formatName`, `toFormat`, `DEEZER_FORMATS`

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gerdur",
-    "version": "2.5.0",
+    "version": "2.6.0",
     "description": "The crucial streaming module for dabox systems.",
     "author": "Christian",
     "license": "SEE LICENSE IN LICENSE",
@@ -48,7 +48,7 @@
         "adm-zip": "^0.5.16",
         "chalk": "^4.1.2",
         "commander": "^9.5.0",
-        "gerdur-core": "^2.5.0",
+        "gerdur-core": "^2.6.0",
         "dot-prop": "^6.0.1",
         "got": "^11.8.6",
         "gradient-string": "^2.0.2",

package/dist/src/gerdur.js

@@ -111,18 +111,14 @@ const stampVersion = (t) => {
  * picks into download-ready gw tracks via `getTrackInfo`. Returns `null` when
  * nothing was matched or selected.
  */
-const resolveAdvancedSearch = async (filters) => {
-    const limit = toFiniteNumber(options.searchLimit) ?? 50;
-    const { data: results, query, usedFallback } = await (0, search_1.searchAdvancedTracks)(filters, { limit });
-    if (!query) {
-        return null;
-    }
-    console.log(signale_1.default.info(`Searching Deezer for: ${chalk_1.default.cyan(query)}`));
-    if (usedFallback) {
-        console.log(signale_1.default.note('No matches for the operators — retried as a plain-text search.'));
-    }
+/**
+ * Given a list of public-API track objects (from search / flow / a radio), let
+ * the user pick (unless headless) and hydrate the picks into download-ready gw
+ * tracks via `getTrackInfo`.
+ */
+const pickAndHydrate = async (results, id) => {
     if (!results.length) {
-        console.log(signale_1.default.warn('No tracks matched that search.'));
+        console.log(signale_1.default.warn('Nothing to download.'));
         return null;
     }
     let picks = results;
@@ -131,7 +127,7 @@ const resolveAdvancedSearch = async (filters) => {
             {
                 type: 'multiselect',
                 name: 'items',
-                message: `Select tracks to download. ${results.length} matched.`,
+                message: `Select tracks to download. ${results.length} available.`,
                 choices: results.map((r) => ({
                     title: `${r.title} — ${r.artist?.name ?? 'Unknown'}`,
                     value: r,
@@ -151,7 +147,19 @@ const resolveAdvancedSearch = async (filters) => {
         console.log(signale_1.default.warn('None of the selected tracks could be resolved.'));
         return null;
     }
-    return { info: { type: 'track', id: query }, linktype: 'track', linkinfo: {}, tracks };
+    return { info: { type: 'track', id }, linktype: 'track', linkinfo: {}, tracks };
+};
+const resolveAdvancedSearch = async (filters) => {
+    const limit = toFiniteNumber(options.searchLimit) ?? 50;
+    const { data: results, query, usedFallback } = await (0, search_1.searchAdvancedTracks)(filters, { limit });
+    if (!query) {
+        return null;
+    }
+    console.log(signale_1.default.info(`Searching Deezer for: ${chalk_1.default.cyan(query)}`));
+    if (usedFallback) {
+        console.log(signale_1.default.note('No matches for the operators — retried as a plain-text search.'));
+    }
+    return pickAndHydrate(results, query);
 };
 /**
  * `--preview`: fetch the 30-second clip for each selected track and write it as
@@ -228,7 +236,7 @@ const startDownload = async (saveLayout, url, skipPrompt) => {
                 {
                     type: 'text',
                     name: 'query',
-                    message: 'Enter a URL, a search term, or a `search:` / `isrc:` / `upc:` query:',
+                    message: 'Enter a URL, a search term, or `search:` / `isrc:` / `upc:` / `flow` / `radio:<id>`:',
                     validate: (value) => (value ? true : false),
                 },
             ], { onCancel });
@@ -260,6 +268,26 @@ const startDownload = async (saveLayout, url, skipPrompt) => {
             console.log(signale_1.default.info(`UPC ${code} → ${found.title} (${found.nb_tracks} tracks)`));
             url = `https://www.deezer.com/album/${found.id}`;
         }
+        // `flow:` / `flow:<userId>` — download from Deezer Flow.
+        if (!searchData && url && (url === 'flow' || url.startsWith('flow:'))) {
+            const uid = url.includes(':') ? url.slice('flow:'.length).trim() : (await (0, gerdur_core_1.getUser)()).USER_ID;
+            console.log(signale_1.default.info(`Fetching Flow for user ${uid}…`));
+            const { data } = await (0, gerdur_core_1.getUserFlow)(uid);
+            searchData = await pickAndHydrate(data, `flow:${uid}`);
+            if (!searchData) {
+                throw new Error('Flow returned no tracks (is the profile public?).');
+            }
+        }
+        // `radio:<id>` — download a radio's current tracklist.
+        if (!searchData && url && url.startsWith('radio:')) {
+            const rid = url.slice('radio:'.length).trim();
+            console.log(signale_1.default.info(`Fetching radio ${rid}…`));
+            const { data } = await (0, gerdur_core_1.getRadioTracks)(rid);
+            searchData = await pickAndHydrate(data, `radio:${rid}`);
+            if (!searchData) {
+                throw new Error(`Radio ${rid} returned no tracks.`);
+            }
+        }
         if (!searchData && !url.match(urlRegex)) {
             if (options.headless) {
                 throw new Error('Please provide a valid URL. Unknown URL: ' + url);

package/dist/src/index.d.ts

@@ -59,7 +59,7 @@ export type { SessionOptions, DownloadTracksOptions, SearchType } from './lib/se
 export { getTrackBuffer, getTaggedTrack, downloadTrackToFile } from './lib/api-download';
 export type { Quality, GetTrackBufferOptions, DownloadTrackOptions, DownloadResult } from './lib/api-download';
 export { default as Config, globalConfigPath, resolveConfigFile } from './lib/config';
-export { initDeezerApi, parseInfo, searchMusic, searchPublicApi, searchTracks, searchAlbums, searchArtists, searchPlaylists, buildAdvancedQuery, suggest, getGenres, getChart, getChartTracks, getGenreArtists, getEditorialList, getEditorialReleases, getEditorialSelection, getEditorialCharts, getArtistTopTracks, getRelatedArtists, getArtistAlbums, getArtistPlaylists, getArtistRadioTracks, getTrackByISRC, getAlbumByUPC, getTrackPreview, downloadPreview, formatName, toFormat, DEEZER_FORMATS, getUser, getTrackInfo, getAlbumInfo, getAlbumTracks, getPlaylistInfo, getPlaylistTracks, getArtistInfo, getDiscography, getLyrics, getTrackDownloadUrl, resolveDownloadUrls, streamTrackDownload, createDecryptStream, getStream, addTrackTags, getRichAlbum, normalizeContributors, toLrc, GeoBlocked, DeezerError, } from 'gerdur-core';
+export { initDeezerApi, parseInfo, searchMusic, searchPublicApi, searchTracks, searchAlbums, searchArtists, searchPlaylists, buildAdvancedQuery, suggest, getGenres, getChart, getChartTracks, getGenreArtists, getEditorialList, getEditorialReleases, getEditorialSelection, getEditorialCharts, getArtistTopTracks, getRelatedArtists, getArtistAlbums, getArtistPlaylists, getArtistRadioTracks, getUserFlow, getUserFavoriteTracks, getUserFavoriteAlbums, getUserFavoriteArtists, getUserPlaylists, getUserRadios, getUserChartTracks, getRadios, getRadioTracks, getRadioGenres, getTrackByISRC, getAlbumByUPC, getTrackPreview, downloadPreview, formatName, toFormat, DEEZER_FORMATS, getUser, getTrackInfo, getAlbumInfo, getAlbumTracks, getPlaylistInfo, getPlaylistTracks, getArtistInfo, getDiscography, getLyrics, getTrackDownloadUrl, resolveDownloadUrls, streamTrackDownload, createDecryptStream, getStream, addTrackTags, getRichAlbum, normalizeContributors, toLrc, GeoBlocked, DeezerError, } from 'gerdur-core';
 export type { AddTrackTagsOptions, TaggedTrack, TrackTagModel, RichAlbum, ResolvedUrl, NormalizedContributors, } from 'gerdur-core';
-export type { advancedSearchFilters, searchOrder, searchEntity, publicApiSearchOptions, publicApiSearchResponse, searchResultTrack, searchResultAlbum, searchResultArtist, searchResultPlaylist, suggestResult, publicApiList, chartType, chartTrack, chartAlbum, chartArtist, chartPlaylist, chartPodcast, genreType, editorialType, artistAlbumResult, } from 'gerdur-core/types';
+export type { advancedSearchFilters, searchOrder, searchEntity, publicApiSearchOptions, publicApiSearchResponse, searchResultTrack, searchResultAlbum, searchResultArtist, searchResultPlaylist, suggestResult, publicApiList, chartType, chartTrack, chartAlbum, chartArtist, chartPlaylist, chartPodcast, genreType, editorialType, artistAlbumResult, userFavoriteTrack, userFavoriteAlbum, userFavoriteArtist, userPlaylistResult, radioResult, radioGenre, } from 'gerdur-core/types';
 export type { Quality as MediaFormat, DeezerFormat, TrackPreview, StreamTrackOptions, TrackStream, StreamResponse, DeezerErrorPayload, } from 'gerdur-core';

package/dist/src/index.js

@@ -33,8 +33,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLyrics = exports.getDiscography = exports.getArtistInfo = exports.getPlaylistTracks = exports.getPlaylistInfo = exports.getAlbumTracks = exports.getAlbumInfo = exports.getTrackInfo = exports.getUser = exports.DEEZER_FORMATS = exports.toFormat = exports.formatName = exports.downloadPreview = exports.getTrackPreview = exports.getAlbumByUPC = exports.getTrackByISRC = exports.getArtistRadioTracks = exports.getArtistPlaylists = exports.getArtistAlbums = exports.getRelatedArtists = exports.getArtistTopTracks = exports.getEditorialCharts = exports.getEditorialSelection = exports.getEditorialReleases = exports.getEditorialList = exports.getGenreArtists = exports.getChartTracks = exports.getChart = exports.getGenres = exports.suggest = exports.buildAdvancedQuery = exports.searchPlaylists = exports.searchArtists = exports.searchAlbums = exports.searchTracks = exports.searchPublicApi = exports.searchMusic = exports.parseInfo = exports.initDeezerApi = exports.resolveConfigFile = exports.globalConfigPath = exports.Config = exports.downloadTrackToFile = exports.getTaggedTrack = exports.getTrackBuffer = exports.Session = exports.createSession = exports.getArl = exports.LoginError = exports.loginWithEmail = void 0;
-exports.DeezerError = exports.GeoBlocked = exports.toLrc = exports.normalizeContributors = exports.getRichAlbum = exports.addTrackTags = exports.getStream = exports.createDecryptStream = exports.streamTrackDownload = exports.resolveDownloadUrls = exports.getTrackDownloadUrl = void 0;
+exports.toFormat = exports.formatName = exports.downloadPreview = exports.getTrackPreview = exports.getAlbumByUPC = exports.getTrackByISRC = exports.getRadioGenres = exports.getRadioTracks = exports.getRadios = exports.getUserChartTracks = exports.getUserRadios = exports.getUserPlaylists = exports.getUserFavoriteArtists = exports.getUserFavoriteAlbums = exports.getUserFavoriteTracks = exports.getUserFlow = exports.getArtistRadioTracks = exports.getArtistPlaylists = exports.getArtistAlbums = exports.getRelatedArtists = exports.getArtistTopTracks = exports.getEditorialCharts = exports.getEditorialSelection = exports.getEditorialReleases = exports.getEditorialList = exports.getGenreArtists = exports.getChartTracks = exports.getChart = exports.getGenres = exports.suggest = exports.buildAdvancedQuery = exports.searchPlaylists = exports.searchArtists = exports.searchAlbums = exports.searchTracks = exports.searchPublicApi = exports.searchMusic = exports.parseInfo = exports.initDeezerApi = exports.resolveConfigFile = exports.globalConfigPath = exports.Config = exports.downloadTrackToFile = exports.getTaggedTrack = exports.getTrackBuffer = exports.Session = exports.createSession = exports.getArl = exports.LoginError = exports.loginWithEmail = void 0;
+exports.DeezerError = exports.GeoBlocked = exports.toLrc = exports.normalizeContributors = exports.getRichAlbum = exports.addTrackTags = exports.getStream = exports.createDecryptStream = exports.streamTrackDownload = exports.resolveDownloadUrls = exports.getTrackDownloadUrl = exports.getLyrics = exports.getDiscography = exports.getArtistInfo = exports.getPlaylistTracks = exports.getPlaylistInfo = exports.getAlbumTracks = exports.getAlbumInfo = exports.getTrackInfo = exports.getUser = exports.DEEZER_FORMATS = void 0;
 // ─── Authentication ────────────────────────────────────────────────────────
 const email_login_1 = require("./lib/email-login");
 Object.defineProperty(exports, "loginWithEmail", { enumerable: true, get: function () { return email_login_1.loginWithEmail; } });
@@ -110,6 +110,16 @@ Object.defineProperty(exports, "getRelatedArtists", { enumerable: true, get: fun
 Object.defineProperty(exports, "getArtistAlbums", { enumerable: true, get: function () { return gerdur_core_1.getArtistAlbums; } });
 Object.defineProperty(exports, "getArtistPlaylists", { enumerable: true, get: function () { return gerdur_core_1.getArtistPlaylists; } });
 Object.defineProperty(exports, "getArtistRadioTracks", { enumerable: true, get: function () { return gerdur_core_1.getArtistRadioTracks; } });
+Object.defineProperty(exports, "getUserFlow", { enumerable: true, get: function () { return gerdur_core_1.getUserFlow; } });
+Object.defineProperty(exports, "getUserFavoriteTracks", { enumerable: true, get: function () { return gerdur_core_1.getUserFavoriteTracks; } });
+Object.defineProperty(exports, "getUserFavoriteAlbums", { enumerable: true, get: function () { return gerdur_core_1.getUserFavoriteAlbums; } });
+Object.defineProperty(exports, "getUserFavoriteArtists", { enumerable: true, get: function () { return gerdur_core_1.getUserFavoriteArtists; } });
+Object.defineProperty(exports, "getUserPlaylists", { enumerable: true, get: function () { return gerdur_core_1.getUserPlaylists; } });
+Object.defineProperty(exports, "getUserRadios", { enumerable: true, get: function () { return gerdur_core_1.getUserRadios; } });
+Object.defineProperty(exports, "getUserChartTracks", { enumerable: true, get: function () { return gerdur_core_1.getUserChartTracks; } });
+Object.defineProperty(exports, "getRadios", { enumerable: true, get: function () { return gerdur_core_1.getRadios; } });
+Object.defineProperty(exports, "getRadioTracks", { enumerable: true, get: function () { return gerdur_core_1.getRadioTracks; } });
+Object.defineProperty(exports, "getRadioGenres", { enumerable: true, get: function () { return gerdur_core_1.getRadioGenres; } });
 Object.defineProperty(exports, "getTrackByISRC", { enumerable: true, get: function () { return gerdur_core_1.getTrackByISRC; } });
 Object.defineProperty(exports, "getAlbumByUPC", { enumerable: true, get: function () { return gerdur_core_1.getAlbumByUPC; } });
 Object.defineProperty(exports, "getTrackPreview", { enumerable: true, get: function () { return gerdur_core_1.getTrackPreview; } });

package/dist/src/lib/session.d.ts

@@ -2,7 +2,7 @@
 import { parseInfo, searchMusic } from 'gerdur-core';
 import type { AdvancedSearchOptions } from './search';
 import type { Quality, DownloadTrackOptions, DownloadResult } from './api-download';
-import type { trackType, userType, advancedSearchFilters, publicApiSearchResponse, searchResultTrack, suggestResult, chartType, genreType, editorialType, artistAlbumResult, searchResultArtist, publicApiList, trackTypePublicApi, albumTypePublicApi } from 'gerdur-core/types';
+import type { trackType, userType, advancedSearchFilters, publicApiSearchResponse, searchResultTrack, suggestResult, chartType, genreType, editorialType, artistAlbumResult, searchResultArtist, publicApiList, trackTypePublicApi, albumTypePublicApi, userFavoriteTrack, userFavoriteAlbum, userFavoriteArtist, userPlaylistResult, radioResult } from 'gerdur-core/types';
 import type { TrackPreview, StreamTrackOptions, TrackStream } from 'gerdur-core';
 /** Search result categories accepted by {@link Session.search}. */
 export type SearchType = 'ALBUM' | 'ARTIST' | 'TRACK' | 'PLAYLIST' | 'RADIO' | 'SHOW' | 'USER' | 'LIVESTREAM' | 'CHANNEL';
@@ -39,7 +39,10 @@ export declare class Session {
     /** The arl in use for this session. */
     readonly arl: string;
     private concurrency;
+    private userId?;
     private constructor();
+    /** The logged-in user's numeric id (cached). Used by the no-arg `flow` / `favorite*` methods. */
+    private resolveUserId;
     /**
      * Log in and return a ready-to-use session. Accepts either an `arl` or
      * `email`+`password` (which are exchanged for an arl via Deezer's OAuth flow).
@@ -86,6 +89,22 @@ export declare class Session {
     trackByISRC(isrc: string): Promise<trackTypePublicApi>;
     /** Resolve a UPC/EAN barcode to the public-API album (with its `tracks`). */
     albumByUPC(upc: string): Promise<albumTypePublicApi>;
+    /** Deezer **Flow** — the endless personalised mix, as tracks. */
+    flow(userId?: string | number, limit?: number): Promise<publicApiList<searchResultTrack>>;
+    /** A user's favourite (loved) tracks, newest first (each with `time_add`). */
+    favoriteTracks(userId?: string | number, limit?: number): Promise<publicApiList<userFavoriteTrack>>;
+    /** A user's favourite albums. */
+    favoriteAlbums(userId?: string | number, limit?: number): Promise<publicApiList<userFavoriteAlbum>>;
+    /** A user's favourite artists. */
+    favoriteArtists(userId?: string | number, limit?: number): Promise<publicApiList<userFavoriteArtist>>;
+    /** A user's own + followed playlists. */
+    playlists(userId?: string | number, limit?: number): Promise<publicApiList<userPlaylistResult>>;
+    /** The radios a user has favourited. */
+    userRadios(userId?: string | number): Promise<publicApiList<radioResult>>;
+    /** Deezer's curated radio list. */
+    radios(): Promise<publicApiList<radioResult>>;
+    /** A radio's current tracklist — a ready-to-play (public-API) source. */
+    radioTracks(radioId: string | number): Promise<publicApiList<searchResultTrack>>;
     /** The 30-second preview clip URL for a track (plain MP3 — no licence, no decryption). */
     trackPreview(track: trackType | string | number): Promise<TrackPreview | null>;
     /** Fetch a track's 30-second preview clip as a `Buffer` (plain MP3). */

package/dist/src/lib/session.js

@@ -18,10 +18,21 @@ class Session {
     /** The arl in use for this session. */
     arl;
     concurrency;
+    userId;
     constructor(arl, concurrency) {
         this.arl = arl;
         this.concurrency = concurrency;
     }
+    /** The logged-in user's numeric id (cached). Used by the no-arg `flow` / `favorite*` methods. */
+    async resolveUserId(explicit) {
+        if (explicit !== undefined) {
+            return String(explicit);
+        }
+        if (!this.userId) {
+            this.userId = (await (0, gerdur_core_1.getUser)()).USER_ID;
+        }
+        return this.userId;
+    }
     /**
      * Log in and return a ready-to-use session. Accepts either an `arl` or
      * `email`+`password` (which are exchanged for an arl via Deezer's OAuth flow).
@@ -116,6 +127,41 @@ class Session {
     albumByUPC(upc) {
         return (0, gerdur_core_1.getAlbumByUPC)(upc);
     }
+    // ─── Flow, radios & library (public REST) ──────────────────────────────────
+    // `userId` defaults to the logged-in user (via `getUser`); their profile must
+    // be public for these to see it.
+    /** Deezer **Flow** — the endless personalised mix, as tracks. */
+    async flow(userId, limit) {
+        return (0, gerdur_core_1.getUserFlow)(await this.resolveUserId(userId), limit);
+    }
+    /** A user's favourite (loved) tracks, newest first (each with `time_add`). */
+    async favoriteTracks(userId, limit) {
+        return (0, gerdur_core_1.getUserFavoriteTracks)(await this.resolveUserId(userId), limit);
+    }
+    /** A user's favourite albums. */
+    async favoriteAlbums(userId, limit) {
+        return (0, gerdur_core_1.getUserFavoriteAlbums)(await this.resolveUserId(userId), limit);
+    }
+    /** A user's favourite artists. */
+    async favoriteArtists(userId, limit) {
+        return (0, gerdur_core_1.getUserFavoriteArtists)(await this.resolveUserId(userId), limit);
+    }
+    /** A user's own + followed playlists. */
+    async playlists(userId, limit) {
+        return (0, gerdur_core_1.getUserPlaylists)(await this.resolveUserId(userId), limit);
+    }
+    /** The radios a user has favourited. */
+    async userRadios(userId) {
+        return (0, gerdur_core_1.getUserRadios)(await this.resolveUserId(userId));
+    }
+    /** Deezer's curated radio list. */
+    radios() {
+        return (0, gerdur_core_1.getRadios)();
+    }
+    /** A radio's current tracklist — a ready-to-play (public-API) source. */
+    radioTracks(radioId) {
+        return (0, gerdur_core_1.getRadioTracks)(radioId);
+    }
     /** The 30-second preview clip URL for a track (plain MP3 — no licence, no decryption). */
     trackPreview(track) {
         return (0, gerdur_core_1.getTrackPreview)(track);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gerdur",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "The crucial streaming module for dabox systems.",
   "author": "Christian",
   "license": "SEE LICENSE IN LICENSE",
@@ -48,7 +48,7 @@
     "adm-zip": "^0.5.16",
     "chalk": "^4.1.2",
     "commander": "^9.5.0",
-    "gerdur-core": "^2.5.0",
+    "gerdur-core": "^2.6.0",
     "dot-prop": "^6.0.1",
     "got": "^11.8.6",
     "gradient-string": "^2.0.2",