lastfm-nodejs-client 1.5.6 → 1.6.1

package/dist/cjs/method.js.map

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

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.signedRequest = void 0;
-const node_crypto_1 = require("node:crypto");
 const config_js_1 = require("./config.js");
+const md5_js_1 = require("./md5.js");
+/**
+ * Last.fm API error codes.
+ * @see https://www.last.fm/api/errorcodes
+ */
 var ErrorResponse;
 (function (ErrorResponse) {
     ErrorResponse[ErrorResponse["InvalidService"] = 2] = "InvalidService";
@@ -20,6 +24,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);
@@ -81,6 +92,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, {
@@ -98,6 +117,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`
+ */
 const signedRequest = async (options, secret) => {
     const params = new URLSearchParams();
     // Collect all params (excluding format/callback)
@@ -145,7 +175,7 @@ const signedRequest = async (options, secret) => {
     // Generate signature: sort keys alphabetically, concatenate key+value, append secret, MD5
     const sortedKeys = Object.keys(sigParams).sort();
     const sigString = sortedKeys.map(k => `${k}${sigParams[k]}`).join('') + secret;
-    const apiSig = (0, node_crypto_1.createHash)('md5').update(sigString).digest('hex');
+    const apiSig = (0, md5_js_1.md5)(sigString);
     // Build POST body
     for (const [k, v] of Object.entries(sigParams)) {
         params.append(k, v);

package/dist/cjs/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/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"}