@mwyeow/moonify.js 1.0.0 → 1.1.0

package/README.md

@@ -1,51 +1,50 @@
-# Moonify.JS
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/25066cc7-6966-489c-aa77-daf52a4a9810" alt="moonify.js logo" width="550" />
+</p>
 
 <p align="center">
-  <a href="https://discord.gg/Bjgx9gaaHG">
-    <img src="https://img.shields.io/discord/1338630753512325242?color=5865F2&logo=discord&logoColor=white" alt="Discord" />
-  </a>
-  <a href="https://www.npmjs.com/package/moonify.js">
-    <img src="https://img.shields.io/npm/v/moonify.js?color=CB3837&logo=npm" alt="npm version" />
-  </a>
-  <a href="https://www.npmjs.com/package/moonify.js">
-    <img src="https://img.shields.io/npm/dt/moonify.js?color=blue" alt="npm downloads" />
-  </a>
-  <a href="https://github.com/mwyeow/moonify.js/graphs/contributors">
-    <img src="https://img.shields.io/github/contributors/mwyeow/moonify.js?color=teal" alt="Contributors" />
-  </a>
-  <a href="https://github.com/mwyeow/moonify.js/commits/main">
-    <img src="https://img.shields.io/github/last-commit/mwyeow/moonify.js" alt="Last Commit" />
-  </a>
+  <a href="https://discord.gg/Bjgx9gaaHG"><img src="https://img.shields.io/discord/1338630753512325242?color=5865F2&logo=discord&logoColor=white" alt="Discord" /></a>
+  <a href="https://www.npmjs.com/package/@mwyeow/moonify.js"><img src="https://img.shields.io/npm/v/@mwyeow/moonify.js?color=CB3837&logo=npm" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@mwyeow/moonify.js"><img src="https://img.shields.io/npm/dt/@mwyeow/moonify.js?color=blue" alt="npm downloads" /></a>
+  <a href="https://github.com/mwyeow/moonify.js/graphs/contributors"><img src="https://img.shields.io/github/contributors/mwyeow/moonify.js?color=teal" alt="Contributors" /></a>
+  <a href="https://github.com/mwyeow/moonify.js/commits/main"><img src="https://img.shields.io/github/last-commit/mwyeow/moonify.js" alt="Last Commit" /></a>
   <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License" />
 </p>
 
-A lightweight TypeScript client to fetch currently playing scrobbles from Last.fm and automatically enrich them with Spotify track links, artist URLs, and repeat tracking.
+A lightweight TypeScript client for Last.fm and Spotify, providing scrobble history, user profiles, track information, artwork, and links in one simple package.
 
 ---
 
 ## Features
 
-- Fetches live playback status via Last.fm API.
-- Automatically searches Spotify for track and artist links.
-- Gracefully falls back to Last.fm URLs if Spotify credentials are unset or the track is not found.
-- Detects whether the current track is on repeat across the user's latest scrobbles.
-- Zero external runtime dependencies (uses native web APIs: `fetch`, `AbortController`, `btoa`).
-- Works across Node.js (18+), Bun, and Deno.
+- Fetches live playback status via the Last.fm API.
+- Searches Spotify for track links, artist URLs, album names, and cover art.
+- Falls back to Last.fm artwork and URLs when needed.
+- Resolves recent scrobbles with customisable limits and playback flags.
+- Retrieves Last.fm user profiles.
+- Detects whether the current track is on repeat.
+- Zero external runtime dependencies.
+- Works with Node.js 18+, Bun, and Deno.
+-
 
 ---
 
 ## Installation
 
+### API Keys
+
+- **Last.fm:** Get your API key and secret from the [Last.fm API account page](https://www.last.fm/api/account/create).
+- **Spotify:** Create an app in the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard) to get your Client ID and Client Secret.
+
 ```bash
 # using bun
-bun add moonify.js
+bun add @mwyeow/moonify.js
 
 # using npm
-npm install moonify.js
+npm install @mwyeow/moonify.js
 
 # using pnpm
-pnpm add moonify.js
-
+pnpm add @mwyeow/moonify.js
 ```
 
 ---
@@ -53,7 +52,7 @@ pnpm add moonify.js
 ## Quick Start
 
 ```typescript
-import { Moonify } from "moonify.js";
+import { Moonify } from "@mwyeow/moonify.js";
 
 const moonify = new Moonify({
   lastfmApiKey: process.env.LASTFM_API_KEY!,
@@ -63,18 +62,34 @@ const moonify = new Moonify({
 });
 
 async function run() {
-  const result = await moonify.getCurrentlyPlaying("some_username");
-
-  if (!result) {
-    console.log("No track is playing right now.");
-    return;
+  // fetch currently playing track
+  const current = await moonify.getCurrentlyPlaying("some_username");
+
+  if (current) {
+    console.log(`${current.trackName} by ${current.artistName}`);
+    console.log(`Album: ${current.albumName}`);
+    console.log(`Cover Art: ${current.coverArtUrl}`);
+    console.log(`Listen: ${current.trackUrl}`);
+
+    if (current.isOnRepeat) {
+      console.log(`Repeated ${current.repeatCount} times recently.`);
+    }
   }
 
-  console.log(`${result.trackName} by ${result.artistName}`);
-  console.log(`Listen here: ${result.trackUrl}`);
+  // fetch recent scrobbles
+  const recents = await moonify.getRecentTracks("some_username", 5);
+  for (const track of recents) {
+    console.log(
+      `${track.trackName} - ${track.artistName} (Playing: ${track.isPlaying})`,
+    );
+  }
 
-  if (result.isOnRepeat) {
-    console.log(`Repeated ${result.repeatCount} times recently.`);
+  // fetch user profile
+  const profile = await moonify.getUserProfile("some_username");
+  if (profile) {
+    console.log(
+      `${profile.username} has ${profile.playCount.toLocaleString()} total scrobbles`,
+    );
   }
 }
 
@@ -83,22 +98,63 @@ run();
 
 ---
 
-## Response Object
-
-`getCurrentlyPlaying(username)` resolves to `null` if nothing is playing or user scrobbles are empty. When active, it returns:
-
-| Field              | Type      | Description                                              |
-| ------------------ | --------- | -------------------------------------------------------- |
-| `trackName`        | `string`  | Track name                                               |
-| `artistName`       | `string`  | Artist name                                              |
-| `trackUrl`         | `string`  | Spotify track URL (falls back to Last.fm URL)            |
-| `artistUrl`        | `string`  | Spotify artist URL (falls back to Last.fm URL)           |
-| `lastFmTrackUrl`   | `string`  | Guaranteed Last.fm track URL                             |
-| `lastFmArtistUrl`  | `string`  | Guaranteed Last.fm artist URL                            |
-| `spotifyTrackUrl`  | `string`  | Direct Spotify track URL (null if unfound/unconfigured)  |
-| `spotifyArtistUrl` | `string`  | Direct Spotify artist URL (null if unfound/unconfigured) |
-| `isOnRepeat`       | `boolean` | `true` if repeated 2+ times in recent 10 tracks          |
-| `repeatCount`      | `number`  | Total repeat count in recent tracks                      |
+## Reference
+
+### `moonify.getCurrentlyPlaying(username)`
+
+Resolves to `null` if nothing is playing or if the user's scrobble history is empty. When active, it returns:
+
+| Field              | Type      | Description                                                     |
+| ------------------ | --------- | --------------------------------------------------------------- |
+| `trackName`        | `string`  | Track name                                                      |
+| `artistName`       | `string`  | Artist name                                                     |
+| `albumName`        | `string`  | Spotify album title (falls back to Last.fm album)               |
+| `coverArtUrl`      | `string`  | Spotify high-resolution cover art (falls back to Last.fm image) |
+| `trackUrl`         | `string`  | Spotify track URL (falls back to Last.fm URL)                   |
+| `artistUrl`        | `string`  | Spotify artist URL (falls back to Last.fm URL)                  |
+| `lastFmTrackUrl`   | `string`  | Last.fm track URL                                               |
+| `lastFmArtistUrl`  | `string`  | Last.fm artist URL                                              |
+| `spotifyTrackUrl`  | `string`  | Direct Spotify track URL                                        |
+| `spotifyArtistUrl` | `string`  | Direct Spotify artist URL                                       |
+| `isOnRepeat`       | `boolean` | `true` if repeated 2+ times in recent tracks                    |
+| `repeatCount`      | `number`  | Total repeat occurrences in recent scrobbles                    |
+
+---
+
+### `moonify.getRecentTracks(username, limit?)`
+
+Retrieves an array of recent scrobbles up to the specified `limit` (default: `5`), fully enriched with artwork, album metadata, and playback states:
+
+| Field              | Type      | Description                                                     |
+| ------------------ | --------- | --------------------------------------------------------------- |
+| `trackName`        | `string`  | Track name                                                      |
+| `artistName`       | `string`  | Artist name                                                     |
+| `albumName`        | `string`  | Spotify album title (falls back to Last.fm album)               |
+| `coverArtUrl`      | `string`  | Spotify high-resolution cover art (falls back to Last.fm image) |
+| `trackUrl`         | `string`  | Spotify track URL (falls back to Last.fm URL)                   |
+| `artistUrl`        | `string`  | Spotify artist URL (falls back to Last.fm URL)                  |
+| `lastFmTrackUrl`   | `string`  | Last.fm track URL                                               |
+| `lastFmArtistUrl`  | `string`  | Last.fm artist URL                                              |
+| `spotifyTrackUrl`  | `string`  | Direct Spotify track URL                                        |
+| `spotifyArtistUrl` | `string`  | Direct Spotify artist URL                                       |
+| `isPlaying`        | `boolean` | `true` if this track is actively scrobbling right now           |
+
+---
+
+### `moonify.getUserProfile(username)`
+
+Resolves user profile details and scrobble statistics via Last.fm's `user.getinfo` endpoint. Returns `null` if the user is not found:
+
+| Field          | Type     | Description                         |
+| -------------- | -------- | ----------------------------------- |
+| `username`     | `string` | Last.fm username                    |
+| `url`          | `string` | Profile URL on Last.fm              |
+| `avatarUrl`    | `string` | High-resolution avatar URL          |
+| `country`      | `string` | Country listed on profile           |
+| `playCount`    | `number` | Total lifetime scrobble count       |
+| `registeredAt` | `number` | Account registration Unix timestamp |
+
+---
 
 ## Contributing
 

package/dist/index.cjs

@@ -95,6 +95,15 @@ var LastFmService = class {
     if (!raw) return [];
     return Array.isArray(raw) ? raw : [raw];
   }
+  async getUserInfo(username) {
+    const url = `https://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=${encodeURIComponent(
+      username
+    )}&api_key=${this.apiKey}&format=json`;
+    const data = await requestJson("lastfm", url, {
+      timeoutMs: this.timeoutMs
+    });
+    return data.user || null;
+  }
 };
 
 // src/services/spotify.service.ts
@@ -141,11 +150,22 @@ var SpotifyService = class {
   }
   async resolveTrack(track, artist) {
     if (!this.isConfigured) {
-      return { trackUrl: null, artistUrl: null };
+      return {
+        trackUrl: null,
+        artistUrl: null,
+        albumName: null,
+        coverArtUrl: null
+      };
     }
     try {
       const token = await this.getAccessToken();
-      if (!token) return { trackUrl: null, artistUrl: null };
+      if (!token)
+        return {
+          trackUrl: null,
+          artistUrl: null,
+          albumName: null,
+          coverArtUrl: null
+        };
       const query = encodeURIComponent(`track:${track} artist:${artist}`);
       const data = await requestJson(
         "spotify",
@@ -156,13 +176,28 @@ var SpotifyService = class {
         }
       );
       const item = data.tracks?.items?.[0];
-      if (!item) return { trackUrl: null, artistUrl: null };
+      if (!item)
+        return {
+          trackUrl: null,
+          artistUrl: null,
+          albumName: null,
+          coverArtUrl: null
+        };
+      const coverArtUrl = item.album?.images?.[0]?.url || null;
+      const albumName = item.album?.name || null;
       return {
         trackUrl: item.external_urls?.spotify || null,
-        artistUrl: item.artists?.[0]?.external_urls?.spotify || null
+        artistUrl: item.artists?.[0]?.external_urls?.spotify || null,
+        albumName,
+        coverArtUrl
       };
     } catch {
-      return { trackUrl: null, artistUrl: null };
+      return {
+        trackUrl: null,
+        artistUrl: null,
+        albumName: null,
+        coverArtUrl: null
+      };
     }
   }
 };
@@ -200,6 +235,9 @@ var Moonify = class {
     const artistName = currentTrack.artist["#text"] || currentTrack.artist.name || "Unknown Artist";
     const lastFmTrackUrl = currentTrack.url;
     const lastFmArtistUrl = `https://www.last.fm/music/${encodeURIComponent(artistName)}`;
+    const lastFmAlbum = currentTrack.album?.["#text"] || null;
+    const lastFmImages = currentTrack.image;
+    const lastFmCoverArt = lastFmImages?.find((img) => img.size === "extralarge")?.["#text"] || lastFmImages?.find((img) => img.size === "large")?.["#text"] || lastFmImages?.find((img) => img["#text"])?.["#text"] || null;
     const spotifyMatch = await this.spotify.resolveTrack(trackName, artistName);
     const normTrack = normalizeString(trackName);
     const normArtist = normalizeString(artistName);
@@ -217,6 +255,8 @@ var Moonify = class {
     return {
       trackName,
       artistName,
+      albumName: spotifyMatch.albumName || lastFmAlbum,
+      coverArtUrl: spotifyMatch.coverArtUrl || lastFmCoverArt,
       trackUrl: spotifyMatch.trackUrl || lastFmTrackUrl,
       artistUrl: spotifyMatch.artistUrl || lastFmArtistUrl,
       lastFmTrackUrl,
@@ -227,6 +267,58 @@ var Moonify = class {
       repeatCount
     };
   }
+  async getRecentTracks(username, limit = 5) {
+    const rawTracks = await this.lastfm.getRecentTracks(username, limit);
+    if (!rawTracks.length) return [];
+    const slicedTracks = rawTracks.slice(0, limit);
+    return Promise.all(
+      slicedTracks.map(async (raw) => {
+        const trackName = raw.name;
+        const artistName = raw.artist["#text"] || raw.artist.name || "Unknown Artist";
+        const isPlaying = raw["@attr"]?.nowplaying === "true";
+        const lastFmTrackUrl = raw.url;
+        const lastFmArtistUrl = `https://www.last.fm/music/${encodeURIComponent(artistName)}`;
+        const lastFmAlbum = raw.album?.["#text"] || null;
+        const lastFmImages = raw.image;
+        const lastFmCoverArt = lastFmImages?.find((img) => img.size === "extralarge")?.["#text"] || lastFmImages?.find((img) => img.size === "large")?.["#text"] || lastFmImages?.find((img) => img["#text"])?.["#text"] || null;
+        const spotifyMatch = await this.spotify.resolveTrack(
+          trackName,
+          artistName
+        );
+        return {
+          trackName,
+          artistName,
+          albumName: spotifyMatch.albumName || lastFmAlbum,
+          coverArtUrl: spotifyMatch.coverArtUrl || lastFmCoverArt,
+          trackUrl: spotifyMatch.trackUrl || lastFmTrackUrl,
+          artistUrl: spotifyMatch.artistUrl || lastFmArtistUrl,
+          lastFmTrackUrl,
+          lastFmArtistUrl,
+          spotifyTrackUrl: spotifyMatch.trackUrl,
+          spotifyArtistUrl: spotifyMatch.artistUrl,
+          isPlaying
+        };
+      })
+    );
+  }
+  async getUserProfile(username) {
+    const user = await this.lastfm.getUserInfo(username);
+    if (!user) return null;
+    const validImages = user.image?.filter(
+      (img) => Boolean(img["#text"]?.trim())
+    );
+    const avatarUrl = validImages?.find((img) => img.size === "extralarge")?.["#text"] || validImages?.find((img) => img.size === "large")?.["#text"] || validImages?.at(-1)?.["#text"] || null;
+    const playCount = Number(user.playcount ?? 0);
+    const registeredAt = user.registered ? Number(user.registered.unixtime || user.registered["#text"]) : null;
+    return {
+      username: user.name,
+      url: user.url,
+      avatarUrl,
+      country: user.country && user.country !== "None" ? user.country : null,
+      playCount: Number.isNaN(playCount) ? 0 : playCount,
+      registeredAt: Number.isNaN(registeredAt) ? null : registeredAt
+    };
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -8,6 +8,8 @@ interface MoonifyConfig {
 interface ResolvedCurrentlyPlaying {
     trackName: string;
     artistName: string;
+    albumName: string | null;
+    coverArtUrl: string | null;
     trackUrl: string;
     artistUrl: string;
     lastFmTrackUrl: string;
@@ -17,12 +19,35 @@ interface ResolvedCurrentlyPlaying {
     isOnRepeat: boolean;
     repeatCount: number;
 }
+interface ResolvedTrackItem {
+    trackName: string;
+    artistName: string;
+    albumName: string | null;
+    coverArtUrl: string | null;
+    trackUrl: string;
+    artistUrl: string;
+    lastFmTrackUrl: string;
+    lastFmArtistUrl: string;
+    spotifyTrackUrl: string | null;
+    spotifyArtistUrl: string | null;
+    isPlaying: boolean;
+}
+interface LastFmUserProfile {
+    username: string;
+    url: string;
+    avatarUrl: string | null;
+    country: string | null;
+    playCount: number;
+    registeredAt: number | null;
+}
 
 declare class Moonify {
     private lastfm;
     private spotify;
     constructor(config: MoonifyConfig);
     getCurrentlyPlaying(username: string): Promise<ResolvedCurrentlyPlaying | null>;
+    getRecentTracks(username: string, limit?: number): Promise<ResolvedTrackItem[]>;
+    getUserProfile(username: string): Promise<LastFmUserProfile | null>;
 }
 
 interface LastFmTrackArtist {
@@ -30,6 +55,10 @@ interface LastFmTrackArtist {
     name?: string;
     mbid?: string;
 }
+interface LastFmTrackImage {
+    "#text": string;
+    size: "small" | "medium" | "large" | "extralarge" | "";
+}
 interface LastFmRawTrack {
     name: string;
     artist: LastFmTrackArtist;
@@ -39,21 +68,40 @@ interface LastFmRawTrack {
     album?: {
         "#text"?: string;
     };
+    image?: LastFmTrackImage[];
     "@attr"?: {
         nowplaying?: string;
     };
 }
+interface LastFmUserInfoResponse {
+    user?: {
+        name: string;
+        realname?: string;
+        url: string;
+        image?: LastFmTrackImage[];
+        country?: string;
+        playcount?: string | number;
+        playlists?: string | number;
+        registered?: {
+            unixtime: string;
+            "#text": number;
+        };
+    };
+}
 
 declare class LastFmService {
     private apiKey;
     private timeoutMs;
     constructor(apiKey: string, timeoutMs?: number);
     getRecentTracks(username: string, limit?: number): Promise<LastFmRawTrack[]>;
+    getUserInfo(username: string): Promise<LastFmUserInfoResponse["user"] | null>;
 }
 
 interface SpotifyTrackMatch {
     trackUrl: string | null;
     artistUrl: string | null;
+    albumName: string | null;
+    coverArtUrl: string | null;
 }
 
 declare class SpotifyService {
@@ -80,4 +128,4 @@ declare class MoonifyAuthError extends MoonifyError {
     constructor(service: "lastfm" | "spotify", message: string);
 }
 
-export { type LastFmRawTrack, LastFmService, Moonify, MoonifyApiError, MoonifyAuthError, type MoonifyConfig, MoonifyError, type ResolvedCurrentlyPlaying, SpotifyService, type SpotifyTrackMatch };
+export { type LastFmRawTrack, LastFmService, type LastFmUserInfoResponse, type LastFmUserProfile, Moonify, MoonifyApiError, MoonifyAuthError, type MoonifyConfig, MoonifyError, type ResolvedCurrentlyPlaying, type ResolvedTrackItem, SpotifyService, type SpotifyTrackMatch };

package/dist/index.d.ts

@@ -8,6 +8,8 @@ interface MoonifyConfig {
 interface ResolvedCurrentlyPlaying {
     trackName: string;
     artistName: string;
+    albumName: string | null;
+    coverArtUrl: string | null;
     trackUrl: string;
     artistUrl: string;
     lastFmTrackUrl: string;
@@ -17,12 +19,35 @@ interface ResolvedCurrentlyPlaying {
     isOnRepeat: boolean;
     repeatCount: number;
 }
+interface ResolvedTrackItem {
+    trackName: string;
+    artistName: string;
+    albumName: string | null;
+    coverArtUrl: string | null;
+    trackUrl: string;
+    artistUrl: string;
+    lastFmTrackUrl: string;
+    lastFmArtistUrl: string;
+    spotifyTrackUrl: string | null;
+    spotifyArtistUrl: string | null;
+    isPlaying: boolean;
+}
+interface LastFmUserProfile {
+    username: string;
+    url: string;
+    avatarUrl: string | null;
+    country: string | null;
+    playCount: number;
+    registeredAt: number | null;
+}
 
 declare class Moonify {
     private lastfm;
     private spotify;
     constructor(config: MoonifyConfig);
     getCurrentlyPlaying(username: string): Promise<ResolvedCurrentlyPlaying | null>;
+    getRecentTracks(username: string, limit?: number): Promise<ResolvedTrackItem[]>;
+    getUserProfile(username: string): Promise<LastFmUserProfile | null>;
 }
 
 interface LastFmTrackArtist {
@@ -30,6 +55,10 @@ interface LastFmTrackArtist {
     name?: string;
     mbid?: string;
 }
+interface LastFmTrackImage {
+    "#text": string;
+    size: "small" | "medium" | "large" | "extralarge" | "";
+}
 interface LastFmRawTrack {
     name: string;
     artist: LastFmTrackArtist;
@@ -39,21 +68,40 @@ interface LastFmRawTrack {
     album?: {
         "#text"?: string;
     };
+    image?: LastFmTrackImage[];
     "@attr"?: {
         nowplaying?: string;
     };
 }
+interface LastFmUserInfoResponse {
+    user?: {
+        name: string;
+        realname?: string;
+        url: string;
+        image?: LastFmTrackImage[];
+        country?: string;
+        playcount?: string | number;
+        playlists?: string | number;
+        registered?: {
+            unixtime: string;
+            "#text": number;
+        };
+    };
+}
 
 declare class LastFmService {
     private apiKey;
     private timeoutMs;
     constructor(apiKey: string, timeoutMs?: number);
     getRecentTracks(username: string, limit?: number): Promise<LastFmRawTrack[]>;
+    getUserInfo(username: string): Promise<LastFmUserInfoResponse["user"] | null>;
 }
 
 interface SpotifyTrackMatch {
     trackUrl: string | null;
     artistUrl: string | null;
+    albumName: string | null;
+    coverArtUrl: string | null;
 }
 
 declare class SpotifyService {
@@ -80,4 +128,4 @@ declare class MoonifyAuthError extends MoonifyError {
     constructor(service: "lastfm" | "spotify", message: string);
 }
 
-export { type LastFmRawTrack, LastFmService, Moonify, MoonifyApiError, MoonifyAuthError, type MoonifyConfig, MoonifyError, type ResolvedCurrentlyPlaying, SpotifyService, type SpotifyTrackMatch };
+export { type LastFmRawTrack, LastFmService, type LastFmUserInfoResponse, type LastFmUserProfile, Moonify, MoonifyApiError, MoonifyAuthError, type MoonifyConfig, MoonifyError, type ResolvedCurrentlyPlaying, type ResolvedTrackItem, SpotifyService, type SpotifyTrackMatch };

package/dist/index.js

@@ -64,6 +64,15 @@ var LastFmService = class {
     if (!raw) return [];
     return Array.isArray(raw) ? raw : [raw];
   }
+  async getUserInfo(username) {
+    const url = `https://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=${encodeURIComponent(
+      username
+    )}&api_key=${this.apiKey}&format=json`;
+    const data = await requestJson("lastfm", url, {
+      timeoutMs: this.timeoutMs
+    });
+    return data.user || null;
+  }
 };
 
 // src/services/spotify.service.ts
@@ -110,11 +119,22 @@ var SpotifyService = class {
   }
   async resolveTrack(track, artist) {
     if (!this.isConfigured) {
-      return { trackUrl: null, artistUrl: null };
+      return {
+        trackUrl: null,
+        artistUrl: null,
+        albumName: null,
+        coverArtUrl: null
+      };
     }
     try {
       const token = await this.getAccessToken();
-      if (!token) return { trackUrl: null, artistUrl: null };
+      if (!token)
+        return {
+          trackUrl: null,
+          artistUrl: null,
+          albumName: null,
+          coverArtUrl: null
+        };
       const query = encodeURIComponent(`track:${track} artist:${artist}`);
       const data = await requestJson(
         "spotify",
@@ -125,13 +145,28 @@ var SpotifyService = class {
         }
       );
       const item = data.tracks?.items?.[0];
-      if (!item) return { trackUrl: null, artistUrl: null };
+      if (!item)
+        return {
+          trackUrl: null,
+          artistUrl: null,
+          albumName: null,
+          coverArtUrl: null
+        };
+      const coverArtUrl = item.album?.images?.[0]?.url || null;
+      const albumName = item.album?.name || null;
       return {
         trackUrl: item.external_urls?.spotify || null,
-        artistUrl: item.artists?.[0]?.external_urls?.spotify || null
+        artistUrl: item.artists?.[0]?.external_urls?.spotify || null,
+        albumName,
+        coverArtUrl
       };
     } catch {
-      return { trackUrl: null, artistUrl: null };
+      return {
+        trackUrl: null,
+        artistUrl: null,
+        albumName: null,
+        coverArtUrl: null
+      };
     }
   }
 };
@@ -169,6 +204,9 @@ var Moonify = class {
     const artistName = currentTrack.artist["#text"] || currentTrack.artist.name || "Unknown Artist";
     const lastFmTrackUrl = currentTrack.url;
     const lastFmArtistUrl = `https://www.last.fm/music/${encodeURIComponent(artistName)}`;
+    const lastFmAlbum = currentTrack.album?.["#text"] || null;
+    const lastFmImages = currentTrack.image;
+    const lastFmCoverArt = lastFmImages?.find((img) => img.size === "extralarge")?.["#text"] || lastFmImages?.find((img) => img.size === "large")?.["#text"] || lastFmImages?.find((img) => img["#text"])?.["#text"] || null;
     const spotifyMatch = await this.spotify.resolveTrack(trackName, artistName);
     const normTrack = normalizeString(trackName);
     const normArtist = normalizeString(artistName);
@@ -186,6 +224,8 @@ var Moonify = class {
     return {
       trackName,
       artistName,
+      albumName: spotifyMatch.albumName || lastFmAlbum,
+      coverArtUrl: spotifyMatch.coverArtUrl || lastFmCoverArt,
       trackUrl: spotifyMatch.trackUrl || lastFmTrackUrl,
       artistUrl: spotifyMatch.artistUrl || lastFmArtistUrl,
       lastFmTrackUrl,
@@ -196,6 +236,58 @@ var Moonify = class {
       repeatCount
     };
   }
+  async getRecentTracks(username, limit = 5) {
+    const rawTracks = await this.lastfm.getRecentTracks(username, limit);
+    if (!rawTracks.length) return [];
+    const slicedTracks = rawTracks.slice(0, limit);
+    return Promise.all(
+      slicedTracks.map(async (raw) => {
+        const trackName = raw.name;
+        const artistName = raw.artist["#text"] || raw.artist.name || "Unknown Artist";
+        const isPlaying = raw["@attr"]?.nowplaying === "true";
+        const lastFmTrackUrl = raw.url;
+        const lastFmArtistUrl = `https://www.last.fm/music/${encodeURIComponent(artistName)}`;
+        const lastFmAlbum = raw.album?.["#text"] || null;
+        const lastFmImages = raw.image;
+        const lastFmCoverArt = lastFmImages?.find((img) => img.size === "extralarge")?.["#text"] || lastFmImages?.find((img) => img.size === "large")?.["#text"] || lastFmImages?.find((img) => img["#text"])?.["#text"] || null;
+        const spotifyMatch = await this.spotify.resolveTrack(
+          trackName,
+          artistName
+        );
+        return {
+          trackName,
+          artistName,
+          albumName: spotifyMatch.albumName || lastFmAlbum,
+          coverArtUrl: spotifyMatch.coverArtUrl || lastFmCoverArt,
+          trackUrl: spotifyMatch.trackUrl || lastFmTrackUrl,
+          artistUrl: spotifyMatch.artistUrl || lastFmArtistUrl,
+          lastFmTrackUrl,
+          lastFmArtistUrl,
+          spotifyTrackUrl: spotifyMatch.trackUrl,
+          spotifyArtistUrl: spotifyMatch.artistUrl,
+          isPlaying
+        };
+      })
+    );
+  }
+  async getUserProfile(username) {
+    const user = await this.lastfm.getUserInfo(username);
+    if (!user) return null;
+    const validImages = user.image?.filter(
+      (img) => Boolean(img["#text"]?.trim())
+    );
+    const avatarUrl = validImages?.find((img) => img.size === "extralarge")?.["#text"] || validImages?.find((img) => img.size === "large")?.["#text"] || validImages?.at(-1)?.["#text"] || null;
+    const playCount = Number(user.playcount ?? 0);
+    const registeredAt = user.registered ? Number(user.registered.unixtime || user.registered["#text"]) : null;
+    return {
+      username: user.name,
+      url: user.url,
+      avatarUrl,
+      country: user.country && user.country !== "None" ? user.country : null,
+      playCount: Number.isNaN(playCount) ? 0 : playCount,
+      registeredAt: Number.isNaN(registeredAt) ? null : registeredAt
+    };
+  }
 };
 export {
   LastFmService,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mwyeow/moonify.js",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Resolve Last.fm currently playing track and enrich with Spotify metadata",
   "type": "module",
   "main": "./dist/index.cjs",