lastfm-nodejs-client 1.6.0 → 1.7.0

package/dist/getLovedTracks.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getLovedTracks(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getLovedTracks.js.map

@@ -1 +1 @@
-{"version":3,"file":"getLovedTracks.js","sourceRoot":"","sources":["../src/getLovedTracks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAsB,OAAO,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"getLovedTracks.js","sourceRoot":"","sources":["../src/getLovedTracks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAsB,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/getRecentTracks.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getRecentTracks(method, user, limit, from) {
     const options = createOptions(method, user, undefined, limit, undefined, from);

package/dist/getRecentTracks.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRecentTracks.js","sourceRoot":"","sources":["../src/getRecentTracks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,IAAY,EACZ,KAAa,EACb,IAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/E,OAAO,MAAM,OAAO,CAAuB,OAAO,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"getRecentTracks.js","sourceRoot":"","sources":["../src/getRecentTracks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,IAAY,EACZ,KAAa,EACb,IAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/E,OAAO,MAAM,OAAO,CAAuB,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/getTopAlbums.js

@@ -1,10 +1,14 @@
 import request from './request.js';
 import { createOptions } from './createOptions.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 async function getTopAlbums(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getTopAlbums.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopAlbums.js","sourceRoot":"","sources":["../src/getTopAlbums.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAoB,OAAO,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"getTopAlbums.js","sourceRoot":"","sources":["../src/getTopAlbums.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAoB,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/getTopArtists.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getTopArtists(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getTopArtists.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopArtists.js","sourceRoot":"","sources":["../src/getTopArtists.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAqB,OAAO,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"getTopArtists.js","sourceRoot":"","sources":["../src/getTopArtists.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAqB,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/getTopTracks.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getTopTracks(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getTopTracks.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopTracks.js","sourceRoot":"","sources":["../src/getTopTracks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAmB,OAAO,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"getTopTracks.js","sourceRoot":"","sources":["../src/getTopTracks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAAmB,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/getUserTopTags.js

@@ -1,10 +1,13 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getUserTopTags(method, user, limit) {
     const options = createOptions(method, user, undefined, limit);

package/dist/getUserTopTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getUserTopTags.js","sourceRoot":"","sources":["../src/getUserTopTags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,IAAY,EACZ,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9D,OAAO,MAAM,OAAO,CAAsB,OAAO,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"getUserTopTags.js","sourceRoot":"","sources":["../src/getUserTopTags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,IAAY,EACZ,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9D,OAAO,MAAM,OAAO,CAAsB,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/getWeeklyAlbumChart.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getWeeklyAlbumChart(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getWeeklyAlbumChart.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWeeklyAlbumChart.js","sourceRoot":"","sources":["../src/getWeeklyAlbumChart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA2B,OAAO,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"getWeeklyAlbumChart.js","sourceRoot":"","sources":["../src/getWeeklyAlbumChart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA2B,OAAO,CAAC,CAAC;AAC1D,CAAC"}

package/dist/getWeeklyArtistChart.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getWeeklyArtistChart(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getWeeklyArtistChart.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWeeklyArtistChart.js","sourceRoot":"","sources":["../src/getWeeklyArtistChart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA4B,OAAO,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"getWeeklyArtistChart.js","sourceRoot":"","sources":["../src/getWeeklyArtistChart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA4B,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/getWeeklyChartList.js

@@ -1,10 +1,15 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getWeeklyChartList(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getWeeklyChartList.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWeeklyChartList.js","sourceRoot":"","sources":["../src/getWeeklyChartList.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA0B,OAAO,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"getWeeklyChartList.js","sourceRoot":"","sources":["../src/getWeeklyChartList.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA0B,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/getWeeklyTrackChart.js

@@ -1,10 +1,14 @@
 import { createOptions } from './createOptions.js';
 import request from './request.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 async function getWeeklyTrackChart(method, user, period, limit) {
     const options = createOptions(method, user, period, limit);

package/dist/getWeeklyTrackChart.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWeeklyTrackChart.js","sourceRoot":"","sources":["../src/getWeeklyTrackChart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA2B,OAAO,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"getWeeklyTrackChart.js","sourceRoot":"","sources":["../src/getWeeklyTrackChart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAY,EACZ,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,OAAO,CAA2B,OAAO,CAAC,CAAC;AAC1D,CAAC"}

package/dist/index.js

@@ -65,6 +65,27 @@ import { trackScrobble } from './track/scrobble.js';
 import { trackUpdateNowPlaying } from './track/updateNowPlaying.js';
 // User
 import { userGetPersonalTags } from './user/getPersonalTags.js';
+/**
+ * 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.
+ */
 const LastFmApi = () => {
     return {
         auth,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/library/getArtists.js

@@ -1,4 +1,14 @@
 import request from '../request.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 async function libraryGetArtists(method, user, limit = '50', page = '1') {
     return await request({ method, user, limit, page });
 }

package/dist/library/getArtists.js.map

@@ -1 +1 @@
-{"version":3,"file":"getArtists.js","sourceRoot":"","sources":["../../src/library/getArtists.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc,EAAE,IAAY,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC5F,OAAO,MAAM,OAAO,CAAyB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"getArtists.js","sourceRoot":"","sources":["../../src/library/getArtists.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc,EAAE,IAAY,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC5F,OAAO,MAAM,OAAO,CAAyB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/method.js

@@ -1,3 +1,14 @@
+/**
+ * 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 const method = {
     album: {
         addTags: 'album.addTags',

package/dist/method.js.map

@@ -1 +1 @@
-{"version":3,"file":"method.js","sourceRoot":"","sources":["../src/method.ts"],"names":[],"mappings":"AAgGA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE;QACL,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,cAAc;KACvB;IACD,MAAM,EAAE;QACN,OAAO,EAAE,gBAAgB;QACzB,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,gBAAgB;QACzB,UAAU,EAAE,mBAAmB;QAC/B,OAAO,EAAE,gBAAgB;QACzB,YAAY,EAAE,qBAAqB;QACnC,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,qBAAqB;QACnC,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,eAAe;KACxB;IACD,IAAI,EAAE;QACJ,gBAAgB,EAAE,uBAAuB;QACzC,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;KAC1B;IACD,KAAK,EAAE;QACL,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,qBAAqB;KACrC;IACD,GAAG,EAAE;QACH,aAAa,EAAE,mBAAmB;QAClC,YAAY,EAAE,kBAAkB;KACjC;IACD,OAAO,EAAE;QACP,UAAU,EAAE,oBAAoB;KACjC;IACD,GAAG,EAAE;QACH,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,kBAAkB;QAChC,aAAa,EAAE,mBAAmB;QAClC,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,kBAAkB;QAChC,kBAAkB,EAAE,wBAAwB;KAC7C;IACD,KAAK,EAAE;QACL,OAAO,EAAE,eAAe;QACxB,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,kBAAkB;QAC9B,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,gBAAgB;QAC1B,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,cAAc;QACtB,gBAAgB,EAAE,wBAAwB;KAC3C;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,cAAc;QACvB,cAAc,EAAE,qBAAqB;QACrC,eAAe,EAAE,sBAAsB;QACvC,eAAe,EAAE,sBAAsB;QACvC,YAAY,EAAE,mBAAmB;QACjC,aAAa,EAAE,oBAAoB;QACnC,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,mBAAmB;QACjC,mBAAmB,EAAE,0BAA0B;QAC/C,oBAAoB,EAAE,2BAA2B;QACjD,kBAAkB,EAAE,yBAAyB;QAC7C,mBAAmB,EAAE,0BAA0B;KAChD;CACe,CAAC"}
+{"version":3,"file":"method.js","sourceRoot":"","sources":["../src/method.ts"],"names":[],"mappings":"AA6GA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,KAAK,EAAE;QACL,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,cAAc;KACvB;IACD,MAAM,EAAE;QACN,OAAO,EAAE,gBAAgB;QACzB,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,gBAAgB;QACzB,UAAU,EAAE,mBAAmB;QAC/B,OAAO,EAAE,gBAAgB;QACzB,YAAY,EAAE,qBAAqB;QACnC,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,qBAAqB;QACnC,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,eAAe;KACxB;IACD,IAAI,EAAE;QACJ,gBAAgB,EAAE,uBAAuB;QACzC,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;KAC1B;IACD,KAAK,EAAE;QACL,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,qBAAqB;KACrC;IACD,GAAG,EAAE;QACH,aAAa,EAAE,mBAAmB;QAClC,YAAY,EAAE,kBAAkB;KACjC;IACD,OAAO,EAAE;QACP,UAAU,EAAE,oBAAoB;KACjC;IACD,GAAG,EAAE;QACH,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,kBAAkB;QAChC,aAAa,EAAE,mBAAmB;QAClC,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,kBAAkB;QAChC,kBAAkB,EAAE,wBAAwB;KAC7C;IACD,KAAK,EAAE;QACL,OAAO,EAAE,eAAe;QACxB,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,kBAAkB;QAC9B,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,gBAAgB;QAC1B,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,cAAc;QACtB,gBAAgB,EAAE,wBAAwB;KAC3C;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,cAAc;QACvB,cAAc,EAAE,qBAAqB;QACrC,eAAe,EAAE,sBAAsB;QACvC,eAAe,EAAE,sBAAsB;QACvC,YAAY,EAAE,mBAAmB;QACjC,aAAa,EAAE,oBAAoB;QACnC,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,mBAAmB;QACjC,mBAAmB,EAAE,0BAA0B;QAC/C,oBAAoB,EAAE,2BAA2B;QACjD,kBAAkB,EAAE,yBAAyB;QAC7C,mBAAmB,EAAE,0BAA0B;KAChD;CACF,CAAC"}

package/dist/request.js

@@ -1,5 +1,9 @@
 import { config } from './config.js';
 import { md5 } from './md5.js';
+/**
+ * Last.fm API error codes.
+ * @see https://www.last.fm/api/errorcodes
+ */
 var ErrorResponse;
 (function (ErrorResponse) {
     ErrorResponse[ErrorResponse["InvalidService"] = 2] = "InvalidService";
@@ -17,6 +21,13 @@ var ErrorResponse;
     ErrorResponse[ErrorResponse["SuspendedAPIKey"] = 26] = "SuspendedAPIKey";
     ErrorResponse[ErrorResponse["RateLimitExceeded"] = 29] = "RateLimitExceeded";
 })(ErrorResponse || (ErrorResponse = {}));
+/**
+ * Assembles the full Last.fm API request URL from the given options,
+ * appending the API key and JSON format automatically.
+ *
+ * @param options - Request options containing the method and any query parameters
+ * @returns The fully-formed URL string
+ */
 const buildUrl = (options) => {
     const params = new URLSearchParams();
     params.append('method', options.method);
@@ -78,6 +89,14 @@ const ErrorMessages = {
     [ErrorResponse.SuspendedAPIKey]: 'Suspended API key',
     [ErrorResponse.RateLimitExceeded]: 'Rate limit exceeded',
 };
+/**
+ * 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`
+ */
 const request = async (options) => {
     const url = buildUrl(options);
     const res = await fetch(url, {
@@ -95,6 +114,17 @@ const request = async (options) => {
     }
     return body;
 };
+/**
+ * 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 const signedRequest = async (options, secret) => {
     const params = new URLSearchParams();
     // Collect all params (excluding format/callback)

package/dist/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"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"}

package/dist/tag/getInfo.js

@@ -1,4 +1,13 @@
 import request from '../request.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 async function tagGetInfo(method, tag, lang = 'en') {
     return await request({ method, tag, lang });
 }

package/dist/tag/getInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../../src/tag/getInfo.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,GAAW,EAAE,IAAI,GAAG,IAAI;IACvE,OAAO,MAAM,OAAO,CAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../../src/tag/getInfo.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,GAAW,EAAE,IAAI,GAAG,IAAI;IACvE,OAAO,MAAM,OAAO,CAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/tag/getSimilar.js

@@ -1,4 +1,12 @@
 import request from '../request.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 async function tagGetSimilar(method, tag) {
     return await request({ method, tag });
 }

package/dist/tag/getSimilar.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSimilar.js","sourceRoot":"","sources":["../../src/tag/getSimilar.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,GAAW;IAC7D,OAAO,MAAM,OAAO,CAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"getSimilar.js","sourceRoot":"","sources":["../../src/tag/getSimilar.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,GAAW;IAC7D,OAAO,MAAM,OAAO,CAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/tag/getTopAlbums.js

@@ -1,4 +1,14 @@
 import request from '../request.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 async function tagGetTopAlbums(method, tag, limit = '50', page = '1') {
     return await request({ method, tag, limit, page });
 }

package/dist/tag/getTopAlbums.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopAlbums.js","sourceRoot":"","sources":["../../src/tag/getTopAlbums.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IACzF,OAAO,MAAM,OAAO,CAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"getTopAlbums.js","sourceRoot":"","sources":["../../src/tag/getTopAlbums.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IACzF,OAAO,MAAM,OAAO,CAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/tag/getTopArtists.js

@@ -1,4 +1,14 @@
 import request from '../request.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 async function tagGetTopArtists(method, tag, limit = '50', page = '1') {
     return await request({ method, tag, limit, page });
 }

package/dist/tag/getTopArtists.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopArtists.js","sourceRoot":"","sources":["../../src/tag/getTopArtists.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC1F,OAAO,MAAM,OAAO,CAAwB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"getTopArtists.js","sourceRoot":"","sources":["../../src/tag/getTopArtists.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC1F,OAAO,MAAM,OAAO,CAAwB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/tag/getTopTags.js

@@ -1,4 +1,11 @@
 import request from '../request.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 async function tagGetTopTags(method) {
     return await request({ method });
 }

package/dist/tag/getTopTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopTags.js","sourceRoot":"","sources":["../../src/tag/getTopTags.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,OAAO,MAAM,OAAO,CAAqB,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"getTopTags.js","sourceRoot":"","sources":["../../src/tag/getTopTags.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,OAAO,MAAM,OAAO,CAAqB,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/tag/getWeeklyChartList.js

@@ -1,4 +1,13 @@
 import request from '../request.js';
+/**
+ * Get a list of available charts for this tag, expressed as date ranges which can be
+ * sent to the chart services.
+ *
+ * @see https://www.last.fm/api/show/tag.getWeeklyChartList
+ * @param method - The Last.fm API method string (`method.tag.getWeeklyChartList`)
+ * @param tag - The tag name
+ * @returns A list of date ranges representing available weekly charts for this tag
+ */
 export async function tagGetWeeklyChartList(method, tag) {
     return await request({ method, tag });
 }

package/dist/tag/getWeeklyChartList.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWeeklyChartList.js","sourceRoot":"","sources":["../../src/tag/getWeeklyChartList.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAc,EAAE,GAAW;IACrE,OAAO,MAAM,OAAO,CAA6B,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"getWeeklyChartList.js","sourceRoot":"","sources":["../../src/tag/getWeeklyChartList.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAc,EAAE,GAAW;IACrE,OAAO,MAAM,OAAO,CAA6B,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/tag/topTracks.js

@@ -1,9 +1,12 @@
 import request from '../request.js';
 /**
- * GET: Tag Top Tracks - LastFM
+ * Get the top tracks tagged with a given tag on Last.fm, ordered by tag count.
  *
- * https://www.last.fm/api/show/tag.getTopTracks
- * @returns Top Tracks for a tag
+ * @see https://www.last.fm/api/show/tag.getTopTracks
+ * @param method - The Last.fm API method string (`method.tag.getTopTracks`)
+ * @param tag - The tag name
+ * @param limit - Number of results to return
+ * @returns Top tracks for the given tag ordered by tag count
  */
 export async function tagTopTracks(method, tag, limit) {
     return await request({ method, tag, limit });

package/dist/tag/topTracks.js.map

@@ -1 +1 @@
-{"version":3,"file":"topTracks.js","sourceRoot":"","sources":["../../src/tag/topTracks.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,GAAW,EACX,KAAa;IAEb,OAAO,MAAM,OAAO,CAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"topTracks.js","sourceRoot":"","sources":["../../src/tag/topTracks.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,GAAW,EACX,KAAa;IAEb,OAAO,MAAM,OAAO,CAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/track/addTags.js

@@ -1,5 +1,16 @@
 import { signedRequest } from '../request.js';
 import { config } from '../config.js';
+/**
+ * Tag a track using a list of user-supplied tags. Requires authentication.
+ *
+ * @see https://www.last.fm/api/show/track.addTags
+ * @param method - The Last.fm API method string (`method.track.addTags`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param tags - A comma-separated list of tags to apply (max 10)
+ * @param sk - A session key obtained via the auth flow
+ * @returns Authentication response confirming the operation
+ */
 export async function trackAddTags(method, artist, track, tags, sk) {
     return await signedRequest({ method, artist, track, tags, sk }, config.share_secret);
 }

package/dist/track/addTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"addTags.js","sourceRoot":"","sources":["../../src/track/addTags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,EAAU;IACxG,OAAO,MAAM,aAAa,CAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;AACrG,CAAC"}
+{"version":3,"file":"addTags.js","sourceRoot":"","sources":["../../src/track/addTags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,EAAU;IACxG,OAAO,MAAM,aAAa,CAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;AACrG,CAAC"}