lastfm-nodejs-client 1.6.0 → 1.7.0

package/dist/cjs/tag/getInfo.js

@@ -5,6 +5,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagGetInfo = tagGetInfo;
 const request_js_1 = __importDefault(require("../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
+ */
 async function tagGetInfo(method, tag, lang = 'en') {
     return await (0, request_js_1.default)({ method, tag, lang });
 }

package/dist/cjs/tag/getInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../../../src/tag/getInfo.ts"],"names":[],"mappings":";;;;;AAEA,gCAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,GAAW,EAAE,IAAI,GAAG,IAAI;IACvE,OAAO,MAAM,IAAA,oBAAO,EAAkB,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":";;;;;AAYA,gCAEC;AAbD,+DAAoC;AAEpC;;;;;;;;GAQG;AACI,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,GAAW,EAAE,IAAI,GAAG,IAAI;IACvE,OAAO,MAAM,IAAA,oBAAO,EAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/cjs/tag/getSimilar.js

@@ -5,6 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagGetSimilar = tagGetSimilar;
 const request_js_1 = __importDefault(require("../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
+ */
 async function tagGetSimilar(method, tag) {
     return await (0, request_js_1.default)({ method, tag });
 }

package/dist/cjs/tag/getSimilar.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSimilar.js","sourceRoot":"","sources":["../../../src/tag/getSimilar.ts"],"names":[],"mappings":";;;;;AAEA,sCAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,GAAW;IAC7D,OAAO,MAAM,IAAA,oBAAO,EAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"getSimilar.js","sourceRoot":"","sources":["../../../src/tag/getSimilar.ts"],"names":[],"mappings":";;;;;AAWA,sCAEC;AAZD,+DAAoC;AAEpC;;;;;;;GAOG;AACI,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,GAAW;IAC7D,OAAO,MAAM,IAAA,oBAAO,EAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/cjs/tag/getTopAlbums.js

@@ -5,6 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagGetTopAlbums = tagGetTopAlbums;
 const request_js_1 = __importDefault(require("../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
+ */
 async function tagGetTopAlbums(method, tag, limit = '50', page = '1') {
     return await (0, request_js_1.default)({ method, tag, limit, page });
 }

package/dist/cjs/tag/getTopAlbums.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopAlbums.js","sourceRoot":"","sources":["../../../src/tag/getTopAlbums.ts"],"names":[],"mappings":";;;;;AAEA,0CAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IACzF,OAAO,MAAM,IAAA,oBAAO,EAAuB,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":";;;;;AAaA,0CAEC;AAdD,+DAAoC;AAEpC;;;;;;;;;GASG;AACI,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IACzF,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/cjs/tag/getTopArtists.js

@@ -5,6 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagGetTopArtists = tagGetTopArtists;
 const request_js_1 = __importDefault(require("../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
+ */
 async function tagGetTopArtists(method, tag, limit = '50', page = '1') {
     return await (0, request_js_1.default)({ method, tag, limit, page });
 }

package/dist/cjs/tag/getTopArtists.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopArtists.js","sourceRoot":"","sources":["../../../src/tag/getTopArtists.ts"],"names":[],"mappings":";;;;;AAEA,4CAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC1F,OAAO,MAAM,IAAA,oBAAO,EAAwB,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":";;;;;AAaA,4CAEC;AAdD,+DAAoC;AAEpC;;;;;;;;;GASG;AACI,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAW,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC1F,OAAO,MAAM,IAAA,oBAAO,EAAwB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cjs/tag/getTopTags.js

@@ -5,6 +5,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagGetTopTags = tagGetTopTags;
 const request_js_1 = __importDefault(require("../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
+ */
 async function tagGetTopTags(method) {
     return await (0, request_js_1.default)({ method });
 }

package/dist/cjs/tag/getTopTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopTags.js","sourceRoot":"","sources":["../../../src/tag/getTopTags.ts"],"names":[],"mappings":";;;;;AAEA,sCAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,OAAO,MAAM,IAAA,oBAAO,EAAqB,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"getTopTags.js","sourceRoot":"","sources":["../../../src/tag/getTopTags.ts"],"names":[],"mappings":";;;;;AAUA,sCAEC;AAXD,+DAAoC;AAEpC;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,OAAO,MAAM,IAAA,oBAAO,EAAqB,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/cjs/tag/getWeeklyChartList.js

@@ -5,6 +5,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagGetWeeklyChartList = tagGetWeeklyChartList;
 const request_js_1 = __importDefault(require("../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
+ */
 async function tagGetWeeklyChartList(method, tag) {
     return await (0, request_js_1.default)({ method, tag });
 }

package/dist/cjs/tag/getWeeklyChartList.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWeeklyChartList.js","sourceRoot":"","sources":["../../../src/tag/getWeeklyChartList.ts"],"names":[],"mappings":";;;;;AAEA,sDAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,qBAAqB,CAAC,MAAc,EAAE,GAAW;IACrE,OAAO,MAAM,IAAA,oBAAO,EAA6B,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"getWeeklyChartList.js","sourceRoot":"","sources":["../../../src/tag/getWeeklyChartList.ts"],"names":[],"mappings":";;;;;AAYA,sDAEC;AAbD,+DAAoC;AAEpC;;;;;;;;GAQG;AACI,KAAK,UAAU,qBAAqB,CAAC,MAAc,EAAE,GAAW;IACrE,OAAO,MAAM,IAAA,oBAAO,EAA6B,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/cjs/tag/topTracks.js

@@ -6,10 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.tagTopTracks = tagTopTracks;
 const request_js_1 = __importDefault(require("../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
  */
 async function tagTopTracks(method, tag, limit) {
     return await (0, request_js_1.default)({ method, tag, limit });

package/dist/cjs/tag/topTracks.js.map

@@ -1 +1 @@
-{"version":3,"file":"topTracks.js","sourceRoot":"","sources":["../../../src/tag/topTracks.ts"],"names":[],"mappings":";;;;;AASA,oCAMC;AAdD,+DAAoC;AAEpC;;;;;GAKG;AACI,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,GAAW,EACX,KAAa;IAEb,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"topTracks.js","sourceRoot":"","sources":["../../../src/tag/topTracks.ts"],"names":[],"mappings":";;;;;AAYA,oCAMC;AAjBD,+DAAoC;AAEpC;;;;;;;;GAQG;AACI,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,GAAW,EACX,KAAa;IAEb,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/cjs/track/addTags.js

@@ -3,6 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackAddTags = trackAddTags;
 const request_js_1 = require("../request.js");
 const config_js_1 = require("../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
+ */
 async function trackAddTags(method, artist, track, tags, sk) {
     return await (0, request_js_1.signedRequest)({ method, artist, track, tags, sk }, config_js_1.config.share_secret);
 }

package/dist/cjs/track/addTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"addTags.js","sourceRoot":"","sources":["../../../src/track/addTags.ts"],"names":[],"mappings":";;AAGA,oCAEC;AAJD,8CAA8C;AAC9C,4CAAsC;AAC/B,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,EAAU;IACxG,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACrG,CAAC"}
+{"version":3,"file":"addTags.js","sourceRoot":"","sources":["../../../src/track/addTags.ts"],"names":[],"mappings":";;AAeA,oCAEC;AAhBD,8CAA8C;AAC9C,4CAAsC;AAEtC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,EAAU;IACxG,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACrG,CAAC"}

package/dist/cjs/track/getCorrection.js

@@ -5,6 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackGetCorrection = trackGetCorrection;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Use the Last.fm corrections data to check whether the supplied track has a correction
+ * to a canonical track and artist name.
+ *
+ * @see https://www.last.fm/api/show/track.getCorrection
+ * @param method - The Last.fm API method string (`method.track.getCorrection`)
+ * @param artist - The artist name
+ * @param track - The track name to check for a correction
+ * @returns The corrected canonical track and artist name if one exists
+ */
 async function trackGetCorrection(method, artist, track) {
     return await (0, request_js_1.default)({ method, artist, track });
 }

package/dist/cjs/track/getCorrection.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCorrection.js","sourceRoot":"","sources":["../../../src/track/getCorrection.ts"],"names":[],"mappings":";;;;;AAEA,gDAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa;IACpF,OAAO,MAAM,IAAA,oBAAO,EAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"getCorrection.js","sourceRoot":"","sources":["../../../src/track/getCorrection.ts"],"names":[],"mappings":";;;;;AAaA,gDAEC;AAdD,+DAAoC;AAEpC;;;;;;;;;GASG;AACI,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa;IACpF,OAAO,MAAM,IAAA,oBAAO,EAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/cjs/track/getInfo.js

@@ -5,6 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackGetInfo = trackGetInfo;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Get the metadata for a track on Last.fm. Includes wiki text, tags, and similar tracks.
+ *
+ * @see https://www.last.fm/api/show/track.getInfo
+ * @param method - The Last.fm API method string (`method.track.getInfo`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param autocorrect - Set to `'1'` to auto-correct misspelled names (default `'1'`)
+ * @param lang - ISO 639 alpha-2 language code for the wiki text (default `'en'`)
+ * @returns Track metadata including duration, play count, wiki, and top tags
+ */
 async function trackGetInfo(method, artist, track, autocorrect = '1', lang = 'en') {
     return await (0, request_js_1.default)({ method, artist, track, autocorrect, lang });
 }

package/dist/cjs/track/getInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../../../src/track/getInfo.ts"],"names":[],"mappings":";;;;;AAEA,oCAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,GAAG,IAAI;IAC9G,OAAO,MAAM,IAAA,oBAAO,EAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC"}
+{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../../../src/track/getInfo.ts"],"names":[],"mappings":";;;;;AAcA,oCAEC;AAfD,+DAAoC;AAEpC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,GAAG,IAAI;IAC9G,OAAO,MAAM,IAAA,oBAAO,EAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC"}

package/dist/cjs/track/getSimilar.js

@@ -5,6 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackGetSimilar = trackGetSimilar;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Get the similar tracks for this track on Last.fm, based on listening data.
+ *
+ * @see https://www.last.fm/api/show/track.getSimilar
+ * @param method - The Last.fm API method string (`method.track.getSimilar`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param limit - Maximum number of similar tracks to return (default `'30'`)
+ * @param autocorrect - Set to `'1'` to auto-correct misspelled names (default `'1'`)
+ * @returns A list of similar tracks with match scores
+ */
 async function trackGetSimilar(method, artist, track, limit = '30', autocorrect = '1') {
     return await (0, request_js_1.default)({ method, artist, track, limit, autocorrect });
 }

package/dist/cjs/track/getSimilar.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSimilar.js","sourceRoot":"","sources":["../../../src/track/getSimilar.ts"],"names":[],"mappings":";;;;;AAEA,0CAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,KAAK,GAAG,IAAI,EAAE,WAAW,GAAG,GAAG;IAClH,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"getSimilar.js","sourceRoot":"","sources":["../../../src/track/getSimilar.ts"],"names":[],"mappings":";;;;;AAcA,0CAEC;AAfD,+DAAoC;AAEpC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,KAAK,GAAG,IAAI,EAAE,WAAW,GAAG,GAAG;IAClH,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/cjs/track/getTags.js

@@ -5,6 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackGetTags = trackGetTags;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Get the tags applied by an individual user to a track on Last.fm.
+ *
+ * @see https://www.last.fm/api/show/track.getTags
+ * @param method - The Last.fm API method string (`method.track.getTags`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param user - The Last.fm username whose tags to retrieve
+ * @param autocorrect - Set to `'1'` to auto-correct misspelled names (default `'1'`)
+ * @returns Tags applied by the user to this track
+ */
 async function trackGetTags(method, artist, track, user, autocorrect = '1') {
     return await (0, request_js_1.default)({ method, artist, track, user, autocorrect });
 }

package/dist/cjs/track/getTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTags.js","sourceRoot":"","sources":["../../../src/track/getTags.ts"],"names":[],"mappings":";;;;;AAEA,oCAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,WAAW,GAAG,GAAG;IAC/G,OAAO,MAAM,IAAA,oBAAO,EAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACxF,CAAC"}
+{"version":3,"file":"getTags.js","sourceRoot":"","sources":["../../../src/track/getTags.ts"],"names":[],"mappings":";;;;;AAcA,oCAEC;AAfD,+DAAoC;AAEpC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,WAAW,GAAG,GAAG;IAC/G,OAAO,MAAM,IAAA,oBAAO,EAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACxF,CAAC"}

package/dist/cjs/track/getTopTags.js

@@ -5,6 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackGetTopTags = trackGetTopTags;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Get the top tags for a track on Last.fm, ordered by popularity.
+ *
+ * @see https://www.last.fm/api/show/track.getTopTags
+ * @param method - The Last.fm API method string (`method.track.getTopTags`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param autocorrect - Set to `'1'` to auto-correct misspelled names (default `'1'`)
+ * @returns Top tags for the track ordered by tag count
+ */
 async function trackGetTopTags(method, artist, track, autocorrect = '1') {
     return await (0, request_js_1.default)({ method, artist, track, autocorrect });
 }

package/dist/cjs/track/getTopTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopTags.js","sourceRoot":"","sources":["../../../src/track/getTopTags.ts"],"names":[],"mappings":";;;;;AAEA,0CAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,WAAW,GAAG,GAAG;IACpG,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AACrF,CAAC"}
+{"version":3,"file":"getTopTags.js","sourceRoot":"","sources":["../../../src/track/getTopTags.ts"],"names":[],"mappings":";;;;;AAaA,0CAEC;AAdD,+DAAoC;AAEpC;;;;;;;;;GASG;AACI,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,WAAW,GAAG,GAAG;IACpG,OAAO,MAAM,IAAA,oBAAO,EAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/cjs/track/love.js

@@ -3,6 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackLove = trackLove;
 const request_js_1 = require("../request.js");
 const config_js_1 = require("../config.js");
+/**
+ * Love a track for the authenticated user. Requires authentication.
+ *
+ * @see https://www.last.fm/api/show/track.love
+ * @param method - The Last.fm API method string (`method.track.love`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param sk - A session key obtained via the auth flow
+ * @returns Authentication response confirming the operation
+ */
 async function trackLove(method, artist, track, sk) {
     return await (0, request_js_1.signedRequest)({ method, artist, track, sk }, config_js_1.config.share_secret);
 }

package/dist/cjs/track/love.js.map

@@ -1 +1 @@
-{"version":3,"file":"love.js","sourceRoot":"","sources":["../../../src/track/love.ts"],"names":[],"mappings":";;AAGA,8BAEC;AAJD,8CAA8C;AAC9C,4CAAsC;AAC/B,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,EAAU;IACvF,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AAC/F,CAAC"}
+{"version":3,"file":"love.js","sourceRoot":"","sources":["../../../src/track/love.ts"],"names":[],"mappings":";;AAcA,8BAEC;AAfD,8CAA8C;AAC9C,4CAAsC;AAEtC;;;;;;;;;GASG;AACI,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,EAAU;IACvF,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AAC/F,CAAC"}

package/dist/cjs/track/removeTag.js

@@ -3,6 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackRemoveTag = trackRemoveTag;
 const request_js_1 = require("../request.js");
 const config_js_1 = require("../config.js");
+/**
+ * Remove a user-applied tag from a track. Requires authentication.
+ *
+ * @see https://www.last.fm/api/show/track.removeTag
+ * @param method - The Last.fm API method string (`method.track.removeTag`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param tag - A single tag to remove from the track
+ * @param sk - A session key obtained via the auth flow
+ * @returns Authentication response confirming the operation
+ */
 async function trackRemoveTag(method, artist, track, tag, sk) {
     return await (0, request_js_1.signedRequest)({ method, artist, track, tag, sk }, config_js_1.config.share_secret);
 }

package/dist/cjs/track/removeTag.js.map

@@ -1 +1 @@
-{"version":3,"file":"removeTag.js","sourceRoot":"","sources":["../../../src/track/removeTag.ts"],"names":[],"mappings":";;AAGA,wCAEC;AAJD,8CAA8C;AAC9C,4CAAsC;AAC/B,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,GAAW,EAAE,EAAU;IACzG,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACpG,CAAC"}
+{"version":3,"file":"removeTag.js","sourceRoot":"","sources":["../../../src/track/removeTag.ts"],"names":[],"mappings":";;AAeA,wCAEC;AAhBD,8CAA8C;AAC9C,4CAAsC;AAEtC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,GAAW,EAAE,EAAU;IACzG,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACpG,CAAC"}

package/dist/cjs/track/scrobble.js

@@ -3,6 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackScrobble = trackScrobble;
 const request_js_1 = require("../request.js");
 const config_js_1 = require("../config.js");
+/**
+ * Add a track-play to a user's scrobble history. Requires authentication.
+ *
+ * @see https://www.last.fm/api/show/track.scrobble
+ * @param method - The Last.fm API method string (`method.track.scrobble`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param timestamp - Unix timestamp of when the track was listened to
+ * @param album - The album name
+ * @param sk - A session key obtained via the auth flow
+ * @returns The accepted and ignored scrobble counts
+ */
 async function trackScrobble(method, artist, track, timestamp, album, sk) {
     return await (0, request_js_1.signedRequest)({ method, artist, track, timestamp, album, sk }, config_js_1.config.share_secret);
 }

package/dist/cjs/track/scrobble.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrobble.js","sourceRoot":"","sources":["../../../src/track/scrobble.ts"],"names":[],"mappings":";;AAGA,sCAEC;AAJD,8CAA8C;AAC9C,4CAAsC;AAC/B,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,SAAiB,EAAE,KAAa,EAAE,EAAU;IAC7H,OAAO,MAAM,IAAA,0BAAa,EAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACrH,CAAC"}
+{"version":3,"file":"scrobble.js","sourceRoot":"","sources":["../../../src/track/scrobble.ts"],"names":[],"mappings":";;AAgBA,sCAEC;AAjBD,8CAA8C;AAC9C,4CAAsC;AAEtC;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,SAAiB,EAAE,KAAa,EAAE,EAAU;IAC7H,OAAO,MAAM,IAAA,0BAAa,EAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACrH,CAAC"}

package/dist/cjs/track/search.js

@@ -5,6 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackSearch = trackSearch;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Search for a track by track name, optionally filtered by artist. Returns paginated results.
+ *
+ * @see https://www.last.fm/api/show/track.search
+ * @param method - The Last.fm API method string (`method.track.search`)
+ * @param track - The track name to search for
+ * @param artist - Optionally narrow results to tracks by this artist
+ * @param limit - Number of results per page (default `'30'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated track search results
+ */
 async function trackSearch(method, track, artist, limit = '30', page = '1') {
     return await (0, request_js_1.default)({ method, track, artist, limit, page });
 }

package/dist/cjs/track/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/track/search.ts"],"names":[],"mappings":";;;;;AAEA,kCAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,MAAe,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IACxG,OAAO,MAAM,IAAA,oBAAO,EAAsB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpF,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/track/search.ts"],"names":[],"mappings":";;;;;AAcA,kCAEC;AAfD,+DAAoC;AAEpC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,MAAe,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IACxG,OAAO,MAAM,IAAA,oBAAO,EAAsB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/cjs/track/unlove.js

@@ -3,6 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackUnlove = trackUnlove;
 const request_js_1 = require("../request.js");
 const config_js_1 = require("../config.js");
+/**
+ * UnLove a track for the authenticated user. Requires authentication.
+ *
+ * @see https://www.last.fm/api/show/track.unlove
+ * @param method - The Last.fm API method string (`method.track.unlove`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param sk - A session key obtained via the auth flow
+ * @returns Authentication response confirming the operation
+ */
 async function trackUnlove(method, artist, track, sk) {
     return await (0, request_js_1.signedRequest)({ method, artist, track, sk }, config_js_1.config.share_secret);
 }

package/dist/cjs/track/unlove.js.map

@@ -1 +1 @@
-{"version":3,"file":"unlove.js","sourceRoot":"","sources":["../../../src/track/unlove.ts"],"names":[],"mappings":";;AAGA,kCAEC;AAJD,8CAA8C;AAC9C,4CAAsC;AAC/B,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,EAAU;IACzF,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AAC/F,CAAC"}
+{"version":3,"file":"unlove.js","sourceRoot":"","sources":["../../../src/track/unlove.ts"],"names":[],"mappings":";;AAcA,kCAEC;AAfD,8CAA8C;AAC9C,4CAAsC;AAEtC;;;;;;;;;GASG;AACI,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,EAAU;IACzF,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AAC/F,CAAC"}

package/dist/cjs/track/updateNowPlaying.js

@@ -3,6 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackUpdateNowPlaying = trackUpdateNowPlaying;
 const request_js_1 = require("../request.js");
 const config_js_1 = require("../config.js");
+/**
+ * Notify Last.fm that a user has started listening to a track. Requires authentication.
+ *
+ * @see https://www.last.fm/api/show/track.updateNowPlaying
+ * @param method - The Last.fm API method string (`method.track.updateNowPlaying`)
+ * @param artist - The artist name
+ * @param track - The track name
+ * @param album - The album name
+ * @param sk - A session key obtained via the auth flow
+ * @returns Authentication response confirming the now-playing update
+ */
 async function trackUpdateNowPlaying(method, artist, track, album, sk) {
     return await (0, request_js_1.signedRequest)({ method, artist, track, album, sk }, config_js_1.config.share_secret);
 }

package/dist/cjs/track/updateNowPlaying.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateNowPlaying.js","sourceRoot":"","sources":["../../../src/track/updateNowPlaying.ts"],"names":[],"mappings":";;AAGA,sDAEC;AAJD,8CAA8C;AAC9C,4CAAsC;AAC/B,KAAK,UAAU,qBAAqB,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,KAAa,EAAE,EAAU;IAClH,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACtG,CAAC"}
+{"version":3,"file":"updateNowPlaying.js","sourceRoot":"","sources":["../../../src/track/updateNowPlaying.ts"],"names":[],"mappings":";;AAeA,sDAEC;AAhBD,8CAA8C;AAC9C,4CAAsC;AAEtC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,qBAAqB,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,KAAa,EAAE,EAAU;IAClH,OAAO,MAAM,IAAA,0BAAa,EAAe,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,kBAAM,CAAC,YAAY,CAAC,CAAC;AACtG,CAAC"}

package/dist/cjs/user/getPersonalTags.js

@@ -5,6 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.userGetPersonalTags = userGetPersonalTags;
 const request_js_1 = __importDefault(require("../request.js"));
+/**
+ * Get the items tagged by a user, of the type specified, filtered by tag.
+ *
+ * @see https://www.last.fm/api/show/user.getPersonalTags
+ * @param method - The Last.fm API method string (`method.user.getPersonalTags`)
+ * @param user - The Last.fm username
+ * @param tag - The tag to filter by
+ * @param taggingtype - The type of items tagged (`artist`, `album`, or `track`)
+ * @param limit - Number of results per page (default `'50'`)
+ * @param page - Page number to fetch (default `'1'`)
+ * @returns Paginated list of items tagged by the user with the given tag
+ */
 async function userGetPersonalTags(method, user, tag, taggingtype, limit = '50', page = '1') {
     return await (0, request_js_1.default)({ method, user, tag, limit, page });
 }

package/dist/cjs/user/getPersonalTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPersonalTags.js","sourceRoot":"","sources":["../../../src/user/getPersonalTags.ts"],"names":[],"mappings":";;;;;AAEA,kDAEC;AAHD,+DAAoC;AAC7B,KAAK,UAAU,mBAAmB,CAAC,MAAc,EAAE,IAAY,EAAE,GAAW,EAAE,WAAmB,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAChI,OAAO,MAAM,IAAA,oBAAO,EAA2B,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrF,CAAC"}
+{"version":3,"file":"getPersonalTags.js","sourceRoot":"","sources":["../../../src/user/getPersonalTags.ts"],"names":[],"mappings":";;;;;AAeA,kDAEC;AAhBD,+DAAoC;AAEpC;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,mBAAmB,CAAC,MAAc,EAAE,IAAY,EAAE,GAAW,EAAE,WAAmB,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAChI,OAAO,MAAM,IAAA,oBAAO,EAA2B,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;IACxC,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;IACzC,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE;IAC9C,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;KACX;IACD,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE;IACnD,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE;CACtB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;IACxC,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;IACzC,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE;IAC9C,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;KACX;IACD,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE;IACnD,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE;CACvC,CAAC"}

package/dist/createOptions.js

@@ -1,3 +1,26 @@
+/**
+ * Builds a request options object for use with `request` or `signedRequest`.
+ *
+ * @param method - The Last.fm API method string (e.g. `'user.getInfo'`)
+ * @param user - Last.fm username
+ * @param period - Time period (`overall`, `7day`, `1month`, `3month`, `6month`, `12month`)
+ * @param limit - Number of results to return per page
+ * @param page - Page number for paginated results (1-indexed)
+ * @param from - Unix timestamp; only return scrobbles after this time
+ * @param tag - Tag name
+ * @param artist - Artist name
+ * @param album - Album title
+ * @param track - Track title
+ * @param country - Country name as defined by the ISO 3166-1 standard
+ * @param autocorrect - Set to `'1'` to auto-correct misspelled artist/track names
+ * @param mbid - MusicBrainz ID for the resource
+ * @param lang - ISO 639 alpha-2 language code for localised text (default `'en'`)
+ * @param sk - Session key obtained via the auth flow
+ * @param token - Authentication token from `auth.getToken`
+ * @param tags - Comma-separated list of user-supplied tags (max 10)
+ * @param timestamp - Unix timestamp of the scrobble
+ * @returns A request options object ready to pass to `request` or `signedRequest`
+ */
 export function createOptions(method, user, period, limit, page, from, tag, artist, album, track, country, autocorrect, mbid, lang, sk, token, tags, timestamp) {
     return {
         method,

package/dist/createOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"createOptions.js","sourceRoot":"","sources":["../src/createOptions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAY,EACZ,MAAe,EACf,KAAc,EACd,IAAa,EACb,IAAa,EACb,GAAY,EACZ,MAAe,EACf,KAAc,EACd,KAAc,EACd,OAAgB,EAChB,WAAoB,EACpB,IAAa,EACb,IAAa,EACb,EAAW,EACX,KAAc,EACd,IAAa,EACb,SAAkB;IAElB,OAAO;QACL,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,MAAM;QACN,KAAK;QACL,IAAI;QACJ,MAAM;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,WAAW;QACX,IAAI;QACJ,IAAI;QACJ,EAAE;QACF,KAAK;QACL,IAAI;QACJ,SAAS;KACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createOptions.js","sourceRoot":"","sources":["../src/createOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAY,EACZ,MAAe,EACf,KAAc,EACd,IAAa,EACb,IAAa,EACb,GAAY,EACZ,MAAe,EACf,KAAc,EACd,KAAc,EACd,OAAgB,EAChB,WAAoB,EACpB,IAAa,EACb,IAAa,EACb,EAAW,EACX,KAAc,EACd,IAAa,EACb,SAAkB;IAElB,OAAO;QACL,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,MAAM;QACN,KAAK;QACL,IAAI;QACJ,MAAM;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,WAAW;QACX,IAAI;QACJ,IAAI;QACJ,EAAE;QACF,KAAK;QACL,IAAI;QACJ,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/geo/getTopArtists.js

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

package/dist/geo/getTopArtists.js.map

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

package/dist/geo/getTopTracks.js

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

package/dist/geo/getTopTracks.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTopTracks.js","sourceRoot":"","sources":["../../src/geo/getTopTracks.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AACpC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,OAAe,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC7F,OAAO,MAAM,OAAO,CAAuB,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"getTopTracks.js","sourceRoot":"","sources":["../../src/geo/getTopTracks.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,OAAe,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG;IAC7F,OAAO,MAAM,OAAO,CAAuB,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/getFriends.js

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

package/dist/getFriends.js.map

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

package/dist/getInfo.js

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

package/dist/getInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../src/getInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,IAAY;IACxD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,MAAM,OAAO,CAAe,OAAO,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"getInfo.js","sourceRoot":"","sources":["../src/getInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,IAAY;IACxD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,MAAM,OAAO,CAAe,OAAO,CAAC,CAAC;AAC9C,CAAC"}