lastfm-nodejs-client 1.6.0 → 1.7.0

package/dist/@types/geo/getTopArtists.d.ts

@@ -1,2 +1,12 @@
 import type { GeoTopArtistsResponse } from '../lastfm.types.js';
+/**
+ * Get the most popular artists on Last.fm by country.
+ *
+ * @see https://www.last.fm/api/show/geo.getTopArtists
+ * @param method - The Last.fm API method string (`method.geo.getTopArtists`)
+ * @param country - Country name as defined by the ISO 3166-1 standard
+ * @param limit - Number of results per page (default `'50'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated list of top artists for the given country
+ */
 export declare function geoGetTopArtists(method: string, country: string, limit?: string, page?: string): Promise<GeoTopArtistsResponse>;

package/dist/@types/geo/getTopTracks.d.ts

@@ -1,2 +1,12 @@
 import type { GeoTopTracksResponse } from '../lastfm.types.js';
+/**
+ * Get the most popular tracks on Last.fm by country.
+ *
+ * @see https://www.last.fm/api/show/geo.getTopTracks
+ * @param method - The Last.fm API method string (`method.geo.getTopTracks`)
+ * @param country - Country name as defined by the ISO 3166-1 standard
+ * @param limit - Number of results per page (default `'50'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated list of top tracks for the given country
+ */
 export declare function geoGetTopTracks(method: string, country: string, limit?: string, page?: string): Promise<GeoTopTracksResponse>;

package/dist/@types/getFriends.d.ts

@@ -1,8 +1,11 @@
 import type { FriendsResponse } from './lastfm.types.js';
 /**
- * GET: Friends - LastFM
+ * Get a list of the user's friends on Last.fm.
  *
- * https://www.last.fm/api/show/user.getFriends
- * @returns Friends of a user
+ * @see https://www.last.fm/api/show/user.getFriends
+ * @param method - The Last.fm API method string (`method.user.getFriends`)
+ * @param user - The Last.fm username
+ * @param limit - Number of results per page
+ * @returns A list of the user's friends with their profile information
  */
 export declare function getFriends(method: string, user: string, limit: string): Promise<FriendsResponse>;

package/dist/@types/getInfo.d.ts

@@ -1,8 +1,10 @@
 import { type UserResponse } from './lastfm.types.js';
 /**
- * GET: User profile information - LastFM
+ * Get information about a user profile on Last.fm.
  *
- * https://www.last.fm/api/show/user.getInfo
- * @returns User profile information
+ * @see https://www.last.fm/api/show/user.getInfo
+ * @param method - The Last.fm API method string (`method.user.getInfo`)
+ * @param user - The Last.fm username
+ * @returns User profile information including name, playcount, and registration date
  */
 export declare function getInfo(method: string, user: string): Promise<UserResponse>;

package/dist/@types/getLovedTracks.d.ts

@@ -1,8 +1,12 @@
 import { type LovedTracksResponse } from './lastfm.types.js';
 /**
- * GET: Love Tracks - LastFM
+ * Get the last 50 tracks loved by a user on Last.fm.
  *
- * https://www.last.fm/api/show/user.getLovedTracks
- * @returns Loved Tracks;
+ * @see https://www.last.fm/api/show/user.getLovedTracks
+ * @param method - The Last.fm API method string (`method.user.getLovedTracks`)
+ * @param user - The Last.fm username
+ * @param period - The time period to retrieve loved tracks for
+ * @param limit - Number of results per page
+ * @returns The user's loved tracks
  */
 export declare function getLovedTracks(method: string, user: string, period: string, limit: string): Promise<LovedTracksResponse>;

package/dist/@types/getRecentTracks.d.ts

@@ -1,8 +1,12 @@
 import { type RecentTracksResponse } from './lastfm.types.js';
 /**
- * GET: Recent Tracks - LastFM
+ * Get a list of the recent tracks listened to by a user on Last.fm.
  *
- * https://www.last.fm/api/show/user.getRecentTracks
- * @returns Recent Tracks
+ * @see https://www.last.fm/api/show/user.getRecentTracks
+ * @param method - The Last.fm API method string (`method.user.getRecentTracks`)
+ * @param user - The Last.fm username
+ * @param limit - Number of results per page
+ * @param from - Unix timestamp; only return tracks scrobbled after this time
+ * @returns The user's recent tracks including any currently playing track
  */
 export declare function getRecentTracks(method: string, user: string, limit: string, from?: string): Promise<RecentTracksResponse>;

package/dist/@types/getTopAlbums.d.ts

@@ -1,8 +1,12 @@
 import { type TopAlbumsResponse } from './lastfm.types.js';
 /**
- * GET: Top Albums - LastFM
+ * Get the top albums listened to by a user on Last.fm, over a given time period.
  *
- * https://www.last.fm/api/show/user.getTopAlbums
- * @returns Top Albums
+ * @see https://www.last.fm/api/show/user.getTopAlbums
+ * @param method - The Last.fm API method string (`method.user.getTopAlbums`)
+ * @param user - The Last.fm username
+ * @param period - Time period (`overall`, `7day`, `1month`, `3month`, `6month`, `12month`)
+ * @param limit - Number of results per page
+ * @returns The user's top albums for the given period
  */
 export declare function getTopAlbums(method: string, user: string, period: string, limit: string): Promise<TopAlbumsResponse>;

package/dist/@types/getTopArtists.d.ts

@@ -1,8 +1,12 @@
 import { type TopArtistsResponse } from './lastfm.types.js';
 /**
- * GET: Top Artist - LastFM
+ * Get the top artists listened to by a user on Last.fm, over a given time period.
  *
- * https://www.last.fm/api/show/user.getTopArtists
- * @returns Top Artists
+ * @see https://www.last.fm/api/show/user.getTopArtists
+ * @param method - The Last.fm API method string (`method.user.getTopArtists`)
+ * @param user - The Last.fm username
+ * @param period - Time period (`overall`, `7day`, `1month`, `3month`, `6month`, `12month`)
+ * @param limit - Number of results per page
+ * @returns The user's top artists for the given period
  */
 export declare function getTopArtists(method: string, user: string, period: string, limit: string): Promise<TopArtistsResponse>;

package/dist/@types/getTopTracks.d.ts

@@ -1,8 +1,12 @@
 import { type TopTrackResponse } from './lastfm.types.js';
 /**
- * GET: Top Tracks - LastFM
+ * Get the top tracks listened to by a user on Last.fm, over a given time period.
  *
- * https://www.last.fm/api/show/user.getTopTracks
- * @returns Top Tracks
+ * @see https://www.last.fm/api/show/user.getTopTracks
+ * @param method - The Last.fm API method string (`method.user.getTopTracks`)
+ * @param user - The Last.fm username
+ * @param period - Time period (`overall`, `7day`, `1month`, `3month`, `6month`, `12month`)
+ * @param limit - Number of results per page
+ * @returns The user's top tracks for the given period
  */
 export declare function getTopTracks(method: string, user: string, period: string, limit: string): Promise<TopTrackResponse>;

package/dist/@types/getUserTopTags.d.ts

@@ -1,8 +1,11 @@
 import type { UserTopTagsResponse } from './lastfm.types.js';
 /**
- * GET: User Top Tags - LastFM
+ * Get the top tags used by a user on Last.fm, ordered by tag count.
  *
- * https://www.last.fm/api/show/user.getTopTags
- * @returns Top Tags for a user
+ * @see https://www.last.fm/api/show/user.getTopTags
+ * @param method - The Last.fm API method string (`method.user.getTopTags`)
+ * @param user - The Last.fm username
+ * @param limit - Maximum number of tags to return
+ * @returns The user's most-used tags ordered by count
  */
 export declare function getUserTopTags(method: string, user: string, limit: string): Promise<UserTopTagsResponse>;

package/dist/@types/getWeeklyAlbumChart.d.ts

@@ -1,8 +1,12 @@
 import { type WeeklyAlbumChartResponse } from './lastfm.types.js';
 /**
- * GET: Weekly album chart - LastFM
+ * Get a list of the albums in a user's weekly album chart on Last.fm.
  *
- * https://www.last.fm/api/show/user.getWeeklyAlbumChart
- * @returns Weekly album chart
+ * @see https://www.last.fm/api/show/user.getWeeklyAlbumChart
+ * @param method - The Last.fm API method string (`method.user.getWeeklyAlbumChart`)
+ * @param user - The Last.fm username
+ * @param period - The time period for the chart
+ * @param limit - Number of results per page
+ * @returns The user's weekly album chart
  */
 export declare function getWeeklyAlbumChart(method: string, user: string, period: string, limit: string): Promise<WeeklyAlbumChartResponse>;

package/dist/@types/getWeeklyArtistChart.d.ts

@@ -1,8 +1,12 @@
 import { type WeeklyArtistChartResponse } from './lastfm.types.js';
 /**
- * GET: Weekly artist chart - LastFM
+ * Get a list of the artists in a user's weekly artist chart on Last.fm.
  *
- * https://www.last.fm/api/show/user.getWeeklyArtistChart
- * @returns Weekly artist chart
+ * @see https://www.last.fm/api/show/user.getWeeklyArtistChart
+ * @param method - The Last.fm API method string (`method.user.getWeeklyArtistChart`)
+ * @param user - The Last.fm username
+ * @param period - The time period for the chart
+ * @param limit - Number of results per page
+ * @returns The user's weekly artist chart
  */
 export declare function getWeeklyArtistChart(method: string, user: string, period: string, limit: string): Promise<WeeklyArtistChartResponse>;

package/dist/@types/getWeeklyChartList.d.ts

@@ -1,8 +1,13 @@
 import { type WeeklyChartListResponse } from './lastfm.types.js';
 /**
- * GET: Weekly chart list - LastFM
+ * Get a list of available charts for a user on Last.fm, expressed as date ranges
+ * which can be sent to the chart services.
  *
- * https://www.last.fm/api/show/user.getWeeklyChartList
- * @returns Weekly chart list
+ * @see https://www.last.fm/api/show/user.getWeeklyChartList
+ * @param method - The Last.fm API method string (`method.user.getWeeklyChartList`)
+ * @param user - The Last.fm username
+ * @param period - The time period for the chart list
+ * @param limit - Number of results per page
+ * @returns A list of date ranges representing available weekly charts for this user
  */
 export declare function getWeeklyChartList(method: string, user: string, period: string, limit: string): Promise<WeeklyChartListResponse>;

package/dist/@types/getWeeklyTrackChart.d.ts

@@ -1,8 +1,12 @@
 import { type WeeklyTrackChartResponse } from './lastfm.types.js';
 /**
- * GET: Weekly track chart - LastFM
+ * Get a list of the tracks in a user's weekly track chart on Last.fm.
  *
- * https://www.last.fm/api/show/user.getWeeklyTrackChart
- * @returns Weekly track chart
+ * @see https://www.last.fm/api/show/user.getWeeklyTrackChart
+ * @param method - The Last.fm API method string (`method.user.getWeeklyTrackChart`)
+ * @param user - The Last.fm username
+ * @param period - The time period for the chart
+ * @param limit - Number of results per page
+ * @returns The user's weekly track chart
  */
 export declare function getWeeklyTrackChart(method: string, user: string, period: string, limit: string): Promise<WeeklyTrackChartResponse>;

package/dist/@types/index.d.ts

@@ -1,4 +1,5 @@
 import { auth } from './auth.js';
+import { config } from './config.js';
 import { getFriends } from './getFriends.js';
 import { getInfo } from './getInfo.js';
 import { getLovedTracks } from './getLovedTracks.js';
@@ -11,6 +12,7 @@ import { getWeeklyAlbumChart } from './getWeeklyAlbumChart.js';
 import { getWeeklyArtistChart } from './getWeeklyArtistChart.js';
 import { getWeeklyChartList } from './getWeeklyChartList.js';
 import { getWeeklyTrackChart } from './getWeeklyTrackChart.js';
+import { method } from './method.js';
 import { chartTopTags } from './chart/topTags.js';
 import { chartTopTracks } from './chart/topTracks.js';
 import { chartTopArtists } from './chart/topArtists.js';
@@ -55,7 +57,11 @@ import { trackRemoveTag } from './track/removeTag.js';
 import { trackScrobble } from './track/scrobble.js';
 import { trackUpdateNowPlaying } from './track/updateNowPlaying.js';
 import { userGetPersonalTags } from './user/getPersonalTags.js';
-declare const LastFmApi: () => {
+/**
+ * The return type of {@link LastFmApi}, containing all namespaced API methods
+ * and the {@link method} constant for method name strings.
+ */
+export type LastFmApiReturn = {
     auth: typeof auth;
     album: {
         albumGetInfo: typeof albumGetInfo;
@@ -117,17 +123,7 @@ declare const LastFmApi: () => {
     user: {
         userGetPersonalTags: typeof userGetPersonalTags;
     };
-    config: {
-        api_key: string;
-        app_name: string;
-        base_url: string;
-        format: {
-            json: string;
-            xml: string;
-        };
-        share_secret: string;
-        username: string;
-    };
+    config: typeof config;
     getFriends: typeof getFriends;
     getInfo: typeof getInfo;
     getLovedTracks: typeof getLovedTracks;
@@ -140,82 +136,28 @@ declare const LastFmApi: () => {
     getWeeklyArtistChart: typeof getWeeklyArtistChart;
     getWeeklyChartList: typeof getWeeklyChartList;
     getWeeklyTrackChart: typeof getWeeklyTrackChart;
-    method: {
-        album: {
-            addTags: string;
-            getInfo: string;
-            getTags: string;
-            getTopTags: string;
-            removeTag: string;
-            search: string;
-        };
-        artist: {
-            addTags: string;
-            getCorrection: string;
-            getInfo: string;
-            getSimilar: string;
-            getTags: string;
-            getTopAlbums: string;
-            getTopTags: string;
-            getTopTracks: string;
-            removeTag: string;
-            search: string;
-        };
-        auth: {
-            getMobileSession: string;
-            getSession: string;
-            getToken: string;
-        };
-        chart: {
-            getTopTracks: string;
-            getTopTags: string;
-            getTopArtists: string;
-        };
-        geo: {
-            getTopArtists: string;
-            getTopTracks: string;
-        };
-        library: {
-            getArtists: string;
-        };
-        tag: {
-            getInfo: string;
-            getSimilar: string;
-            getTopAlbums: string;
-            getTopArtists: string;
-            getTopTags: string;
-            getTopTracks: string;
-            getWeeklyChartList: string;
-        };
-        track: {
-            addTags: string;
-            getCorrection: string;
-            getInfo: string;
-            getSimilar: string;
-            getTags: string;
-            getTopTags: string;
-            love: string;
-            removeTag: string;
-            scrobble: string;
-            search: string;
-            unlove: string;
-            updateNowPlaying: string;
-        };
-        user: {
-            getFriends: string;
-            getInfo: string;
-            getLovedTracks: string;
-            getPersonalTags: string;
-            getRecentTracks: string;
-            getTopAlbums: string;
-            getTopArtists: string;
-            getTopTags: string;
-            getTopTracks: string;
-            getWeeklyAlbumChart: string;
-            getWeeklyArtistChart: string;
-            getWeeklyChartList: string;
-            getWeeklyTrackChart: string;
-        };
-    };
+    method: typeof method;
 };
+/**
+ * Creates a Last.fm API client with all supported methods organised by namespace.
+ *
+ * Use the {@link method} constant (exposed as `api.method`) to pass the correct
+ * method string to each API function.
+ *
+ * @example
+ * ```ts
+ * import LastFmApi from 'lastfm-nodejs-client';
+ *
+ * const api = LastFmApi();
+ *
+ * // Read-only: get a user's top artists
+ * const topArtists = await api.getTopArtists(api.method.user.getTopArtists, 'username', '7day', '10');
+ *
+ * // Write: scrobble a track (requires session key)
+ * await api.track.trackScrobble(api.method.track.scrobble, 'Artist', 'Track', String(Date.now() / 1000 | 0), 'Album', sk);
+ * ```
+ *
+ * @returns An object containing all Last.fm API methods organised by namespace.
+ */
+declare const LastFmApi: () => LastFmApiReturn;
 export default LastFmApi;

package/dist/@types/library/getArtists.d.ts

@@ -1,2 +1,12 @@
 import type { LibraryArtistsResponse } from '../lastfm.types.js';
+/**
+ * A paginated list of all the artists in a user's library, with playcounts and tag counts.
+ *
+ * @see https://www.last.fm/api/show/library.getArtists
+ * @param method - The Last.fm API method string (`method.library.getArtists`)
+ * @param user - The Last.fm username whose library to fetch
+ * @param limit - Number of results per page (default `'50'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated list of artists from the user's library
+ */
 export declare function libraryGetArtists(method: string, user: string, limit?: string, page?: string): Promise<LibraryArtistsResponse>;

package/dist/@types/method.d.ts

@@ -1,3 +1,4 @@
+/** Last.fm `album.*` method name strings. */
 interface AlbumMethod {
     addTags: string;
     getInfo: string;
@@ -6,6 +7,7 @@ interface AlbumMethod {
     removeTag: string;
     search: string;
 }
+/** Last.fm `artist.*` method name strings. */
 interface ArtistMethod {
     addTags: string;
     getCorrection: string;
@@ -18,23 +20,28 @@ interface ArtistMethod {
     removeTag: string;
     search: string;
 }
+/** Last.fm `auth.*` method name strings. */
 interface AuthMethod {
     getMobileSession: string;
     getSession: string;
     getToken: string;
 }
+/** Last.fm `chart.*` method name strings. */
 interface ChartMethod {
     getTopArtists: string;
     getTopTags: string;
     getTopTracks: string;
 }
+/** Last.fm `geo.*` method name strings. */
 interface GeoMethod {
     getTopArtists: string;
     getTopTracks: string;
 }
+/** Last.fm `library.*` method name strings. */
 interface LibraryMethod {
     getArtists: string;
 }
+/** Last.fm `tag.*` method name strings. */
 interface TagMethod {
     getInfo: string;
     getSimilar: string;
@@ -44,6 +51,7 @@ interface TagMethod {
     getTopTracks: string;
     getWeeklyChartList: string;
 }
+/** Last.fm `track.*` method name strings. */
 interface TrackMethod {
     addTags: string;
     getCorrection: string;
@@ -58,6 +66,7 @@ interface TrackMethod {
     unlove: string;
     updateNowPlaying: string;
 }
+/** Last.fm `user.*` method name strings. */
 interface UserMethod {
     getFriends: string;
     getInfo: string;
@@ -73,6 +82,10 @@ interface UserMethod {
     getWeeklyChartList: string;
     getWeeklyTrackChart: string;
 }
+/**
+ * Namespace map of all supported Last.fm API method name strings.
+ * @see {@link method} for the singleton constant of this type.
+ */
 export interface Method {
     album: AlbumMethod;
     artist: ArtistMethod;
@@ -84,81 +97,16 @@ export interface Method {
     track: TrackMethod;
     user: UserMethod;
 }
-export declare const method: {
-    album: {
-        addTags: string;
-        getInfo: string;
-        getTags: string;
-        getTopTags: string;
-        removeTag: string;
-        search: string;
-    };
-    artist: {
-        addTags: string;
-        getCorrection: string;
-        getInfo: string;
-        getSimilar: string;
-        getTags: string;
-        getTopAlbums: string;
-        getTopTags: string;
-        getTopTracks: string;
-        removeTag: string;
-        search: string;
-    };
-    auth: {
-        getMobileSession: string;
-        getSession: string;
-        getToken: string;
-    };
-    chart: {
-        getTopTracks: string;
-        getTopTags: string;
-        getTopArtists: string;
-    };
-    geo: {
-        getTopArtists: string;
-        getTopTracks: string;
-    };
-    library: {
-        getArtists: string;
-    };
-    tag: {
-        getInfo: string;
-        getSimilar: string;
-        getTopAlbums: string;
-        getTopArtists: string;
-        getTopTags: string;
-        getTopTracks: string;
-        getWeeklyChartList: string;
-    };
-    track: {
-        addTags: string;
-        getCorrection: string;
-        getInfo: string;
-        getSimilar: string;
-        getTags: string;
-        getTopTags: string;
-        love: string;
-        removeTag: string;
-        scrobble: string;
-        search: string;
-        unlove: string;
-        updateNowPlaying: string;
-    };
-    user: {
-        getFriends: string;
-        getInfo: string;
-        getLovedTracks: string;
-        getPersonalTags: string;
-        getRecentTracks: string;
-        getTopAlbums: string;
-        getTopArtists: string;
-        getTopTags: string;
-        getTopTracks: string;
-        getWeeklyAlbumChart: string;
-        getWeeklyArtistChart: string;
-        getWeeklyChartList: string;
-        getWeeklyTrackChart: string;
-    };
-};
+/**
+ * Constant map of all Last.fm API method name strings, organised by namespace.
+ *
+ * Pass the appropriate value to API functions as the `method` parameter.
+ *
+ * @example
+ * ```ts
+ * const api = LastFmApi();
+ * const info = await api.getInfo(api.method.user.getInfo, 'username');
+ * ```
+ */
+export declare const method: Method;
 export {};

package/dist/@types/request.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Options passed to `request` and `signedRequest`.
+ * All fields correspond to Last.fm API query/body parameters.
+ */
 interface RequestOptions {
     method: string;
     user?: string;
@@ -20,6 +24,25 @@ interface RequestOptions {
     username?: string;
     password?: string;
 }
+/**
+ * Performs a GET request to the Last.fm API.
+ *
+ * Throws an `Error` on HTTP failure or if the Last.fm response body contains an error code.
+ *
+ * @param options - Request options specifying the method and query parameters
+ * @returns The parsed JSON response typed as `Response`
+ */
 declare const request: <Response>(options: RequestOptions) => Promise<Response>;
+/**
+ * Performs an MD5-signed POST request to the Last.fm API.
+ *
+ * Used for write operations (scrobble, love, addTags, auth sessions).
+ * Generates an `api_sig` by sorting all parameters alphabetically, concatenating
+ * `key+value` pairs, appending the shared secret, and MD5-hashing the result.
+ *
+ * @param options - Request options specifying the method and POST body parameters
+ * @param secret - The Last.fm shared secret used to generate the API signature
+ * @returns The parsed JSON response typed as `Response`
+ */
 export declare const signedRequest: <Response>(options: RequestOptions, secret: string) => Promise<Response>;
 export default request;

package/dist/@types/tag/getInfo.d.ts

@@ -1,2 +1,11 @@
 import type { TagInfoResponse } from '../lastfm.types.js';
+/**
+ * Get the metadata for a tag on Last.fm. Includes a short wiki summary.
+ *
+ * @see https://www.last.fm/api/show/tag.getInfo
+ * @param method - The Last.fm API method string (`method.tag.getInfo`)
+ * @param tag - The tag name
+ * @param lang - ISO 639 alpha-2 language code for the wiki text (default `'en'`)
+ * @returns Tag metadata including wiki text and reach
+ */
 export declare function tagGetInfo(method: string, tag: string, lang?: string): Promise<TagInfoResponse>;

package/dist/@types/tag/getSimilar.d.ts

@@ -1,2 +1,10 @@
 import type { TagSimilarResponse } from '../lastfm.types.js';
+/**
+ * Search for tags similar to this one on Last.fm. Returns tags ranked by similarity.
+ *
+ * @see https://www.last.fm/api/show/tag.getSimilar
+ * @param method - The Last.fm API method string (`method.tag.getSimilar`)
+ * @param tag - The tag name to find similar tags for
+ * @returns A list of similar tags
+ */
 export declare function tagGetSimilar(method: string, tag: string): Promise<TagSimilarResponse>;

package/dist/@types/tag/getTopAlbums.d.ts

@@ -1,2 +1,12 @@
 import type { TagTopAlbumsResponse } from '../lastfm.types.js';
+/**
+ * Get the top albums tagged with a given tag on Last.fm, ordered by tag count.
+ *
+ * @see https://www.last.fm/api/show/tag.getTopAlbums
+ * @param method - The Last.fm API method string (`method.tag.getTopAlbums`)
+ * @param tag - The tag name
+ * @param limit - Number of results per page (default `'50'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated list of top albums for the given tag
+ */
 export declare function tagGetTopAlbums(method: string, tag: string, limit?: string, page?: string): Promise<TagTopAlbumsResponse>;

package/dist/@types/tag/getTopArtists.d.ts

@@ -1,2 +1,12 @@
 import type { TagTopArtistsResponse } from '../lastfm.types.js';
+/**
+ * Get the top artists tagged with a given tag on Last.fm, ordered by tag count.
+ *
+ * @see https://www.last.fm/api/show/tag.getTopArtists
+ * @param method - The Last.fm API method string (`method.tag.getTopArtists`)
+ * @param tag - The tag name
+ * @param limit - Number of results per page (default `'50'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated list of top artists for the given tag
+ */
 export declare function tagGetTopArtists(method: string, tag: string, limit?: string, page?: string): Promise<TagTopArtistsResponse>;

package/dist/@types/tag/getTopTags.d.ts

@@ -1,2 +1,9 @@
 import type { TagTopTagsResponse } from '../lastfm.types.js';
+/**
+ * Fetches the top global tags on Last.fm, sorted by popularity (number of times used).
+ *
+ * @see https://www.last.fm/api/show/tag.getTopTags
+ * @param method - The Last.fm API method string (`method.tag.getTopTags`)
+ * @returns The top tags on Last.fm ordered by usage count
+ */
 export declare function tagGetTopTags(method: string): Promise<TagTopTagsResponse>;