gerdur-core 2.10.0 → 2.11.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2.11.0 - 2026-08-31
+
+### Added
+
+- **`searchFacets(result)`** — flatten the per-type hit counts + Deezer's
+  relevance `order` out of a `searchMusic` result.
+
+### Internal
+
+- The live-API test suite skips more gracefully when an upstream (Deezer public
+  REST, Tidal, YouTube) rate-limits or consent-walls the runner — the
+  `--> DEEZER` converter tests and YouTube tests now degrade to a skip instead
+  of a hard fail.
+
 ## 2.10.0 - 2026-08-31
 
 Leftovers — batch token refresh + podcast episodes. Additive.

package/README.md

@@ -261,6 +261,16 @@ ignore the operators, so pass a plain string there.
 "as you type" UIs. `nb` (default 5) caps items per type. Needs an initialised
 session (`initDeezerApi`).
 
+### `.searchFacets(result)`
+
+Flattens the per-type hit counts + Deezer's relevance `order` out of a
+`searchMusic` result — for "207 tracks · 99 albums · 17 artists" UIs.
+
+```js
+const r = await searchMusic('daft punk', ['TRACK', 'ALBUM', 'ARTIST']);
+searchFacets(r); // {track: 207, album: 99, artist: 17, …, order: ['TOP_RESULT','TRACK',…]}
+```
+
 ### Browse & discovery
 
 Public REST endpoints — no `arl` needed, memoised like the rest. All return a

package/dist/api/search.d.ts

@@ -1,4 +1,4 @@
-import type { advancedSearchFilters, publicApiSearchOptions, publicApiSearchResponse, searchResultAlbum, searchResultArtist, searchResultPlaylist, searchResultTrack, suggestResult } from '../types';
+import type { advancedSearchFilters, publicApiSearchOptions, publicApiSearchResponse, searchResultAlbum, searchResultArtist, searchResultPlaylist, searchResultTrack, searchType, suggestResult } from '../types';
 /**
  * Compose Deezer's advanced search operators into one query string.
  *
@@ -47,3 +47,21 @@ export declare const searchPlaylists: (query: string, options?: Omit<publicApiSe
  * @param nb    max items per type (default 5)
  */
 export declare const suggest: (query: string, nb?: number) => Promise<suggestResult>;
+/** Per-type total hit counts + Deezer's own relevance ordering, from a `searchMusic` result. */
+export interface SearchFacets {
+    track: number;
+    album: number;
+    artist: number;
+    playlist: number;
+    radio: number;
+    show: number;
+    user: number;
+    /** the type order Deezer considers most relevant for this query, e.g. `['TOP_RESULT','ARTIST','TRACK',…]` */
+    order: string[];
+}
+/**
+ * Pull the facet counts out of a `searchMusic` (`deezer.pageSearch`) result —
+ * `pageSearch` already returns `TRACK.total`, `ALBUM.total`, … and an `ORDER`;
+ * this just surfaces them in one flat object for "N tracks · M albums · …" UIs.
+ */
+export declare const searchFacets: (result: searchType) => SearchFacets;

package/dist/api/search.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.suggest = exports.searchPlaylists = exports.searchArtists = exports.searchAlbums = exports.searchTracks = exports.searchPublicApi = exports.buildAdvancedQuery = void 0;
+exports.searchFacets = exports.suggest = exports.searchPlaylists = exports.searchArtists = exports.searchAlbums = exports.searchTracks = exports.searchPublicApi = exports.buildAdvancedQuery = void 0;
 const request_1 = require("./request");
 /**
  * Compose Deezer's advanced search operators into one query string.
@@ -108,3 +108,22 @@ const suggest = (query, nb = 5) => (0, request_1.requestLight)({
     TYPES: { ALBUM: true, ARTIST: true, TRACK: true, PLAYLIST: true, RADIO: true, SHOW: true },
 }, 'deezer.suggest');
 exports.suggest = suggest;
+/**
+ * Pull the facet counts out of a `searchMusic` (`deezer.pageSearch`) result —
+ * `pageSearch` already returns `TRACK.total`, `ALBUM.total`, … and an `ORDER`;
+ * this just surfaces them in one flat object for "N tracks · M albums · …" UIs.
+ */
+const searchFacets = (result) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    return ({
+        track: (_b = (_a = result.TRACK) === null || _a === void 0 ? void 0 : _a.total) !== null && _b !== void 0 ? _b : 0,
+        album: (_d = (_c = result.ALBUM) === null || _c === void 0 ? void 0 : _c.total) !== null && _d !== void 0 ? _d : 0,
+        artist: (_f = (_e = result.ARTIST) === null || _e === void 0 ? void 0 : _e.total) !== null && _f !== void 0 ? _f : 0,
+        playlist: (_h = (_g = result.PLAYLIST) === null || _g === void 0 ? void 0 : _g.total) !== null && _h !== void 0 ? _h : 0,
+        radio: (_k = (_j = result.RADIO) === null || _j === void 0 ? void 0 : _j.total) !== null && _k !== void 0 ? _k : 0,
+        show: (_m = (_l = result.SHOW) === null || _l === void 0 ? void 0 : _l.total) !== null && _m !== void 0 ? _m : 0,
+        user: (_p = (_o = result.USER) === null || _o === void 0 ? void 0 : _o.total) !== null && _p !== void 0 ? _p : 0,
+        order: (_q = result.ORDER) !== null && _q !== void 0 ? _q : [],
+    });
+};
+exports.searchFacets = searchFacets;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gerdur-core",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Core module for gerdur.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",