gerdur 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2.1.0 - 2026-08-31
+
+### Added
+
+- **`gerdur-core@^2.1.0`** — the new search surface is re-exported from the
+  library: `searchPublicApi`, `searchTracks` / `searchAlbums` / `searchArtists` /
+  `searchPlaylists`, `buildAdvancedQuery`, `suggest`, plus the matching types.
+- **`Session.searchAdvanced(filters, options?)`** — structured search against the
+  public REST API — a free-text query plus `{artist, album, track, label, durMin,
+  durMax, bpmMin, bpmMax}`, with `order` / `limit` / `index`. Returns public-API
+  track objects with `isrc` / `preview`; fetch a hit's gw track with
+  `getTrackInfo(id)` to download.
+- **`Session.suggest(query, nb?)`** — `deezer.suggest` autocomplete.
+
+_No CLI changes in this release — the interactive `gerdur` flow is unchanged._
+
 ## 2.0.0 - 2026-08-31
 
 ### Changed

package/README.md

@@ -175,12 +175,22 @@ await session.downloadUrl('https://deezer.com/album/302127', 'flac', {
 const {tracks} = await session.parseUrl('https://deezer.com/track/3135556');
 const found = await session.search('daft punk', ['TRACK'], 10);
 const results = await session.downloadTracks(tracks, '320', {output: '{ART_NAME} - {SNG_TITLE}'});
+
+// Structured search against the public REST API (isrc / preview / bpm-aware):
+const hits = await session.searchAdvanced(
+  {query: 'one more time', artist: 'daft punk', durMin: 200},
+  {limit: 25, order: 'RANKING'},
+);
+const suggestions = await session.suggest('daft'); // autocomplete
 ```
 
-Session methods: `parseUrl`, `search`, `getUser`, `getTrackBuffer`, `downloadTrack`,
-`downloadTracks`, `downloadUrl`. Every download call is silent; `downloadTracks` /
-`downloadUrl` accept `concurrency` and an `onProgress` callback and return one
-`{path, written} | null` per track.
+Session methods: `parseUrl`, `search`, `searchAdvanced`, `suggest`, `getUser`,
+`getTrackBuffer`, `downloadTrack`, `downloadTracks`, `downloadUrl`. Every download
+call is silent; `downloadTracks` / `downloadUrl` accept `concurrency` and an
+`onProgress` callback and return one `{path, written} | null` per track.
+
+`searchAdvanced` returns public-API track objects; fetch a hit's gw track with
+`getTrackInfo(id)` before downloading it.
 
 ### Low-level: primitives
 
@@ -204,9 +214,11 @@ const {path, written} = (await downloadTrackToFile(track, 'flac', {output: '{ART
 So you don't need `gerdur-core` as a second dependency (call after `initDeezerApi`
 or `createSession`):
 
-`parseInfo`, `searchMusic`, `getUser`, `getTrackInfo`, `getAlbumInfo`, `getAlbumTracks`,
-`getPlaylistInfo`, `getPlaylistTracks`, `getArtistInfo`, `getDiscography`, `getLyrics`,
-`getTrackDownloadUrl`, `GeoBlocked`.
+`parseInfo`, `searchMusic`, `searchPublicApi`, `searchTracks`, `searchAlbums`,
+`searchArtists`, `searchPlaylists`, `buildAdvancedQuery`, `suggest`, `getUser`,
+`getTrackInfo`, `getAlbumInfo`, `getAlbumTracks`, `getPlaylistInfo`,
+`getPlaylistTracks`, `getArtistInfo`, `getDiscography`, `getLyrics`,
+`getTrackDownloadUrl`, `resolveDownloadUrls`, `GeoBlocked`.
 
 ### Auth & config helpers
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gerdur",
-    "version": "2.0.0",
+    "version": "2.1.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.0.0",
+        "gerdur-core": "^2.1.0",
         "dot-prop": "^6.0.1",
         "got": "^11.8.6",
         "gradient-string": "^2.0.2",

package/dist/src/index.d.ts

@@ -59,5 +59,6 @@ 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, getUser, getTrackInfo, getAlbumInfo, getAlbumTracks, getPlaylistInfo, getPlaylistTracks, getArtistInfo, getDiscography, getLyrics, getTrackDownloadUrl, resolveDownloadUrls, addTrackTags, getRichAlbum, normalizeContributors, toLrc, GeoBlocked, } from 'gerdur-core';
+export { initDeezerApi, parseInfo, searchMusic, searchPublicApi, searchTracks, searchAlbums, searchArtists, searchPlaylists, buildAdvancedQuery, suggest, getUser, getTrackInfo, getAlbumInfo, getAlbumTracks, getPlaylistInfo, getPlaylistTracks, getArtistInfo, getDiscography, getLyrics, getTrackDownloadUrl, resolveDownloadUrls, addTrackTags, getRichAlbum, normalizeContributors, toLrc, GeoBlocked, } 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, } from 'gerdur-core/types';

package/dist/src/index.js

@@ -33,7 +33,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GeoBlocked = exports.toLrc = exports.normalizeContributors = exports.getRichAlbum = exports.addTrackTags = exports.resolveDownloadUrls = exports.getTrackDownloadUrl = exports.getLyrics = exports.getDiscography = exports.getArtistInfo = exports.getPlaylistTracks = exports.getPlaylistInfo = exports.getAlbumTracks = exports.getAlbumInfo = exports.getTrackInfo = exports.getUser = 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.GeoBlocked = exports.toLrc = exports.normalizeContributors = exports.getRichAlbum = exports.addTrackTags = exports.resolveDownloadUrls = exports.getTrackDownloadUrl = exports.getLyrics = exports.getDiscography = exports.getArtistInfo = exports.getPlaylistTracks = exports.getPlaylistInfo = exports.getAlbumTracks = exports.getAlbumInfo = exports.getTrackInfo = exports.getUser = 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;
 // ─── Authentication ────────────────────────────────────────────────────────
 const email_login_1 = require("./lib/email-login");
 Object.defineProperty(exports, "loginWithEmail", { enumerable: true, get: function () { return email_login_1.loginWithEmail; } });
@@ -89,6 +89,13 @@ var gerdur_core_1 = require("gerdur-core");
 Object.defineProperty(exports, "initDeezerApi", { enumerable: true, get: function () { return gerdur_core_1.initDeezerApi; } });
 Object.defineProperty(exports, "parseInfo", { enumerable: true, get: function () { return gerdur_core_1.parseInfo; } });
 Object.defineProperty(exports, "searchMusic", { enumerable: true, get: function () { return gerdur_core_1.searchMusic; } });
+Object.defineProperty(exports, "searchPublicApi", { enumerable: true, get: function () { return gerdur_core_1.searchPublicApi; } });
+Object.defineProperty(exports, "searchTracks", { enumerable: true, get: function () { return gerdur_core_1.searchTracks; } });
+Object.defineProperty(exports, "searchAlbums", { enumerable: true, get: function () { return gerdur_core_1.searchAlbums; } });
+Object.defineProperty(exports, "searchArtists", { enumerable: true, get: function () { return gerdur_core_1.searchArtists; } });
+Object.defineProperty(exports, "searchPlaylists", { enumerable: true, get: function () { return gerdur_core_1.searchPlaylists; } });
+Object.defineProperty(exports, "buildAdvancedQuery", { enumerable: true, get: function () { return gerdur_core_1.buildAdvancedQuery; } });
+Object.defineProperty(exports, "suggest", { enumerable: true, get: function () { return gerdur_core_1.suggest; } });
 Object.defineProperty(exports, "getUser", { enumerable: true, get: function () { return gerdur_core_1.getUser; } });
 Object.defineProperty(exports, "getTrackInfo", { enumerable: true, get: function () { return gerdur_core_1.getTrackInfo; } });
 Object.defineProperty(exports, "getAlbumInfo", { enumerable: true, get: function () { return gerdur_core_1.getAlbumInfo; } });

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

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { parseInfo, searchMusic } from 'gerdur-core';
 import type { Quality, DownloadTrackOptions, DownloadResult } from './api-download';
-import type { trackType, userType } from 'gerdur-core/types';
+import type { trackType, userType, advancedSearchFilters, publicApiSearchOptions, publicApiSearchResponse, searchResultTrack, suggestResult } from 'gerdur-core/types';
 /** Search result categories accepted by {@link Session.search}. */
 export type SearchType = 'ALBUM' | 'ARTIST' | 'TRACK' | 'PLAYLIST' | 'RADIO' | 'SHOW' | 'USER' | 'LIVESTREAM' | 'CHANNEL';
 export interface SessionOptions {
@@ -52,6 +52,17 @@ export declare class Session {
     parseUrl(url: string): ReturnType<typeof parseInfo>;
     /** Search Deezer. Defaults to track results. */
     search(query: string, types?: SearchType[], limit?: number): ReturnType<typeof searchMusic>;
+    /**
+     * Search the public REST API with structured filters (`{artist, album, track,
+     * label, durMin, durMax, bpmMin, bpmMax}`) plus a free-text `query`. Returns
+     * public-API track objects (with `isrc`, `preview`); to download a result,
+     * fetch its gw track first with the re-exported `getTrackInfo(id)`.
+     *
+     * Deezer applies the operators loosely — see `buildAdvancedQuery`.
+     */
+    searchAdvanced(filters: advancedSearchFilters, options?: Omit<publicApiSearchOptions, 'type'>): Promise<publicApiSearchResponse<searchResultTrack>>;
+    /** `deezer.suggest` autocomplete — for "as you type" UIs. `nb` caps items per type. */
+    suggest(query: string, nb?: number): Promise<suggestResult>;
     /** Return a fully tagged audio Buffer for a track (nothing written to disk). */
     getTrackBuffer(track: trackType, quality?: Quality, options?: {}): Promise<Buffer | null>;
     /** Download a single track to disk. */

package/dist/src/lib/session.js

@@ -57,6 +57,21 @@ class Session {
     search(query, types = ['TRACK'], limit) {
         return (0, gerdur_core_1.searchMusic)(query, types, limit);
     }
+    /**
+     * Search the public REST API with structured filters (`{artist, album, track,
+     * label, durMin, durMax, bpmMin, bpmMax}`) plus a free-text `query`. Returns
+     * public-API track objects (with `isrc`, `preview`); to download a result,
+     * fetch its gw track first with the re-exported `getTrackInfo(id)`.
+     *
+     * Deezer applies the operators loosely — see `buildAdvancedQuery`.
+     */
+    searchAdvanced(filters, options = {}) {
+        return (0, gerdur_core_1.searchTracks)((0, gerdur_core_1.buildAdvancedQuery)(filters), options);
+    }
+    /** `deezer.suggest` autocomplete — for "as you type" UIs. `nb` caps items per type. */
+    suggest(query, nb) {
+        return (0, gerdur_core_1.suggest)(query, nb);
+    }
     /** Return a fully tagged audio Buffer for a track (nothing written to disk). */
     getTrackBuffer(track, quality = '320', options = {}) {
         return (0, api_download_1.getTrackBuffer)(track, quality, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gerdur",
-  "version": "2.0.0",
+  "version": "2.1.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.0.0",
+    "gerdur-core": "^2.1.0",
     "dot-prop": "^6.0.1",
     "got": "^11.8.6",
     "gradient-string": "^2.0.2",