@ansango/lastfm-api 3.4.0 → 3.5.0

package/dist/insights/algorithms/album-habits.js

@@ -0,0 +1,154 @@
+import { createUserService } from '../../core/services/user.js';
+function categorizeHabit(cohesionScore) {
+    if (cohesionScore >= 70) {
+        return {
+            profile: 'Album Purist',
+            description: 'Strong preference for complete, cohesive album listening sessions in continuous sequence.',
+        };
+    }
+    if (cohesionScore >= 45) {
+        return {
+            profile: 'Cohesive Listener',
+            description: 'Balanced listening style featuring deliberate multi-track album sessions alongside casual tracks.',
+        };
+    }
+    if (cohesionScore >= 25) {
+        return {
+            profile: 'Mixed Mode',
+            description: 'Regularly shuffles playlists and explores singles, with occasional focused album deep-dives.',
+        };
+    }
+    return {
+        profile: 'Playlist Shuffler',
+        description: 'Almost exclusively listens in shuffle, curated playlist, or single-track discovery modes.',
+    };
+}
+/**
+ * Analyzes sequential listening history to assess album completion and cohesive listening habits.
+ */
+export async function getAlbumHabits(config, params, init) {
+    const limit = Math.min(1000, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 300));
+    const minSessionTracks = Math.max(2, Math.min(10, params.minSessionTracks ?? 3));
+    const userService = createUserService(config);
+    const recentRes = await userService.getRecentTracks({ user: params.user, limit }, init);
+    const rawTracks = recentRes.recenttracks?.track ?? [];
+    const tracks = (Array.isArray(rawTracks) ? rawTracks : [rawTracks]).filter((t) => !t['@attr']?.nowplaying);
+    // Sort chronologically ascending
+    const sorted = [...tracks].sort((a, b) => {
+        const utsa = Number.parseInt(a.date?.uts ?? '0', 10);
+        const utsb = Number.parseInt(b.date?.uts ?? '0', 10);
+        return utsa - utsb;
+    });
+    if (sorted.length === 0) {
+        const { profile, description } = categorizeHabit(0);
+        return {
+            user: params.user,
+            totalScrobblesInspected: 0,
+            cohesionScore: 0,
+            profile,
+            description,
+            albumSessionCount: 0,
+            isolatedTracksCount: 0,
+            averageSessionLength: 0,
+            topAlbums: [],
+            longestSession: null,
+        };
+    }
+    const runs = [];
+    let currentRun = null;
+    for (const t of sorted) {
+        const artistName = typeof t.artist === 'object' && t.artist !== null
+            ? (t.artist['#text'] ?? t.artist.name ?? '')
+            : String(t.artist ?? '');
+        const albumName = typeof t.album === 'object' && t.album !== null ? (t.album['#text'] ?? '') : String(t.album ?? '');
+        const uts = Number.parseInt(t.date?.uts ?? '0', 10) || 0;
+        // If no album is tagged, count as isolated
+        if (!albumName.trim() || !artistName.trim()) {
+            if (currentRun) {
+                runs.push(currentRun);
+                currentRun = null;
+            }
+            runs.push({ artist: artistName, album: '', count: 1, startUts: uts, endUts: uts });
+            continue;
+        }
+        if (currentRun &&
+            currentRun.artist.toLowerCase() === artistName.toLowerCase() &&
+            currentRun.album.toLowerCase() === albumName.toLowerCase()) {
+            currentRun.count += 1;
+            currentRun.endUts = uts;
+        }
+        else {
+            if (currentRun) {
+                runs.push(currentRun);
+            }
+            currentRun = {
+                artist: artistName,
+                album: albumName,
+                count: 1,
+                startUts: uts,
+                endUts: uts,
+            };
+        }
+    }
+    if (currentRun) {
+        runs.push(currentRun);
+    }
+    let albumSessionTracksCount = 0;
+    let isolatedTracksCount = 0;
+    let albumSessionCount = 0;
+    let longestSession = null;
+    let maxSessionLength = 0;
+    const albumAgg = {};
+    for (const run of runs) {
+        if (run.count >= minSessionTracks && run.album.length > 0) {
+            albumSessionCount += 1;
+            albumSessionTracksCount += run.count;
+            const key = `${run.artist.toLowerCase()}:::${run.album.toLowerCase()}`;
+            if (!albumAgg[key]) {
+                albumAgg[key] = {
+                    artist: run.artist,
+                    album: run.album,
+                    sessionCount: 0,
+                    totalTracksPlayed: 0,
+                };
+            }
+            albumAgg[key].sessionCount += 1;
+            albumAgg[key].totalTracksPlayed += run.count;
+            if (run.count > maxSessionLength) {
+                maxSessionLength = run.count;
+                const durationHours = Math.round(((run.endUts - run.startUts) / 3600) * 100) / 100;
+                longestSession = {
+                    artist: run.artist,
+                    album: run.album,
+                    trackCount: run.count,
+                    startTime: run.startUts,
+                    endTime: run.endUts,
+                    durationHours: Math.max(0.05, durationHours),
+                };
+            }
+        }
+        else {
+            isolatedTracksCount += run.count;
+        }
+    }
+    const cohesionRatio = sorted.length > 0 ? albumSessionTracksCount / sorted.length : 0;
+    const cohesionScore = Math.round(cohesionRatio * 10000) / 100;
+    const { profile, description } = categorizeHabit(cohesionScore);
+    const avgSessionLen = albumSessionCount > 0 ? Math.round((albumSessionTracksCount / albumSessionCount) * 10) / 10 : 0;
+    const topAlbums = Object.values(albumAgg)
+        .sort((a, b) => b.totalTracksPlayed - a.totalTracksPlayed || b.sessionCount - a.sessionCount)
+        .slice(0, 10);
+    return {
+        user: params.user,
+        totalScrobblesInspected: sorted.length,
+        cohesionScore,
+        profile,
+        description,
+        albumSessionCount,
+        isolatedTracksCount,
+        averageSessionLength: avgSessionLen,
+        topAlbums,
+        longestSession,
+    };
+}
+//# sourceMappingURL=album-habits.js.map

package/dist/insights/algorithms/album-habits.js.map

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

package/dist/{services/insights → insights/algorithms}/binges.d.ts

@@ -1,5 +1,5 @@
 import type { LastFmConfig } from '../../config.js';
-import type { InsightsBingesRequest, InsightsBingesResponse } from '../insights.schemas.js';
+import type { InsightsBingesRequest, InsightsBingesResponse } from '../schemas.js';
 /**
  * Detects binge listening streaks (consecutive plays of the same artist or track)
  * across a user's recent scrobbles.

package/dist/insights/algorithms/binges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binges.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/binges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAElF;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAwDjC"}

package/dist/{services/insights → insights/algorithms}/binges.js

@@ -1,5 +1,5 @@
-import { createUserService } from '../user.js';
-import { findBinges } from './lib/binges.js';
+import { createUserService } from '../../core/services/user.js';
+import { findBinges } from '../lib/binges.js';
 /**
  * Detects binge listening streaks (consecutive plays of the same artist or track)
  * across a user's recent scrobbles.

package/dist/insights/algorithms/binges.js.map

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

package/dist/{services/insights → insights/algorithms}/compare.d.ts

@@ -1,5 +1,5 @@
 import type { LastFmConfig } from '../../config.js';
-import type { InsightsCompareRequest, InsightsCompareResponse } from '../insights.schemas.js';
+import type { InsightsCompareRequest, InsightsCompareResponse } from '../schemas.js';
 /**
  * Compares two Last.fm users' listening affinity using Jaccard similarity
  * over mutual top artist rosters.

package/dist/insights/algorithms/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEpF;;;GAGG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAmClC"}

package/dist/{services/insights → insights/algorithms}/compare.js

@@ -1,6 +1,6 @@
-import { createUserService } from '../user.js';
-import { compareArtists } from './lib/compare.js';
-import { resolvePeriod } from './lib/periods.js';
+import { createUserService } from '../../core/services/user.js';
+import { compareArtists } from '../lib/compare.js';
+import { resolvePeriod } from '../lib/periods.js';
 /**
  * Compares two Last.fm users' listening affinity using Jaccard similarity
  * over mutual top artist rosters.

package/dist/insights/algorithms/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../src/insights/algorithms/compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAyB,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAoB,EACpB,MAA8B,EAC9B,IAAkB;IAElB,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAA;IAEjC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;QACvF,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;KACvF,CAAC,CAAA;IAEF,MAAM,OAAO,GAAuB,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;KACnC,CAAC,CAAC,CAAA;IAEH,MAAM,OAAO,GAAuB,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;KACnC,CAAC,CAAC,CAAA;IAEH,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAEnD,OAAO;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;QACjD,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,WAAW,EAAE,UAAU,CAAC,YAAY,CAAC,MAAM;QAC3C,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,aAAa,EAAE,CAAC,GAAG,UAAU,CAAC,aAAa,CAAC;QAC5C,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;QAChC,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;KAChC,CAAA;AACF,CAAC"}

package/dist/insights/algorithms/decay.d.ts

@@ -0,0 +1,11 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsForgottenFavoritesRequest, InsightsForgottenFavoritesResponse, InsightsObsessionsRequest, InsightsObsessionsResponse } from '../schemas.js';
+/**
+ * Identifies artists that were staples in a user's historical period but have zero plays in the recent period.
+ */
+export declare function getForgottenFavorites(config: LastFmConfig, params: InsightsForgottenFavoritesRequest, init?: RequestInit): Promise<InsightsForgottenFavoritesResponse>;
+/**
+ * Detects intense listening obsessions (sliding windows where a single artist heavily dominates).
+ */
+export declare function getObsessions(config: LastFmConfig, params: InsightsObsessionsRequest, init?: RequestInit): Promise<InsightsObsessionsResponse>;
+//# sourceMappingURL=decay.d.ts.map

package/dist/insights/algorithms/decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/decay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAGX,iCAAiC,EACjC,kCAAkC,EAClC,yBAAyB,EACzB,0BAA0B,EAC1B,MAAM,eAAe,CAAA;AAEtB;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,iCAAiC,EACzC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,kCAAkC,CAAC,CAsD7C;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,yBAAyB,EACjC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAgIrC"}

package/dist/insights/algorithms/decay.js

@@ -0,0 +1,154 @@
+import { createUserService } from '../../core/services/user.js';
+import { resolvePeriod } from '../lib/periods.js';
+/**
+ * Identifies artists that were staples in a user's historical period but have zero plays in the recent period.
+ */
+export async function getForgottenFavorites(config, params, init) {
+    const limit = Math.min(50, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 20));
+    const historicPeriod = params.historicPeriod ?? '12month';
+    const recentPeriod = params.recentPeriod ?? '1month';
+    const resolvedHist = resolvePeriod(historicPeriod);
+    const resolvedRecent = resolvePeriod(recentPeriod);
+    const userService = createUserService(config);
+    // Fetch historical top artists (sample top 100)
+    const histRes = await userService.getTopArtists({ user: params.user, period: resolvedHist.lastfm, limit: 100 }, init);
+    // Fetch recent top artists (sample top 100)
+    const recentRes = await userService.getTopArtists({ user: params.user, period: resolvedRecent.lastfm, limit: 100 }, init);
+    const rawHist = histRes.topartists?.artist ?? [];
+    const histList = Array.isArray(rawHist) ? rawHist : [rawHist];
+    const rawRecent = recentRes.topartists?.artist ?? [];
+    const recentList = Array.isArray(rawRecent) ? rawRecent : [rawRecent];
+    const recentArtistSet = new Set(recentList.map((a) => a.name.toLowerCase().trim()));
+    const forgotten = [];
+    histList.forEach((a, idx) => {
+        const name = a.name;
+        if (!name)
+            return;
+        if (!recentArtistSet.has(name.toLowerCase().trim())) {
+            forgotten.push({
+                name,
+                historicPlaycount: Number.parseInt(a.playcount ?? '0', 10) || 0,
+                historicRank: idx + 1,
+                url: a.url,
+            });
+        }
+    });
+    // Sort by historic prominence (highest playcount / best rank first)
+    forgotten.sort((a, b) => b.historicPlaycount - a.historicPlaycount);
+    return {
+        user: params.user,
+        historicPeriod,
+        recentPeriod,
+        totalForgotten: forgotten.length,
+        forgottenArtists: forgotten.slice(0, limit),
+    };
+}
+/**
+ * Detects intense listening obsessions (sliding windows where a single artist heavily dominates).
+ */
+export async function getObsessions(config, params, init) {
+    const limit = Math.min(1000, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 200));
+    const thresholdRatio = params.thresholdRatio ?? 0.35;
+    const windowSize = Math.max(5, Math.min(100, params.windowSize ?? 20));
+    const userService = createUserService(config);
+    const recentRes = await userService.getRecentTracks({ user: params.user, limit }, init);
+    const rawTracks = recentRes.recenttracks?.track ?? [];
+    const trackList = (Array.isArray(rawTracks) ? rawTracks : [rawTracks]).filter((t) => !t['@attr']?.nowplaying);
+    // Sort chronologically ascending by timestamp
+    const sorted = [...trackList].sort((a, b) => {
+        const utsa = Number.parseInt(a.date?.uts ?? '0', 10);
+        const utsb = Number.parseInt(b.date?.uts ?? '0', 10);
+        return utsa - utsb;
+    });
+    if (sorted.length < windowSize) {
+        return {
+            user: params.user,
+            totalScrobblesInspected: sorted.length,
+            obsessions: [],
+            mostObsessiveArtist: null,
+        };
+    }
+    const rawEpisodes = [];
+    // Sliding window scan
+    for (let i = 0; i <= sorted.length - windowSize; i++) {
+        const slice = sorted.slice(i, i + windowSize);
+        const counts = {};
+        for (const t of slice) {
+            const artistName = typeof t.artist === 'object' && t.artist !== null
+                ? (t.artist['#text'] ?? t.artist.name ?? '')
+                : String(t.artist ?? '');
+            if (!artistName)
+                continue;
+            if (!counts[artistName]) {
+                counts[artistName] = { count: 0, trackCounts: {} };
+            }
+            counts[artistName].count += 1;
+            const trk = t.name;
+            if (trk) {
+                counts[artistName].trackCounts[trk] = (counts[artistName].trackCounts[trk] ?? 0) + 1;
+            }
+        }
+        for (const [art, data] of Object.entries(counts)) {
+            const ratio = data.count / windowSize;
+            if (ratio >= thresholdRatio) {
+                const startUts = Number.parseInt(slice[0].date?.uts ?? '0', 10) || 0;
+                const endUts = Number.parseInt(slice[slice.length - 1].date?.uts ?? '0', 10) || 0;
+                const durationHours = Math.round(((endUts - startUts) / 3600) * 100) / 100;
+                let topTrack;
+                let maxTrackPlays = 0;
+                for (const [trk, tCount] of Object.entries(data.trackCounts)) {
+                    if (tCount > maxTrackPlays) {
+                        maxTrackPlays = tCount;
+                        topTrack = trk;
+                    }
+                }
+                rawEpisodes.push({
+                    artist: art,
+                    track: maxTrackPlays >= 3 ? topTrack : undefined,
+                    scrobbles: data.count,
+                    totalInWindow: windowSize,
+                    density: Math.round(ratio * 100) / 100,
+                    startTime: startUts,
+                    endTime: endUts,
+                    durationHours: Math.max(0.1, durationHours),
+                });
+            }
+        }
+    }
+    // Merge contiguous/overlapping episodes for the same artist
+    const merged = [];
+    for (const ep of rawEpisodes) {
+        const last = merged[merged.length - 1];
+        if (last && last.artist.toLowerCase() === ep.artist.toLowerCase() && ep.startTime <= last.endTime + 7200) {
+            last.endTime = Math.max(last.endTime, ep.endTime);
+            last.scrobbles = Math.max(last.scrobbles, ep.scrobbles);
+            last.density = Math.max(last.density, ep.density);
+            last.durationHours = Math.round(((last.endTime - last.startTime) / 3600) * 100) / 100;
+        }
+        else {
+            merged.push({ ...ep });
+        }
+    }
+    // Rank episodes by highest density and scrobbles
+    merged.sort((a, b) => b.density - a.density || b.scrobbles - a.scrobbles);
+    // Find most obsessive artist
+    const artistObsessionCount = {};
+    for (const ep of merged) {
+        artistObsessionCount[ep.artist] = (artistObsessionCount[ep.artist] ?? 0) + ep.scrobbles;
+    }
+    let mostObsessiveArtist = null;
+    let maxObsession = 0;
+    for (const [art, count] of Object.entries(artistObsessionCount)) {
+        if (count > maxObsession) {
+            maxObsession = count;
+            mostObsessiveArtist = art;
+        }
+    }
+    return {
+        user: params.user,
+        totalScrobblesInspected: sorted.length,
+        obsessions: merged,
+        mostObsessiveArtist,
+    };
+}
+//# sourceMappingURL=decay.js.map

package/dist/insights/algorithms/decay.js.map

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

package/dist/{services/insights → insights/algorithms}/discoveries.d.ts

@@ -1,5 +1,5 @@
 import type { LastFmConfig } from '../../config.js';
-import type { InsightsDiscoveriesRequest, InsightsDiscoveriesResponse } from '../insights.schemas.js';
+import type { InsightsDiscoveriesRequest, InsightsDiscoveriesResponse } from '../schemas.js';
 /**
  * Detects newly discovered artists in a recent time window by comparing
  * against the user's historical baseline roster.

package/dist/insights/algorithms/discoveries.d.ts.map

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

package/dist/{services/insights → insights/algorithms}/discoveries.js

@@ -1,5 +1,5 @@
-import { createUserService } from '../user.js';
-import { findNewArtists } from './lib/discoveries.js';
+import { createUserService } from '../../core/services/user.js';
+import { findNewArtists } from '../lib/discoveries.js';
 /**
  * Detects newly discovered artists in a recent time window by comparing
  * against the user's historical baseline roster.

package/dist/insights/algorithms/discoveries.js.map

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

package/dist/insights/algorithms/genres.d.ts

@@ -0,0 +1,11 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsGenreBreakdownRequest, InsightsGenreBreakdownResponse, InsightsGenreEvolutionRequest, InsightsGenreEvolutionResponse } from '../schemas.js';
+/**
+ * Computes normalized genre breakdown, noise-filtering meta tags and calculating HHI concentration.
+ */
+export declare function getGenreBreakdown(config: LastFmConfig, params: InsightsGenreBreakdownRequest, init?: RequestInit): Promise<InsightsGenreBreakdownResponse>;
+/**
+ * Tracks shifts in genre percentage shares between two periods.
+ */
+export declare function getGenreEvolution(config: LastFmConfig, params: InsightsGenreEvolutionRequest, init?: RequestInit): Promise<InsightsGenreEvolutionResponse>;
+//# sourceMappingURL=genres.d.ts.map

package/dist/insights/algorithms/genres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genres.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/genres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,OAAO,KAAK,EAGX,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,MAAM,eAAe,CAAA;AA0HtB;;GAEG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,6BAA6B,EACrC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,8BAA8B,CAAC,CAoDzC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,6BAA6B,EACrC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,8BAA8B,CAAC,CAwDzC"}