@ansango/lastfm-api 3.2.0 → 3.4.0

package/dist/services/insights/lib/personality.js.map

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

package/dist/services/insights/lib/trends.d.ts

@@ -0,0 +1,30 @@
+/**
+ * trends.ts — diff two ranked lists to calculate rank & count movements.
+ *
+ * Partitions items into 4 buckets:
+ * - risers: climbed in rank (positive deltaRank) or increased plays
+ * - fallers: dropped in rank (negative deltaRank) or decreased plays
+ * - newcomers: present in current period but absent in previous
+ * - departures: present in previous period but absent in current
+ */
+export interface RankedItem {
+    readonly name: string;
+    readonly playcount: number;
+}
+export interface RankedItemWithDelta extends RankedItem {
+    readonly currentRank: number;
+    readonly previousRank?: number;
+    readonly deltaRank: number;
+    readonly deltaCount: number;
+}
+export interface DiffRankingsOptions {
+    readonly maxResults?: number;
+}
+export interface RankingDiffResult {
+    readonly risers: RankedItemWithDelta[];
+    readonly fallers: RankedItemWithDelta[];
+    readonly newcomers: RankedItemWithDelta[];
+    readonly departures: RankedItem[];
+}
+export declare function diffRankings(current: readonly RankedItem[], previous: readonly RankedItem[], options?: DiffRankingsOptions): RankingDiffResult;
+//# sourceMappingURL=trends.d.ts.map

package/dist/services/insights/lib/trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/trends.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,EAAE,CAAA;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,CAAA;CACjC;AAUD,wBAAgB,YAAY,CAC3B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,OAAO,GAAE,mBAAwB,GAC/B,iBAAiB,CA8DnB"}

package/dist/services/insights/lib/trends.js

@@ -0,0 +1,67 @@
+function indexByName(list) {
+    const m = new Map();
+    list.forEach((item, idx) => {
+        m.set(item.name, { idx, item });
+    });
+    return m;
+}
+export function diffRankings(current, previous, options = {}) {
+    const curIdx = indexByName(current);
+    const prevIdx = indexByName(previous);
+    const risers = [];
+    const fallers = [];
+    const newcomers = [];
+    current.forEach((cur, i) => {
+        const prev = prevIdx.get(cur.name);
+        if (!prev) {
+            newcomers.push({
+                name: cur.name,
+                playcount: cur.playcount,
+                currentRank: i + 1,
+                deltaRank: 0,
+                deltaCount: cur.playcount,
+            });
+            return;
+        }
+        const deltaRank = prev.idx - i; // positive = climbed in rank
+        const deltaCount = cur.playcount - prev.item.playcount;
+        if (deltaRank > 0 || deltaCount > 0) {
+            risers.push({
+                name: cur.name,
+                playcount: cur.playcount,
+                currentRank: i + 1,
+                previousRank: prev.idx + 1,
+                deltaRank,
+                deltaCount,
+            });
+        }
+        else if (deltaRank < 0 || deltaCount < 0) {
+            fallers.push({
+                name: cur.name,
+                playcount: cur.playcount,
+                currentRank: i + 1,
+                previousRank: prev.idx + 1,
+                deltaRank,
+                deltaCount,
+            });
+        }
+    });
+    const departures = [];
+    previous.forEach((prev) => {
+        if (!curIdx.has(prev.name)) {
+            departures.push(prev);
+        }
+    });
+    // Sort buckets by current rank ascending
+    risers.sort((a, b) => a.currentRank - b.currentRank);
+    fallers.sort((a, b) => a.currentRank - b.currentRank);
+    newcomers.sort((a, b) => a.currentRank - b.currentRank);
+    const max = options.maxResults ?? Number.POSITIVE_INFINITY;
+    return {
+        risers: risers.slice(0, max),
+        fallers: fallers.slice(0, max),
+        newcomers: newcomers.slice(0, max),
+        departures: departures.slice(0, max),
+    };
+}
+//# sourceMappingURL=trends.js.map

package/dist/services/insights/lib/trends.js.map

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

package/dist/services/insights/mood.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsMoodRequest, InsightsMoodResponse } from '../insights.schemas.js';
+/**
+ * Classifies a user's emotional mood profile (energy vs. valence coordinates,
+ * mood quadrant, and top genre categories) based on user and artist tags.
+ */
+export declare function getMood(config: LastFmConfig, params: InsightsMoodRequest, init?: RequestInit): Promise<InsightsMoodResponse>;
+//# sourceMappingURL=mood.d.ts.map

package/dist/services/insights/mood.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mood.d.ts","sourceRoot":"","sources":["../../../src/services/insights/mood.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAKvF;;;GAGG;AACH,wBAAsB,OAAO,CAC5B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,oBAAoB,CAAC,CA2D/B"}

package/dist/services/insights/mood.js

@@ -0,0 +1,53 @@
+import { createArtistService } from '../artist.js';
+import { createUserService } from '../user.js';
+import { classifyMood } from './lib/mood.js';
+import { resolvePeriod } from './lib/periods.js';
+/**
+ * Classifies a user's emotional mood profile (energy vs. valence coordinates,
+ * mood quadrant, and top genre categories) based on user and artist tags.
+ */
+export async function getMood(config, params, init) {
+    const userService = createUserService(config);
+    const artistService = createArtistService(config);
+    const resolved = resolvePeriod(params.period ?? '7day');
+    const topArtistsLimit = typeof params.topArtistsLimit === 'string'
+        ? Number.parseInt(params.topArtistsLimit, 10)
+        : (params.topArtistsLimit ?? 10);
+    const [topArtistsRes, userTagsRes] = await Promise.all([
+        userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit: topArtistsLimit }, init),
+        userService.getTopTags({ user: params.user, limit: 50 }, init),
+    ]);
+    const artistNames = (topArtistsRes.topartists?.artist ?? [])
+        .map((a) => a.name)
+        .filter((name) => typeof name === 'string' && name.length > 0)
+        .slice(0, topArtistsLimit);
+    const userTags = (userTagsRes.toptags?.tag ?? [])
+        .map((t) => t.name)
+        .filter((name) => typeof name === 'string' && name.length > 0);
+    const perArtist = await Promise.allSettled(artistNames.map((name) => artistService
+        .getTopTags({ artist: name }, init)
+        .then((res) => (res.toptags?.tag ?? []).map((t) => t.name).filter((n) => typeof n === 'string' && n.length > 0))));
+    const artistTags = [];
+    let artistHits = 0;
+    for (const r of perArtist) {
+        if (r.status === 'fulfilled') {
+            artistTags.push(...r.value);
+            artistHits++;
+        }
+    }
+    const allTags = [...userTags, ...artistTags];
+    const profile = classifyMood(allTags);
+    const primarySource = userTags.length === 0 ? 'artist-tags' : artistTags.length === 0 ? 'user-tags' : 'mixed';
+    return {
+        user: params.user,
+        period: resolved.lastfm,
+        axes: profile.axes,
+        label: profile.label,
+        categories: [...profile.categories],
+        confidence: profile.confidence,
+        tagSourceCount: allTags.length,
+        artistCount: artistHits,
+        primarySource,
+    };
+}
+//# sourceMappingURL=mood.js.map

package/dist/services/insights/mood.js.map

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

package/dist/services/insights/now-playing.d.ts

@@ -0,0 +1,20 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsNowPlayingRequest, InsightsNowPlayingResponse } from '../insights.schemas.js';
+/**
+ * Strips Last.fm wiki markup and HTML tags from biography text.
+ */
+export declare function stripWiki(s: string): string;
+/**
+ * Truncates biography text cleanly on a word boundary.
+ */
+export declare function summarizeBio(bio: string | undefined, maxChars: number): string;
+/**
+ * Finds the highest quality image available from a Last.fm image array.
+ */
+export declare function findBestImage(images: unknown): string | undefined;
+/**
+ * Fetches the user's current (or most recent) track and enriches it with
+ * artist biography and similar artists.
+ */
+export declare function getNowPlaying(config: LastFmConfig, params: InsightsNowPlayingRequest, init?: RequestInit): Promise<InsightsNowPlayingResponse>;
+//# sourceMappingURL=now-playing.d.ts.map

package/dist/services/insights/now-playing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now-playing.d.ts","sourceRoot":"","sources":["../../../src/services/insights/now-playing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAGnG;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQjE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,yBAAyB,EACjC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAmGrC"}

package/dist/services/insights/now-playing.js

@@ -0,0 +1,128 @@
+import { createArtistService } from '../artist.js';
+import { createUserService } from '../user.js';
+/**
+ * Strips Last.fm wiki markup and HTML tags from biography text.
+ */
+export function stripWiki(s) {
+    return s
+        .replace(/\[\[([^|\]]+)\|([^\]]+)\]\]/g, '$2')
+        .replace(/\[\[([^\]]+)\]\]/g, '$1')
+        .replace(/<[^>]+>/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Truncates biography text cleanly on a word boundary.
+ */
+export function summarizeBio(bio, maxChars) {
+    if (!bio)
+        return '';
+    const clean = stripWiki(bio);
+    if (clean.length <= maxChars)
+        return clean;
+    const cut = clean.slice(0, maxChars);
+    const lastSpace = cut.lastIndexOf(' ');
+    return `${lastSpace > 0 ? cut.slice(0, lastSpace) : cut}…`;
+}
+/**
+ * Finds the highest quality image available from a Last.fm image array.
+ */
+export function findBestImage(images) {
+    if (!Array.isArray(images))
+        return undefined;
+    const order = ['mega', 'extralarge', 'large', 'medium', 'small'];
+    for (const size of order) {
+        const hit = images.find((i) => i?.size === size && typeof i['#text'] === 'string' && i['#text'].length > 0);
+        if (hit)
+            return hit['#text'];
+    }
+    return undefined;
+}
+/**
+ * Fetches the user's current (or most recent) track and enriches it with
+ * artist biography and similar artists.
+ */
+export async function getNowPlaying(config, params, init) {
+    const similarLimit = typeof params.similarLimit === 'string' ? Number.parseInt(params.similarLimit, 10) : (params.similarLimit ?? 3);
+    const bioMaxChars = params.bioMaxChars ?? 320;
+    const userService = createUserService(config);
+    const artistService = createArtistService(config);
+    const recentRes = await userService.getRecentTracks({ user: params.user, limit: 1 }, init);
+    const tracks = recentRes.recenttracks?.track ?? [];
+    if (tracks.length === 0) {
+        return {
+            user: params.user,
+            nowPlaying: false,
+            track: { name: '' },
+            artist: { name: '' },
+            bio: '',
+            similar: [],
+        };
+    }
+    const last = tracks[0];
+    const attr = (last['@attr'] ?? recentRes.recenttracks?.['@attr']);
+    const nowPlaying = attr?.nowplaying === 'true' || attr?.nowplaying === true;
+    const trackName = String(last.name ?? '');
+    const rawArtist = last.artist;
+    const artistName = typeof rawArtist === 'object' && rawArtist !== null
+        ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+        : String(rawArtist ?? '');
+    const rawAlbum = last.album;
+    const album = typeof rawAlbum === 'object' && rawAlbum !== null
+        ? String(rawAlbum['#text'] ?? rawAlbum.title ?? '')
+        : typeof rawAlbum === 'string'
+            ? rawAlbum
+            : undefined;
+    const image = findBestImage(last.image);
+    let bio = '';
+    let artistMbid = typeof rawArtist === 'object' && rawArtist !== null ? rawArtist.mbid : undefined;
+    let artistUrl = typeof rawArtist === 'object' && rawArtist !== null ? rawArtist.url : undefined;
+    const similar = [];
+    if (artistName.length > 0) {
+        try {
+            const [infoRes, similarRes] = await Promise.all([
+                artistService.getInfo({ artist: artistName }, init),
+                artistService.getSimilar({ artist: artistName, limit: similarLimit }, init),
+            ]);
+            const bioSummary = infoRes.artist?.bio?.summary ?? infoRes.artist?.bio?.content ?? '';
+            bio = summarizeBio(bioSummary, bioMaxChars);
+            if (!artistMbid && infoRes.artist?.mbid) {
+                artistMbid = infoRes.artist.mbid;
+            }
+            if (!artistUrl && infoRes.artist?.url) {
+                artistUrl = infoRes.artist.url;
+            }
+            const rawSimilar = similarRes.similarartists?.artist ?? [];
+            for (const s of rawSimilar.slice(0, similarLimit)) {
+                const matchNum = Number(s.match);
+                similar.push({
+                    name: s.name,
+                    url: s.url || undefined,
+                    match: Number.isNaN(matchNum) ? undefined : matchNum,
+                });
+            }
+        }
+        catch {
+            // Best-effort enrichment: if artist lookup fails, still return track & artist data
+        }
+    }
+    return {
+        user: params.user,
+        nowPlaying,
+        track: {
+            name: trackName,
+            mbid: typeof last.mbid === 'string' && last.mbid.length > 0 ? last.mbid : undefined,
+            url: typeof last.url === 'string' && last.url.length > 0 ? last.url : undefined,
+        },
+        artist: {
+            name: artistName,
+            mbid: artistMbid || undefined,
+            url: artistUrl || undefined,
+        },
+        album: album || undefined,
+        image,
+        bio,
+        similar,
+    };
+}
+//# sourceMappingURL=now-playing.js.map

package/dist/services/insights/now-playing.js.map

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

package/dist/services/insights/personality.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsPersonalityRequest, InsightsPersonalityResponse } from '../insights.schemas.js';
+/**
+ * Derives a holistic listener personality archetype (The Devotee, The Explorer,
+ * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
+ */
+export declare function getPersonality(config: LastFmConfig, params: InsightsPersonalityRequest, init?: RequestInit): Promise<InsightsPersonalityResponse>;
+//# sourceMappingURL=personality.d.ts.map

package/dist/services/insights/personality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality.d.ts","sourceRoot":"","sources":["../../../src/services/insights/personality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAMrG;;;GAGG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,0BAA0B,EAClC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,2BAA2B,CAAC,CAmCtC"}

package/dist/services/insights/personality.js

@@ -0,0 +1,42 @@
+import { getDiscoveries } from './discoveries.js';
+import { getHoursHistogram } from './hours.js';
+import { ARCHETYPE_INFO, scoreArchetypes } from './lib/personality.js';
+import { getSummary } from './summary.js';
+/**
+ * Derives a holistic listener personality archetype (The Devotee, The Explorer,
+ * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
+ */
+export async function getPersonality(config, params, init) {
+    const [summary, histogram, discoveries] = await Promise.all([
+        getSummary(config, { user: params.user, period: '1month', limit: 30 }, init),
+        getHoursHistogram(config, { user: params.user, sinceDays: 30 }, init),
+        getDiscoveries(config, { user: params.user, windowDays: 30, baselineLimit: 200, maxResults: 100 }, init),
+    ]);
+    const features = {
+        totalScrobbles: summary.totalScrobbles,
+        uniqueArtists: summary.topArtists.length,
+        top1Share: summary.diversity?.top1Share ?? 0,
+        top3Share: summary.diversity?.top3Share ?? 0,
+        top5Share: summary.diversity?.top5Share ?? 0,
+        normalizedDiversity: summary.diversity?.normalized ?? 0.5,
+        newArtistsLast30d: discoveries.totalDiscovered,
+        totalArtistsLast30d: summary.topArtists.length,
+        nightHourShare: histogram.nightShare,
+        morningHourShare: histogram.morningShare,
+        weekdayShare: 1 - histogram.weekendShare,
+    };
+    const result = scoreArchetypes(features);
+    const archetype = {
+        id: result.winner,
+        ...ARCHETYPE_INFO[result.winner],
+    };
+    return {
+        user: params.user,
+        winner: result.winner,
+        archetype,
+        scores: result.scores,
+        reasons: [...result.reasons],
+        features,
+    };
+}
+//# sourceMappingURL=personality.js.map

package/dist/services/insights/personality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality.js","sourceRoot":"","sources":["../../../src/services/insights/personality.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,cAAc,EAA4B,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAoB,EACpB,MAAkC,EAClC,IAAkB;IAElB,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3D,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;QAC5E,iBAAiB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;QACrE,cAAc,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC;KACxG,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAwB;QACrC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC;QAC5C,mBAAmB,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,GAAG;QACzD,iBAAiB,EAAE,WAAW,CAAC,eAAe;QAC9C,mBAAmB,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;QAC9C,cAAc,EAAE,SAAS,CAAC,UAAU;QACpC,gBAAgB,EAAE,SAAS,CAAC,YAAY;QACxC,YAAY,EAAE,CAAC,GAAG,SAAS,CAAC,YAAY;KACxC,CAAA;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG;QACjB,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;KAChC,CAAA;IAED,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS;QACT,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,QAAQ;KACR,CAAA;AACF,CAAC"}

package/dist/services/insights/summary.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsSummaryRequest, InsightsSummaryResponse } from '../insights.schemas.js';
+/**
+ * Fetches and aggregates listening summary for a user over a given period,
+ * including Shannon diversity calculations.
+ */
+export declare function getSummary(config: LastFmConfig, params: InsightsSummaryRequest, init?: RequestInit): Promise<InsightsSummaryResponse>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/services/insights/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/services/insights/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAIX,sBAAsB,EACtB,uBAAuB,EAGvB,MAAM,wBAAwB,CAAA;AAyE/B;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAyDlC"}

package/dist/services/insights/summary.js

@@ -0,0 +1,117 @@
+import { createUserService } from '../user.js';
+import { computeDiversity, topNShare } from './lib/diversity.js';
+import { resolvePeriod } from './lib/periods.js';
+/**
+ * Normalizes an artist from Last.fm getTopArtists payload
+ */
+function normalizeArtist(raw) {
+    const playcount = Number(raw.playcount ?? 0);
+    return {
+        name: String(raw.name ?? ''),
+        playcount: Number.isNaN(playcount) ? 0 : playcount,
+        mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+        image: Array.isArray(raw.image) ? raw.image : undefined,
+    };
+}
+/**
+ * Normalizes a track from Last.fm getTopTracks payload
+ */
+function normalizeTrack(raw) {
+    const playcount = Number(raw.playcount ?? 0);
+    const rawArtist = raw.artist;
+    const artist = typeof rawArtist === 'object' && rawArtist !== null
+        ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+        : String(rawArtist ?? '');
+    return {
+        name: String(raw.name ?? ''),
+        artist,
+        playcount: Number.isNaN(playcount) ? 0 : playcount,
+        mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+        image: Array.isArray(raw.image) ? raw.image : undefined,
+    };
+}
+/**
+ * Normalizes an album from Last.fm getTopAlbums payload
+ */
+function normalizeAlbum(raw) {
+    const playcount = Number(raw.playcount ?? 0);
+    const rawArtist = raw.artist;
+    const artist = typeof rawArtist === 'object' && rawArtist !== null
+        ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+        : typeof rawArtist === 'string'
+            ? rawArtist
+            : undefined;
+    return {
+        name: String(raw.name ?? ''),
+        artist,
+        playcount: Number.isNaN(playcount) ? 0 : playcount,
+        mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+        image: Array.isArray(raw.image) ? raw.image : undefined,
+    };
+}
+/**
+ * Normalizes a tag from Last.fm getTopTags payload
+ */
+function normalizeTag(raw) {
+    const count = Number(raw.count ?? 0);
+    return {
+        name: String(raw.name ?? ''),
+        count: Number.isNaN(count) ? 0 : count,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+    };
+}
+/**
+ * Fetches and aggregates listening summary for a user over a given period,
+ * including Shannon diversity calculations.
+ */
+export async function getSummary(config, params, init) {
+    const resolved = resolvePeriod(params.period);
+    const userService = createUserService(config);
+    const [artistsRes, tracksRes, albumsRes, tagsRes] = await Promise.all([
+        userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
+        userService.getTopTracks({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
+        userService.getTopAlbums({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
+        userService.getTopTags({ user: params.user, limit: params.limit }, init),
+    ]);
+    const topArtists = (artistsRes.topartists?.artist ?? []).map((a) => normalizeArtist(a));
+    const topTracks = (tracksRes.toptracks?.track ?? []).map((t) => normalizeTrack(t));
+    const topAlbums = (albumsRes.topalbums?.album ?? []).map((a) => normalizeAlbum(a));
+    const topTags = (tagsRes.toptags?.tag ?? []).map((t) => normalizeTag(t));
+    const totalScrobbles = topArtists.reduce((acc, a) => acc + (a.playcount ?? 0), 0);
+    let diversity;
+    if (topArtists.length >= 2) {
+        const counts = {};
+        for (const a of topArtists) {
+            if (a.playcount && a.playcount > 0) {
+                counts[a.name] = a.playcount;
+            }
+        }
+        const d = computeDiversity(counts);
+        diversity = {
+            shannon: d.shannon,
+            normalized: d.normalized,
+            top1Share: topNShare(counts, 1),
+            top3Share: topNShare(counts, 3),
+            top5Share: topNShare(counts, 5),
+            uniqueArtists: d.uniqueCount,
+        };
+    }
+    return {
+        user: params.user,
+        period: params.period ?? resolved.lastfm,
+        label: resolved.label,
+        lastfmPeriod: resolved.lastfm,
+        from: resolved.from,
+        to: resolved.to,
+        topArtists,
+        topTracks,
+        topAlbums,
+        topTags,
+        totalScrobbles,
+        diversity,
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/services/insights/summary.js.map

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

package/dist/services/insights/trends.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsTrendsRequest, InsightsTrendsResponse } from '../insights.schemas.js';
+/**
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
+ * between two time periods for artists, tracks, or albums.
+ */
+export declare function getTrends(config: LastFmConfig, params: InsightsTrendsRequest, init?: RequestInit): Promise<InsightsTrendsResponse>;
+//# sourceMappingURL=trends.d.ts.map

package/dist/services/insights/trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/services/insights/trends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAK3F;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,sBAAsB,CAAC,CA6FjC"}